[转] 传说中的WCF(2):服务协定的那些事儿

上一篇文章中,我们抛出了N个问题:WCF到底难不难学?复杂吗?如果复杂,可以化繁为简吗?

其实,这些问题的答案全取决于你的心态,都说“态度决定一切”,这句话,不知道各位信不信,反正我是信了。首先,敢于挑战自我,乐于接受新事物的人,就不会觉得有啥难学的,“世上有难事,只怕有心人”;再者,WCF当然复杂了,整个.NET框架都复杂,但不难学,因为.NET有一个先天性优点——集成性和统一性严重地好,这也是我乐于研究.NET的主要原因之一,复杂但不混乱。一个统一的国家总比一个四分五裂的国家要强大;第三,任何东西都可以化繁为简,关键是你持什么样的心态。编程最高境界就是将程序和自然哲学等多种学术融为一体。

今天聊聊服务协定,这个概念,如果你只停留在字面上去理解,你会发现灰常抽象。有两家公司经过七天七夜的谈判,终于达成基本一致的意见,于是,就签下了合作协议。根据合作协议要求,两家公司在ABCD项目上互相公开一定程度的资料,以便更好地合作。各位想一想,这个合作协议,像不像我们这里说的服务协定?是啊,服务协定其实没啥了不起的,刚才签下合作协议的两家公司分别叫“服务器端”和“客户端”。

服务协定告诉客户端,哪些方法你可以调用,哪些数据类型你可使用,至于公不公开接口让你调用,就完全取决于服务器端如何定义服务协定了。

比如下面这个协定:

[csharp] view plaincopyprint?

  1. [ServiceContract]

  2. public interface IServiceA

  3. {

  4. [OperationContract]

  5. int AddInt(int a, int b);
  6. [OperationContract]

  7. double AddDouble(double a, double b);
  8. float AddFloat(float a, float b);

  9. }

实现该协定:

[csharp] view plaincopyprint?

  1. public class MyService : IServiceA

  2. {

  3. public int AddInt(int a, int b)

  4. {

  5. return a + b;

  6. }
  7. public double AddDouble(double a, double b)

  8. {

  9. return a + b;

  10. }
  11. public float AddFloat(float a, float b)

  12. {

  13. return a + b;

  14. }

  15. }

大家可以猜一下,在客户端中生成的代码中,哪你能看到哪些方法,哪些方法将看不到?上面的服务协定中,我们定义了三个方法,其中前两个是带了操作协定OperationContractAttribute的,而AddFloat方法是没有用标注为协定的。那么,生成的客户端代码会如何呢?

是不是少了一个方法呢?对啊,就是少了AddFloat,还记得吗?我们上面的代码中,AddFloat方法是没有标注为操作协定的。

好的,现在我们为AddFloat加上操作协定,如下所示。

[csharp] view plaincopyprint?

  1. [ServiceContract]

  2. public interface IServiceA

  3. {

  4. [OperationContract]

  5. int AddInt(int a, int b);
  6. [OperationContract]

  7. double AddDouble(double a, double b);
  8. [OperationContract]

  9. float AddFloat(float a, float b);

  10. }

这时候,看看在客户端能看到多少个方法。

这回全到齐了,对吧。

下面来看看服务的命名空间。

ServiceContractAttribute有个属性Namespace,用于设置服务的命名空间,由于避免放到互联网中与其它服务冲突,命名空间必须是唯一的(其实就是XML命名空间),多数情况下,我们会使用公司主页的地址或个人网站地址,因为这些地址是唯一的。

在不设置命名空间的时候,我们看看客户端代码默认生成的命名空间是什么。

在“解决方案资源管理器”窗口上,点击“显示所有文件”,如下图所示。

打开.wsdl文件。

[html] view plaincopyprint?

  1. <wsdl:types>

  2. <xsd:schema targetNamespace="http://tempuri.org/Imports">

  3. <xsd:import schemaLocation="http://localhost:9000/service?xsd=xsd0" namespace="http://tempuri.org/" />

  4. <xsd:import schemaLocation="http://localhost:9000/service?xsd=xsd1" namespace="http://schemas.microsoft.com/2003/10/Serialization/" />

  5. </xsd:schema>

  6. </wsdl:types>

我们看到,默认的命名空间是http://tempuri.org/,然后,回到服务器端的代码,我们显式设置一个命名空间,看看生成的客户端代码又将如何。

[csharp] view plaincopyprint?

  1. [ServiceContract(Namespace = "http://MyApp.net")]

  2. public interface IServiceA

  3. {

  4. [OperationContract]

  5. int AddInt(int a, int b);
  6. [OperationContract]

  7. double AddDouble(double a, double b);
  8. [OperationContract]

  9. float AddFloat(float a, float b);

  10. }

好了,现在再看看WSDL文件会变成啥样。

我们发现,现在的WSDL文件和刚才不一样了,上面出现了我们自定义的命名空间。

我们也许还会问,命名空间一定要用http://的方式吗?我用其它字符串行吗?不必问,试一下就知道了。

[csharp] view plaincopyprint?

  1. [ServiceContract(Namespace = "FuckingDog")]

  2. public interface IServiceA

  3. {

  4. .............

再看看这次生成的客户端代码中,WSDL中是如何描述。

好了,结论出来了。

ServiceContractAttribute类还有一个属性Name,那么设置了该属性会发生什么?不急,我们先来看看不设置Name的情况下是如何。

我们看到,默认情况下,生成的WSDL直接使用服务协定的名字,即IServiceA。那么,如果我们在定义服务协定时修改了Name属性,那会如何?

[csharp] view plaincopyprint?

  1. [ServiceContract(Namespace = "FuckingDog", Name = "HaHaHa")]

  2. public interface IServiceA

  3. {

  4. .......

看对比一下生成的WSDL文件。

现在,就变成“HaHaHa”了,呵呵,这有啥用呢?哈,问你一句,如果你上网聊天的时候,不希望对方知道你的真实姓名时,你会咋办?嘿,弄个网名呗,就是了,为服务协定弄一下Name属性,就相当于为它取一个网名呗。

还有哦,这个网名不仅仅服务协定可以取,操作协定也可以,来,看看。

[csharp] view plaincopyprint?

  1. [ServiceContract(Namespace = "FuckingDog", Name = "HaHaHa")]

  2. public interface IServiceA

  3. {

  4. [OperationContract(Name = "OperatFirst")]

  5. int AddInt(int a, int b);
  6. [OperationContract(Name = "OperatSecond")]

  7. double AddDouble(double a, double b);
  8. [OperationContract(Name = "OperatThird")]

  9. float AddFloat(float a, float b);

  10. }

你猜猜,这样改了以后,生成的客户端代码会啥样子?

猜对了吗?这样一来啊,调用服务的人就不知道你姓甚名谁了。

怎么样?WCF有趣不?本文的服务器端示例完整代码清单如下。

[csharp] view plaincopyprint?

  1. using System;

  2. using System.Collections.Generic;

  3. using System.Linq;

  4. using System.Text;

  5. using System.ServiceModel;

  6. using System.ServiceModel.Description;
  7. namespace Server

  8. {

  9. [ServiceContract(Namespace = "FuckingDog", Name = "HaHaHa")]

  10. public interface IServiceA

  11. {

  12. [OperationContract(Name = "OperatFirst")]

  13. int AddInt(int a, int b);
  14. [OperationContract(Name = "OperatSecond")]

  15. double AddDouble(double a, double b);
  16. [OperationContract(Name = "OperatThird")]

  17. float AddFloat(float a, float b);

  18. }
  19. public class MyService : IServiceA

  20. {

  21. public int AddInt(int a, int b)

  22. {

  23. return a + b;

  24. }
  25. public double AddDouble(double a, double b)

  26. {

  27. return a + b;

  28. }
  29. public float AddFloat(float a, float b)

  30. {

  31. return a + b;

  32. }

  33. }
  34. class Program

  35. {

  36. static void Main(string[] args)

  37. {

  38. using (ServiceHost host = new ServiceHost(typeof(MyService),new Uri("http://localhost:9000/service")))

  39. {

  40. WSHttpBinding binding = new WSHttpBinding();

  41. binding.Security.Mode = SecurityMode.None;

  42. host.AddServiceEndpoint(typeof(IServiceA), binding, "contract1");

  43. host.Description.Behaviors.Add(new ServiceMetadataBehavior() { HttpGetEnabled = true });

  44. host.Opened += (sd, arg) => Console.WriteLine("服务已启动。");

  45. try

  46. {

  47. host.Open();

  48. }

  49. catch (Exception ex)

  50. {

  51. Console.WriteLine(ex.Message);

  52. }

  53. Console.ReadKey();

  54. host.Close();

  55. }

  56. }

  57. }

  58. }

最后,说说WSDL的事儿,这个家伙我们了解一下就够了,为啥,我们不必自己动手写WSDL文档,甚至说,你看不懂也不影响编程,因为强大的Visual
Studio在我们引用服务时,会为我们生成所需的代码,我们就像使用一般类一个使用就可以了。

若想了解WSDL,看看这个,不错,挺简洁明了的。http://www.w3school.com.cn/wsdl/index.asp

时间: 2024-10-05 08:01:21

[转] 传说中的WCF(2):服务协定的那些事儿的相关文章

【WCF全析(一)】--服务协定及消息模式

上周微软开发布会说.NET支持完全跨平台和并开放Core源码的新闻,让我们顿时感到.NET要迎来它的春天.虽然早在几年前.NET就能开发Android和IOS,但是这次的跨平台把Linux都放到了微软战略之中,以后的.NET Developer就可以使用Vs开发Linux应用了,Developer又有了新的选择,从微软的战略转型也可以看出互联网已经步入到了新的模式,以后不再是PC的时代,移动互联和云时代已经到来. 最近做项目时使用到了WCF,项目把数据层和程序层进行了分割,相互之间的数据传输使用

从零开始学WCF(2):设计和实现服务协定

消息 消息是一个独立的数据单元,它可能由几个部分组成,包括消息正文和消息头 服务 服务是一个构造,它公开一个或多个终结点,其中每个终结点都公开一个或多个服务操作 终结点 终结点是用来发送或接受消息(或执行这两种操作)的构造. 终结点包括: 一个定义消息可以发送到的目的地的位置(地址 Address) 一个描述消息应如何发送的通信机制的规范(绑定 Binding) 对于可以在该位置发送或接受(或两者皆可)的一组消息的定义(服务协定)该定义还描述了可以发送何种消息. WCF服务作为一个终结点集合向外

WCF基础之设计和实现服务协定

本来前面还有一个章节“WCF概述”,这章都是些文字概述,就不“复制”了,直接从第二章开始. 当然学习WCF还是要些基础的.https://msdn.microsoft.com/zh-cn/hh148206这个就是“原文”了,喜欢WCF的可以自己去下载. WCF简单术语: 消息:消息是一个独立的数据单元,主要由消息头和消息正文组成,入门的时候我对它的理解简单说:发送一个消息,就是调用了一个方法,具体的以后再说. 服务:服务说简单点就是终结点的集合. 终节点:即包含我们所谓的WCF的ABC三要素的接

WCF 设计和实现服务协定

WCF 术语:? 消息 – 消息是一个独立的数据单元,它可能由几个部分组成,包括消息正文和消息头.? 服务 – 服务是一个构造,它公开一个或多个终结点,其中每个终结点都公开一个或多个服务操作.? 终结点 – 终结点是用来发送或接收消息(或执行这两种操作)的构造. 终结点包括一个定义消息可以发送到的目的地的位置(地址).一个描述消息应如何发送的通信机制规范(绑定)以及对于可以在该位置发送或接收(或两者皆可)的一组消息的定义(服务协定)- 该定义还描述了可以发送何种消息. – WCF 服务作为一个终

【架构之路之WCF全析(一)】--服务协定及消息模式

上周微软开发布会说.NET支持完全跨平台和并开放Core源码的新闻,让我们顿时感到.NET要迎来它的春天.虽然早在几年前.NET就能开发Android和IOS,但是这次的跨平台把Linux都放到了微软战略之中,以后的.NET Developer就可以使用Vs开发Linux应用了,Developer又有了新的选择,从微软的战略转型也可以看出互联网已经步入到了新的模式,以后不再是PC的时代,移动互联和云时代已经到来. 最近做项目时使用到了WCF,项目把数据层和程序层进行了分割,相互之间的数据传输使用

WCF初探-14:WCF服务协定

前言: 在前面的文章中,我们定义的服务协定上都会有一个ServiceContract的特性来修饰,这是因为服务契约的实现要靠ServiceContractAttribute 属性定义,然后使用一个或多个类(或接口)方法中的 OperationContractAttribute 属性定义协定的服务操作. 实现服务协定后并将其与WCF 绑定和 EndpointAddress 对象一起使用时,此服务协定将公开以供客户端使用. 公开的信息由 ServiceContractAttribute 表示,其接口

菜鸟眼中的WCF(2)—服务协定

在上一篇文章中简单的对WCF进行了讲解并做了一个简单的实例,那么今天就继续对它进行解析--服务协定的初探. 说到协定大家肯定不陌生,只要参加了工作就一定会签订各种协定,比如合同的签订,我们就是其中的一方,按着这个双方签订的合同来工作,它授予你什么权限,你就有什么权限,不能做本职外的工作.各位想一想这个合同的协议,像不像我们这里说的服务协定?是啊,服务协定其实没啥了不起的,刚才签下合作协议的个人和公司分别叫做"客户端"和"服务器". 服务协定告诉客户端,哪些方法你可以

WCF系列教程之WCF服务协定

本文参考自:http://www.cnblogs.com/wangweimutou/p/4422883.html,纯属读书笔记,加深记忆 一.服务协定简介: 1.WCF所有的服务协定层里面的服务接口,都有一个ServiceContract的特性修饰,服务接口里面的操作方法都有OperationContract特性修饰,why? (1).服务契约的实现要靠ServiceContractAttribute 属性定义 (2).服务契约方法的实现要靠 OperationContractAttribute

WCF 设计和实现服务协定(01)

作者:jiankunking 出处:http://blog.csdn.net/jiankunking WCF 术语: ? 消息 – 消息是一个独立的数据单元,它可能由几个部分组成,包含消息正文和消息头.? 服务 – 服务是一个构造.它公开一个或多个终结点.当中每一个终结点都公开一个或多个服务操作.? 终结点 – 终结点是用来发送或接收消息(或执行这两种操作)的构造. 终结点包含一个定义消息能够发送到的目的地的位置(地址).一个描写叙述消息应怎样发送的通信机制规范(绑定)以及对于能够在该位置发送或