WCF入门（12）

前言

　　上次写是小半年前的事情了，还在原来的公司，还在原来的项目，同时认识了不少人。外包公司总是有些不适应的地方，总在很闲和很忙之间徘徊。凌晨2点被客户电话叫醒，只为copy一个文件从一台服务器到另一台服务器，虽然那时候我才刚睡下。似乎好想吐槽……罢了。

　　项目中有个http转https的需求还是印象深刻的。首先是证书的问题，通过看作者的asp.net的视频了解到IIS有Self-Signed Certificate 的东西可以用来方便的在IIS上部署需要https访问的站点而不需要去其他地方申请。然后是如何对WCF进行https配置。这一　点在视频第52集有讲到。

言归正传。

第12集 Backward compatible WCF contract changes WCF合约改变后的向后兼容性

　　这一集主要内容来自https://msdn.microsoft.com/en-us/library/ff384251.aspx ，所以可以直接看上面的链接。

　　一般来说WCF服务部署到生产环境后，因为客户端的代理类已经生成，所以，服务端不建议再做更改。但总会有避免不了要更改的情况。下面就通过2个表格来对典型的情况做一些说明。简单来说，DataContractSerializer 允许一下情况

① 缺失非必须参数，

② 忽视多余的参数。

③ Only the removal of operations or the addition or removal of required data causes problems with existing clients. （没看懂。。。）

表1： Service Contract的向后兼容性

表2：Data Contract的向后兼容性

下面对表2中的第2项做个test， 权当练练手。。

1. 首先给IEmployeeService 加个GetEmployeeInfo的OperationContract，然后在EmployeeService里面实现。

        public string GetEmployeeInfo(Employee emp)
        {
            return String.Format("name= {0}, id= {1}", emp.Name, emp.Id);
        }

因为要试验当一个DataContract 在Client不知情的情况下添加一个IsRequired的DataMember之后对Client的影响，所以，简单起见，就直接接收一个Employee的参数。

2. 下面是Employee的定义：

    [DataContract]
    public class Employee
    {
        [DataMember(IsRequired = true)]
        public int Id { get; set; }
        [DataMember(IsRequired = false)]
        public String Name { get; set; }
        [DataMember]
        public Boolean Gender { get; set; }
        [DataMember]
        public DateTime DateOfBirth { get; set; }
        [DataMember]
        public short EmployeeType { get; set; }
        //[DataMember(IsRequired = true)]
        //public string City { get; set; }
    }

注意， Emploee类要用DataContract特性修饰。 原先是不带City属性，下面给他添加IsRequired的属性。

    [DataContract]
    public class Employee
    {
        [DataMember(IsRequired = true)]
        public int Id { get; set; }
        [DataMember(IsRequired = false)]
        public String Name { get; set; }
        [DataMember]
        public Boolean Gender { get; set; }
        [DataMember]
        public DateTime DateOfBirth { get; set; }
        [DataMember]
        public short EmployeeType { get; set; }
        [DataMember(IsRequired = true)]
        public string City { get; set; }
    }

3. 启动Service

4. 打开EmployeeServiceClient项目，查看里面的Employee定义，因为City属性是后来加的，所以代理类里面不带City属性。

    [Serializable]
    [DataContract(Name = "Employee", Namespace = "http://schemas.datacontract.org/2004/07/EmployeeService")]
    [DebuggerStepThrough]
    [GeneratedCode("System.Runtime.Serialization", "4.0.0.0")]
    public class Employee : IExtensibleDataObject, INotifyPropertyChanged
    {
        public Employee();

        [DataMember]
        public DateTime DateOfBirth { get; set; }
        [DataMember]
        public short EmployeeType { get; set; }
        public ExtensionDataObject ExtensionData { get; set; }
        [DataMember]
        public bool Gender { get; set; }
        [DataMember(IsRequired = true)]
        public int Id { get; set; }
        [DataMember]
        public string Name { get; set; }

        public event PropertyChangedEventHandler PropertyChanged;

        protected void RaisePropertyChanged(string propertyName);
    }

5. 编写如下测试代码:

protected void btnTest_Click(object sender, EventArgs e)
    {
        try {
            var client = new EmployeeServiceClient();
            var emp = new Employee() { Name = "Lou" };
            lbRstMsg.Text = client.GetEmployeeInfo(emp);
        } catch(Exception ex) {
            lbRstMsg.Text = ex.Message;
        }
    }

6. 点击测试按钮 得到如下结果：

由ErrorMessage中可知，服务端想得到一个City，但是没有获取到这个参数由于我们的测试代码里面没有也不能提供这个参数。

Thank you。 就这样把。 最后说一句，要视频的进群378190436