WCF(二)---设计服务契约

这篇内容主要讲:什么是服务契约,如何定义,哪些操作接口是可用的,所使用的是什么数据类型,以及其他有关设计操作接口所需要设置的环境。

创建服务契约

服务暴露了一系列的操作。在WCF应用程序中,通过创建方法并且在方法上标记OperationContractAttribute属性来创建服务。然后,想要创建服务契约,需要将那些操作组合起来,将他们定义在一个接口中,并将接口标记上ServiceContractAttribute属性,或者定义在一个类中,标记相同的属性。

没有被OperationContratAttribute属性标记的方法不能够给外界提供WCF服务。
这篇文章描述了创建服务的以下几点:

  • 选择类还是接口
  • 参数和返回值
  • 所能使用的交换信息模式
  • 明确操作的安全要求
  • 操作的输入输出限制

选择类还是接口

类和接口都代表一组功能的组合,因此,无论是类还是接口都可以定义WCF服务合约。然而,推荐使用接口,因为它直接模拟了服务合同。如果没有实现,接口仅仅只是定义了一组方法和签名。实现接口才实现了WCF服务。
使用接口来定义服务的好处:

  • 服务契约可以被其他服务契约所继承
  • 一个类可以实现任意数量的服务契约
  • 在保证契约接口不改变的前提下,可以修改服务契约的实现
  • 可以实现新版本的接口和旧版本的接口,就客户端使用之前的版本,新版本客户端使用新服务接口

注:当继承其他服务契约的时候,不能够重写操作的属性,如 name或者namespace属性。如果需要这么做,就重新创建一个操作。

如,使用接口来定义服务契约,参考:How to: Create a Service with a Contract Interface
然而,也可以使用类定义服务契约并且同时实现操作。用类实现服务的好处就是简单方便。坏处就是不能被其他类所继承,并且只能实现一个服务契约。另外,任何对类或者方法的修改都会影响到服务契约,这有可能会妨碍未修改的客户端进行访问服务。更多内容请参考:Implementing Service Contracts
现在,应该明白使用接口和类定义服务的不同。下一步是确定服务端与客户端交换的数据类型。

参数和返回值

每个操作都有一个返回值和一个参数,即使返回类型为void,然而,不像本地的方法一样,可以传送引用对象,服务契约不能给传递引用对象。而是用值得拷贝来代替传递引用对象的。
这一点很重要,因为每一个参数或返回值必须是可序列化的。这就是说,它必须能够从一个对象转换为一个字节流然后再转换为对象。
.NET框架中的大多类型一样,初始类型默认是可序列化的

注:操作签名中参数的名字是契约中的一部分,是区分大小写的。如果想要在本地使用参数名并且在契约中使用不同的参数名称,请参考:System.ServiceModel.MessageParameterAttribute

数据契约

WCF应用程序一样的面向服务的应用程序,是为了能够被微软和非微软平台的客户端都能够交互。为了使交互更加广泛,建议将数据契约的类型标记为DataContractAttributeDataMemberAttribute属性,这是用来描述数据契约的也是服务契约中的一部分。
数据契约是选择式风格的契约:必须明确契约的属性数据才能够被序列化。数据契约与该成员的访问限制无关:私有数据成员可以被序列化或发送到其他地方也可以公开访问。WCF处理底层的SOAP消息,只要消息是可序列化的,就不需要考虑底层消息是如何传输的。
虽然通常的WCF应用程序使用DataContractAttributeDataMemberAttribute属性来创建数据服务,但是也可以使用其他的可序列化机制。标准的ISerializable,SerializableAttributeIXmlSerializable机制都可以被底层的SOAP消息所序列化处理的。如果数据类型需要的话可以使用更多的可序列化机制。更多有关数据类型可序列化的消息请参考Specifying Data Transfer in Service Contracts

映射参数和返回值到消息交换

服务操作是由一个基本的交换应用程序数据的消息交换来支持的,应用程序所需的数据支持某些标准的安全性、事务和会话相关的功能。因为这种情况下,一个服务操作的签名要求一定的基本消息交换模式(MEP),可以支持数据传输的功能的操作要求。你可以在WCF编程模型指定三种模式:请求/应答,单向,和双工消息模式。

请求/应答

请求/应答模式是指一个请求者(客户端)接受相关请求的应答模式。这是默认的模式,因为它支持多个参数传输到操作并且有一个返回值返回到客户端。如下Csharp应用程序,接受一个字符串参数,返回一个字符串值。

[OperationContractAttribute]
string Hello(string greeting);

这个操作签名决定了底层消息的交换形式。如果不存在相关性,WCF无法确定操作的返回值。

注:即使你设置了不同的底层信息交互模式,服务操作的返回值为void也属于请求/应答模式。除非是客户端异步调用服务,否则客户端就会停止处理消息直到它接受到应答消息,即使消息是空或者其它值。

以下Csharp代码是客户端接受空消息的响应。

[OperationContractAttribute]
void Hello(string greeting);

上面的这个例子,如果操作需要执行耗时操作就会降低客户端的性能和响应能力,但是当返回void时有优势。最显著的就是SOAP错误消息可以再响应消息中返回,SOAP错误消息包含了服务器先关的错误信息。SOAP错误消息包含在服务契约的FaultException<TDetail>对象中发送给客户端,参数类型是指定的服务契约。这样更加方便的通知了客户端服务器的错误信息。更多有关异常,SOAP错误消息,错误处理,参考Specifying and Handling Faults in Contracts and Services ,请求/应答服务和客户端,参考How to: Create a Request-Reply Contract,有关更多请求/应答模式的问题,参考Request-Reply Services

单向

如果WCF服务的客户端不需要等待操作结束并且不需要处理SOAP错误消息,这个操作可以被标记为单向(one-way)消息模式。单向操作模式,是客户端调用操作并且

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,732评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,496评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,264评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,807评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,806评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,675评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,029评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,683评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 41,704评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,666评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,773评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,413评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,016评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,978评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,204评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,083评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,503评论 2 343

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,596评论 18 139
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,577评论 18 399
  • 国家电网公司企业标准(Q/GDW)- 面向对象的用电信息数据交换协议 - 报批稿:20170802 前言: 排版 ...
    庭说阅读 10,864评论 6 13
  • 总是有人问,女生为什么要努力,将来找个有钱的老公不就好了,似乎女生就不应该努力一样。如果有人这么问我,我会告诉...
    大宝的兔子阅读 644评论 0 2
  • 很惊喜的收到二面通知,其实自我感觉除了笔试看了同学两道题目外一面的表现还不错,看来58还是愿意给人犯错的机会的,不...
    白学阅读 891评论 0 1