上一篇文章中,我们抛出了N个问题:WCF到底难不难学?复杂吗?如果复杂,可以化繁为简吗?
其实,这些问题的答案全取决于你的心态,都说“态度决定一切”,这句话,不知道各位信不信,反正我是信了。首先,敢于挑战自我,乐于接受新事物的人,就不会觉得有啥难学的,“世上有难事,只怕有心人”;再者,WCF当然复杂了,整个.NET框架都复杂,但不难学,因为.NET有一个先天性优点——集成性和统一性严重地好,这也是我乐于研究.NET的主要原因之一,复杂但不混乱。一个统一的国家总比一个四分五裂的国家要强大;第三,任何东西都可以化繁为简,关键是你持什么样的心态。编程最高境界就是将程序和自然哲学等多种学术融为一体。
今天聊聊服务协定,这个概念,如果你只停留在字面上去理解,你会发现灰常抽象。有两家公司经过七天七夜的谈判,终于达成基本一致的意见,于是,就签下了合作协议。根据合作协议要求,两家公司在ABCD项目上互相公开一定程度的资料,以便更好地合作。各位想一想,这个合作协议,像不像我们这里说的服务协定?是啊,服务协定其实没啥了不起的,刚才签下合作协议的两家公司分别叫“服务器端”和“客户端”。
服务协定告诉客户端,哪些方法你可以调用,哪些数据类型你可使用,至于公不公开接口让你调用,就完全取决于服务器端如何定义服务协定了。
比如下面这个协定:
[csharp] view plaincopyprint?
- [ServiceContract]
- public interface IServiceA
- {
- [OperationContract]
- int AddInt(int a, int b);
- [OperationContract]
- double AddDouble(double a, double b);
- float AddFloat(float a, float b);
- }
实现该协定:
[csharp] view plaincopyprint?
- public class MyService : IServiceA
- {
- public int AddInt(int a, int b)
- {
- return a + b;
- }
- public double AddDouble(double a, double b)
- {
- return a + b;
- }
- public float AddFloat(float a, float b)
- {
- return a + b;
- }
- }
大家可以猜一下,在客户端中生成的代码中,哪你能看到哪些方法,哪些方法将看不到?上面的服务协定中,我们定义了三个方法,其中前两个是带了操作协定OperationContractAttribute的,而AddFloat方法是没有用标注为协定的。那么,生成的客户端代码会如何呢?
是不是少了一个方法呢?对啊,就是少了AddFloat,还记得吗?我们上面的代码中,AddFloat方法是没有标注为操作协定的。
好的,现在我们为AddFloat加上操作协定,如下所示。
[csharp] view plaincopyprint?
- [ServiceContract]
- public interface IServiceA
- {
- [OperationContract]
- int AddInt(int a, int b);
- [OperationContract]
- double AddDouble(double a, double b);
- [OperationContract]
- float AddFloat(float a, float b);
- }
这时候,看看在客户端能看到多少个方法。
这回全到齐了,对吧。
下面来看看服务的命名空间。
ServiceContractAttribute有个属性Namespace,用于设置服务的命名空间,由于避免放到互联网中与其它服务冲突,命名空间必须是唯一的(其实就是XML命名空间),多数情况下,我们会使用公司主页的地址或个人网站地址,因为这些地址是唯一的。
在不设置命名空间的时候,我们看看客户端代码默认生成的命名空间是什么。
在“解决方案资源管理器”窗口上,点击“显示所有文件”,如下图所示。
打开.wsdl文件。
[html] view plaincopyprint?
- <wsdl:types>
- <xsd:schema targetNamespace="http://tempuri.org/Imports">
- <xsd:import schemaLocation="http://localhost:9000/service?xsd=xsd0" namespace="http://tempuri.org/" />
- <xsd:import schemaLocation="http://localhost:9000/service?xsd=xsd1" namespace="http://schemas.microsoft.com/2003/10/Serialization/" />
- </xsd:schema>
- </wsdl:types>
我们看到,默认的命名空间是http://tempuri.org/,然后,回到服务器端的代码,我们显式设置一个命名空间,看看生成的客户端代码又将如何。
[csharp] view plaincopyprint?
- [ServiceContract(Namespace = "http://MyApp.net")]
- public interface IServiceA
- {
- [OperationContract]
- int AddInt(int a, int b);
- [OperationContract]
- double AddDouble(double a, double b);
- [OperationContract]
- float AddFloat(float a, float b);
- }
好了,现在再看看WSDL文件会变成啥样。
我们发现,现在的WSDL文件和刚才不一样了,上面出现了我们自定义的命名空间。
我们也许还会问,命名空间一定要用http://的方式吗?我用其它字符串行吗?不必问,试一下就知道了。
[csharp] view plaincopyprint?
- [ServiceContract(Namespace = "FuckingDog")]
- public interface IServiceA
- {
- .............
再看看这次生成的客户端代码中,WSDL中是如何描述。
好了,结论出来了。
ServiceContractAttribute类还有一个属性Name,那么设置了该属性会发生什么?不急,我们先来看看不设置Name的情况下是如何。
我们看到,默认情况下,生成的WSDL直接使用服务协定的名字,即IServiceA。那么,如果我们在定义服务协定时修改了Name属性,那会如何?
[csharp] view plaincopyprint?
- [ServiceContract(Namespace = "FuckingDog", Name = "HaHaHa")]
- public interface IServiceA
- {
- .......
看对比一下生成的WSDL文件。
现在,就变成“HaHaHa”了,呵呵,这有啥用呢?哈,问你一句,如果你上网聊天的时候,不希望对方知道你的真实姓名时,你会咋办?嘿,弄个网名呗,就是了,为服务协定弄一下Name属性,就相当于为它取一个网名呗。
还有哦,这个网名不仅仅服务协定可以取,操作协定也可以,来,看看。
[csharp] view plaincopyprint?
- [ServiceContract(Namespace = "FuckingDog", Name = "HaHaHa")]
- public interface IServiceA
- {
- [OperationContract(Name = "OperatFirst")]
- int AddInt(int a, int b);
- [OperationContract(Name = "OperatSecond")]
- double AddDouble(double a, double b);
- [OperationContract(Name = "OperatThird")]
- float AddFloat(float a, float b);
- }
你猜猜,这样改了以后,生成的客户端代码会啥样子?
猜对了吗?这样一来啊,调用服务的人就不知道你姓甚名谁了。
怎么样?WCF有趣不?本文的服务器端示例完整代码清单如下。
[csharp] view plaincopyprint?
- using System;
- using System.Collections.Generic;
- using System.Linq;
- using System.Text;
- using System.ServiceModel;
- using System.ServiceModel.Description;
- namespace Server
- {
- [ServiceContract(Namespace = "FuckingDog", Name = "HaHaHa")]
- public interface IServiceA
- {
- [OperationContract(Name = "OperatFirst")]
- int AddInt(int a, int b);
- [OperationContract(Name = "OperatSecond")]
- double AddDouble(double a, double b);
- [OperationContract(Name = "OperatThird")]
- float AddFloat(float a, float b);
- }
- public class MyService : IServiceA
- {
- public int AddInt(int a, int b)
- {
- return a + b;
- }
- public double AddDouble(double a, double b)
- {
- return a + b;
- }
- public float AddFloat(float a, float b)
- {
- return a + b;
- }
- }
- class Program
- {
- static void Main(string[] args)
- {
- using (ServiceHost host = new ServiceHost(typeof(MyService),new Uri("http://localhost:9000/service")))
- {
- WSHttpBinding binding = new WSHttpBinding();
- binding.Security.Mode = SecurityMode.None;
- host.AddServiceEndpoint(typeof(IServiceA), binding, "contract1");
- host.Description.Behaviors.Add(new ServiceMetadataBehavior() { HttpGetEnabled = true });
- host.Opened += (sd, arg) => Console.WriteLine("服务已启动。");
- try
- {
- host.Open();
- }
- catch (Exception ex)
- {
- Console.WriteLine(ex.Message);
- }
- Console.ReadKey();
- host.Close();
- }
- }
- }
- }
最后,说说WSDL的事儿,这个家伙我们了解一下就够了,为啥,我们不必自己动手写WSDL文档,甚至说,你看不懂也不影响编程,因为强大的Visual
Studio在我们引用服务时,会为我们生成所需的代码,我们就像使用一般类一个使用就可以了。
若想了解WSDL,看看这个,不错,挺简洁明了的。http://www.w3school.com.cn/wsdl/index.asp