前言
我和用户有个约定,这个契约上篇已经说过了,分为服务契约、操作契约、消息契约、数据契约等,说白了,你到底让我看到什么,你告诉我,或者说,我可以让你看到什么,你敢用吗?下面就说一些基础的,关于这个些契约的分别定义,已经有什么其他的独特的之处。
内容
需要引用的命名空间
using System.ServiceModel;
[ServiceContract]和[OperationContract]
指示接口或类在 Windows CommunicationFoundation (WCF) 应用程序中定义服务协定。
就是约束对外提供的服务功能。它经常和操作契约(指示方法定义一个操作,该操作是 Windows Communication Foundation (WCF)应用程序中服务协定的一部分。)一起使用。
Demo
[ServiceContract]
public interface IService
{
[OperationContract]
Student GetStudentInfo();
}
效果
上面的代码只是单方面强调了,对外提供的服务功能。具体的方法实现要在具体的类中说明。这时候问题来了,我怎么知道你调用了我的服务,我又怎么知道,我的这些效果实现是调用了你的服务,这个时候,就需要对这个操作契约设置通讯方式,这里分为单向和双向。采用IsOneWay属性来标识(如果还属性值为true,表明该操作是单向的,属性值为false,表明该操作是双向的)。
单向Demo
[ServiceContract(Namespace="WServer")]
public interface IService
{
//isOneWay设置为true,表明该操作为单向的
//设置为false,表明该操作作是双向的
[OperationContract(IsOneWay=true)]
/*
* 启用单向通讯的方法,不能有返回值(void可以),不能有out参数,只允许传入参数
*/
void AddInt(string message);
}
注意:约束的方法不能有返回值(void就可以),可以带有参数
效果
双向Demo
//isOneWay设置为true,表明该操作为单向的
//设置为false,表明该操作作是双向的
[OperationContract(IsOneWay=false)]
DateTime AddInt(string message);
效果
数据契约
指定该类型要定义或实现一个数据协定,并可由序列化程序(如 System.Runtime.Serialization.DataContractSerializer)进行序列化。若要使其类型可序列化,类型作者必须为其类型定义数据协定。主要修饰属性和字段;带有该修饰,服务对外提供相应的属性和字段。
普通Demo
[DataContract]
public class Employee
{
[DataMember]
public string Name { get; set; }
[DataMember]
public int Age { get; set; }
public string City { get; set; }
}
效果
如果为了隐藏数据本身的身份,需要给身份起假名字对外提供。
Demo
[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; }
}
效果
上面的修饰的数据类型都是一些普通的一些类型int、string等,在序列化和反序列化的时候,可以很容易的被识别进行操作,那么如果我想传递一个object类型的对象呢?反序列话需要怎么做才能让程序识别该类型并且完成反序列化。
Demo
[DataContract]
//[KnownType(typeof(Dictionary<string,float>))]//为了解决object类型的反序列化--------没有解决
[KnownType("GetKnowTypes")]//这个解决了object类型反序列化问题
public class Student
{
[DataMember]
public string Name;
[DataMember]
public string Phone;
[DataMember]
public AddrInfo Address;
[DataMember]
public object Scores;
/*
* 在一些比较复杂的类型的无法反序列化(不能识别类型)的时候,就得考虑使用knownTypeAttribute来标注可能涉及到的外部类型,但是如果遇到像泛型这些较为复杂的类型,就要考虑在带数据协定的类中添加一个静态方法,该方法返回Type的IEnumerable,一般是Type[]就可以了,而在KnownTypeAttribute的构造函数中使用这个方法的名字。
*/
static Type[] GetKnowTypes()
{
return new Type[] { typeof(Dictionary<string, float>) };
}
}
[DataContract]
public class AddrInfo
{
[DataMember]
public string Province;
[DataMember]
public string City;
[DataMember]
public string DetailAddr;
}
效果
小结
关于消息契约和这个用法差不多,只不过,消息契约属性有头消息和正文消息修饰。
感谢您的宝贵时间···