传说中的WCF（2）：服务协定的那些事儿

传说中的WCF（1）：这东西难学吗？传说中的WCF（2）：服务协定的那些事儿传说中的WCF（3）：多个协定传说中的WCF（4）：发送和接收SOAP头传说中的WCF（5）：数据协定（a）传说中的WCF（6）：数据协定（b）传说中的WCF（7）：“单向”&“双向”传说中的WCF（8）：玩转消息协定传说中的WCF（9）：流与文件传输传说中的WCF（10）：消息拦截与篡改传说中的WCF（11）：会话（Session）传说中的WCF（12）：服务器回调有啥用传说中的WCF（13）：群聊天程序传说中的WCF（14）：WCF也可以做聊天程序

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

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

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

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

比如下面这个协定：

[ServiceContract]
public interface IServiceA
{
[OperationContract]
int AddInt(int a, int b);

[OperationContract]
double AddDouble(double a, double b);

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;
}
}

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



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

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

[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文件。



<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/，然后，回到服务器端的代码，我们显式设置一个命名空间，看看生成的客户端代码又将如何。

[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://的方式吗？我用其它字符串行吗？不必问，试一下就知道了。

[ServiceContract(Namespace = "FuckingDog")]
public interface IServiceA
{
.............

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



好了，结论出来了。

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



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

[ServiceContract(Namespace = "FuckingDog", Name = "HaHaHa")]
public interface IServiceA
{
.......

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



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

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

[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有趣不？本文的服务器端示例完整代码清单如下。

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

转IT黄老邪