传说中的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,往客户端项目添加服务器端引用。
添加成功后,编写客户端实现代码:
{
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类,这回我们使用数据协定来标注。
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属性了。所以,我们现在明白了一件事,使用数据协定可以灵活控制哪些成员应该被客户端识别。
其实,数据成员也可以用于字段,哪怕是私有字段,看看下面的修改。
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类再次进行修改,把所有的成员都改为私有字段。
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 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类传递的。
所以说,数据协定也有隐藏真实身份的作用。
转IT黄老邪