在第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类再修改一下。
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类传递的。
所以说,数据协定也有隐藏真实身份的作用。