传说中的WCF（5）：数据协定（a）

在第4篇中，咱们了解了发送/接收SOAP头，从本篇开头，我们不妨更深入地去探求一下有关WCF中的消息到底是啥玩意儿。WCF庞大而复杂，而从 MSDN文档中，你会看到许多很专业很抽象的东西，你不禁会问，文档中所说的，是不是都有用的呢？实用的理论还是有的，不过有些要点确实太抽象了，抽象到 有时候我也不知道用来干吗？

不过，数据协定应该算比较有用的东西，至少在你写WCF服务时还是会经常用到。

 

我们先不管数据协定是什么，就从一个例子入手吧。

1、以管理员身份运行VS，注意，要以管理员身份运行，不然等会儿可能启动不了服务器端。

2、我们这个例子（解决方案）包含两个项目——服务器端和客户端。

3、为了简单起键，我都使用控制台应用程序。

服务器端的实现：

首先定义一个简单的类Employee，现在我们只用普通方式来定义该类，也不添加数据协定特性，在服务器方法协定中把一个Employee实例返回到客户端。我们测一测在不声明数据协定的情况下能不能成功调用。

    public class Employee
    {
        public string Name { get; set; }
        public int Age { get; set; }
    }

以下是服务协定的实现：

    [ServiceContract]
    public interface IService
    {
        [OperationContract]
        Employee GetAEmployee();
    }

    public class MyService : IService
    {
        public Employee GetAEmployee()
        {
            return new Employee { Name = "小朋友", Age = 32 };
        }
    }

      class Program
    {
        static void Main(string[] args)
        {
            Uri url = new Uri("http://localhost:1233/services");
            using (ServiceHost host = new ServiceHost(typeof(MyService), url))
            {
                // 绑定的Bindong
                NetHttpBinding binding = new NetHttpBinding();
                var ep = host.AddDefaultEndpoints();
                ServiceMetadataBehavior mb = new ServiceMetadataBehavior();
                mb.HttpGetEnabled = true;
                mb.HttpGetBinding = binding;
                host.Description.Behaviors.Add(mb);
                try
                {
                    host.Open();//打开服务
                    Console.WriteLine("服务已启动。");
                }
                catch (Exception ex)
                {
                    Console.WriteLine(ex.Message);
                }
                Console.ReadKey();
            }
        }
    }

现在先运行一下，确定服务器可以正常启动即可。

 

接下来看看客户端，为了添加服务引用，请到服务器端调试目录（bin\debug）下，以管理身份动行服务器端，然后回到VS，往客户端项目添加服务器端引用。

添加成功后，编写客户端实现代码：

        static void Main(string[] args)
        {
            ws.ServiceClient cl = new ws.ServiceClient();
            Console.WriteLine("正在调用服务方法……");
            var em = cl.GetAEmployee();
            Console.WriteLine("员工信息\n姓名：{0}\n年龄：{1}", em.Name, em.Age);

            Console.ReadKey();
        }

确保服务器端还在运行，然后调试运行客户端，如果通信成功，你会看到以下结果。

这个例子只是说明了，如果在协定方法上出现非基元类型，在客户端引用时，可以生成对应类，至少表明，可被序列化的类型是没有问题的。非基元类型是啥，就是CLR的最简单的类型，如int, bool, float, long..................据说DateTime也是。

我们看看客户端生成的类是啥样的。

与服务器端不同，类实现了两个接口：IExtensibleDataObject, INotifyPropertyChanged。如果你觉得不好理解，那可以不管它，因为这不影响我们的实际应用。

 

下面我们再把刚才的代码修改一下，在服务器端，我们重新定义一下Employee类，这回我们使用数据协定来标注。

    [DataContract]
    public class Employee
    {
        [DataMember]
        public string Name { get; set; }
        [DataMember]
        public int Age { get; set; }
        public string City { get; set; }
    }

接着重新运行一下，注意，客户端的服务引用也要更新。接着再运行一下客户端，从表面上看，似乎和前面没有使用数据协定时没有区别。不过，你还是仔细看看 Employee的定义，发现了没有？在Employee类的定义中有一个City属性，但是，在客户端更新服务后，在客户生成的代码中还是没有City 属性，换句话说，只是应用了DataMember特性的成员才算是数据成员。

现在，我们再把Employee类修改一下，为City属性也加上DataMember特性。

    [DataContract]
    public class Employee
    {
        [DataMember]
        public string Name { get; set; }
        [DataMember]
        public int Age { get; set; }
        [DataMember]
        public string City { get; set; }
    }

然后更新一下客户端的服务引用，看看这回生成的代理代码中还有没有City属性？

这回在客户端生成的代码中，就见到了City属性了。所以，我们现在明白了一件事，使用数据协定可以灵活控制哪些成员应该被客户端识别。

其实，数据成员也可以用于字段，哪怕是私有字段，看看下面的修改。

    [DataContract]
    public class Employee
    {
        [DataMember]
        public string Name { get; set; }
        [DataMember]
        public int Age { get; set; }
        [DataMember]
        public string City { get; set; }

        [DataMember]
        private string _address;
    }

现在Employee类多了一个私有字段作为数据成员，看看客户端生成的代码有何变化。

我们也看到了这个私有字段，不过，就是因为它是私人财产，你无法直接拿来用。好，现在我们把Employee类再修改一下。

    [DataContract]
    public class Employee
    {
        [DataMember]
        public string Name
        {
            get { return this._name; }
            set { this._name = value; }
        }
        [DataMember]
        public int Age
        {
            get { return this._age; }
            set { this._age = value; }
        }
        [DataMember]
        public string City
        {
            get { return this._city; }
            set { this._city = value; }
        }
        // 字段列表
        [DataMember]
        private string _name;
        [DataMember]
        private int _age;
        [DataMember]
        private string _city;
    }

这一次，客户端又会生成什么代码呢？

我们发现，不管在服务器端我们把数据成员定义为公共属性还是私有字段，到了客户端都全变成公共属性了。为了验证这一点，我们把Employee类再次进行修改，把所有的成员都改为私有字段。

    [DataContract]
    public class Employee
    {
        [DataMember]
        private string Name;

        [DataMember]
        private int Age;

        [DataMember]
        private string City;
    }

由于私有字段不能被外部访问，因此，服务代码也要修改。

    public class MyService : IService
    {
        public Employee GetAEmployee()
        {
            return new Employee();
        }
    }

 

 

这样一来，我们看看客户端又会生成啥样子的代码。

很显然，到客户端，所有数据成员都成了公共属性了。这什么会这样呢？其实数据协定是通过XML来传输的，你想一想XML序列化的特点就找到些启发了，XML序列化和反序列化只针对公共成员，所以，如果希望让私有的数据成员也能进行序列化，能做的事情就是把数据成员都变成公共成员。这一点MSDN上也有相关说明。

 

数据协定还有一个很好的用处，那就是隐藏身份，比如我们把Employee作以下修改：

    public class MyService : IService
    {
        public Employee GetAEmployee()
        {
            return new Employee() { Name = "小胡", Age = 32, City = "南京" };
        }
    }

    [DataContract(Name = "Worker")]
    public class Employee
    {
        [DataMember(Name = "Worker_Name")]
        public string Name { get; set; }

        [DataMember(Name = "Worker_Age")]
        public int Age { get; set; }

        [DataMember(Name = "Worker_City")]
        public string City { get; set; }
    }

这一次，客户端生成的类，类名、属性名全变了，虽然变成了另一个类，但里面的数据还是从服务器端的Employee类传递的。

所以说，数据协定也有隐藏真实身份的作用。

 

2014-01-19