转载

WCF基础（上）

WCF(一) Windows Communication Foundation 概述

WCF被推出来很久了，但是对于刚刚接触WCF的人们来说，想必会有以下问题：

WCF是什么？为什么我们需要WCF？WCF能给我们带来什么？学习WCF的难易度如何？

以上这些问题的答案在网上已经很多介绍了，我在此本不必再浪费口舌，只是大概提一下。

WCF: Windows Communication Foundation.从名字可以看出，这是一项和通信密切相关的技术。我们知道软件设计到处是通信。当然我们必须学了以后，才能更好的知道它、运用它，而不能单单从它的名字揣测它的威力如何。

WCF提供给了我们一种面向服务（SOA）的程序设计的解决方案：何为面向服务？之前有使用过.NET Web Service 开发的朋友，很容易理解面向服务是咋回事。.Net Web Service也是更早的时候微软提出的一种面向服务的解决方案。面向服务是一种标准，不同的公司可以给出各自的实现框架。单纯的讲SOA，毕竟太抽象了。学习一下SOA的一种实现比如.Net Web Service 或WCF以后，相信不用任何文字定义，你也会深刻地理解SOA。所以，何为面向服务？这里不解释，等你学一段时间的WCF，你自己就有答案了，真的，呵呵。

WCF提供了统一的通信模型：以前我们写通信可以是：TCP/UDP，Socket等这些方式，在WCF中被统一了。至于如何统一？这里先不说了。所以，当你在项目中同时使用了多种通信方式时，可以考虑使用WCF了。

以前没有接触过Web Service 开发接受WCF也不是难事，相信我！

这次，我们只做一点WCF的概述，更为详细的知识到后面再慢慢展开。边学习，边交流。

1. 打开VS 2010 -->file-->new Project ,选择C#下面的WCF，选择WCF Library。如下图：

WCF基础（上）

2.此时有了IService 文件和一个Service 文件。Service文件实现的IService中的两个函数：GetData函数和GetDataUsingDataContract函数。至于这两个函数是干嘛的？想必不用说大家都能看懂的。之后详细说明他们的角色。这里也不修改类名和函数名了，方面起见。

3.按F5运行程序，此时打开了一个WCF 的一个测试窗口。如下图：先测试GetData函数

WCF基础（上）

测试结果：

WCF基础（上）

同样的方法测试GetDataUsingDataContract函数：结果如下图

WCF基础（上）

4.上面完成了对WCF的函数功能的简单测试，能说明的是Service正确地实现了IService。接下来我们需要将这个WCF部署到一个Web Site中。

在解决方案上面右击：New -->New Web Site 如下图：

WCF基础（上）

修改web site项目中的Service.svc 文件里面的 Service="WcfFirstDemoServiceLib.Service1" （其中意思就是已命名空间加类名的方式指定service的名字）

WCF基础（上）

5.添加一个winForm程序，用它来调用WCF的函数。

WCF基础（上）

6.给winForm 项目添加web 引用：

WCF基础（上）

7.在Form1上面添加几个控件，然后再在Form1.cs中添加下列几行代码：

Form1.cs

8.Ctrl+F5 运行：

WCF基础（上）

说明:这里只是概述WCF,所以全部在使用WCF的默认设置，也没有详细说明每一步的作用是什么。只是给出三个项目：项目1是WCF的库也是WCF功能核心。项目2是WCF的host用于向外界发布WCF提供的接口（注：接口这里指提供了哪些函数可被调用）。项目3是WCF的客户端用于调用WCF。其实，这里已经隐约体现出一点点分布式软件架构的意思了：有专门提供功能实现的模块，有专门提供对外公开接口的模块，有专门作为调用的模块。

后面详细WCF每一部分的。欢迎关注！！

WCF(二) Contract

上篇只是介绍了WCF的概述。具体的设置全是使用默认，这当然不可能满足我们开发的需要。如果仔细理一理的话，你会发现WCF里面的设置其实不算多的(与SharePoint比较的话)。从这篇开始，我们一点一点来展开学习。这次先提最最常用的Contract。

Contract有人翻译为：协定,契约。

WCF中有四种contract: 分别是:1.Service Contract. 2.Data Contract. 3. Fault Contract. 4.Message Contract.

还拿上篇中的例子(其实就是有Visual Studio2010替我们默认生成的代码了)说事：

1.Service Contract共分为两个部分：定义部分和实现部分。

[ServiceContract]
 2     public interface IService1
 3     {
 4         [OperationContract]
 5         string GetData(int value);
 6 
 7         [OperationContract]
 8         CompositeType GetDataUsingDataContract(CompositeType composite);
 9       
10     }

这里IService就是一个service contract的定义部分，指定了哪些函数（Operation）向外公开（即：可供Client调用）。被[OperationContract]修饰的函数可以被客户端（Client）调用。

public class Service1 : IService1
 2     {
 3         public string GetData(int value)
 4         {
 5             return string.Format("You entered: {0}", value);
 6         }
 7 
 8         public CompositeType GetDataUsingDataContract(CompositeType composite)
 9         {
10             if (composite == null)
11             {
12                 throw new ArgumentNullException("composite");
13             }
14             if (composite.BoolValue)
15             {
16                 composite.StringValue += "Suffix";
17             }
18             return composite;
19         }
20     }

Service1实现了IService接口，是Service Contract 的实现部分。VS自动生成的代码太简单了，不解释了。这里为了尽可能简单地说明问题。具体项目中，你可能需要连接数据库增、删、改、查数据，或对数据按n多复杂的业务规则进行数据处理以后，返回给client，等。[ServiceContract] Attribute 可以有以下Property 的:

WCF基础（上）

[OperationContract] Attribute 可以有以下Property 的:

Action 对请求设置WS-Addressing 的action
AsynchPattern 异步模式
HasProtectionLevel 消息是否加密，签名
IsInitiating 表明该函数被调用开始时是否要在server上面初始化一个session
IsOneWay 表明函数被client调用以后，client是否会等待函数返回
IsTerminating 表明该函数被调用结束时是否要在server上面关闭session
Name 设置函数的名字，在client端可见的名字，默认就是函数名字
ProtectionLevel  
ReplyAction 设置函数返回消息的SOAP action

1.1 我们修改一下Service的默认命名空间,使他更make scene(有意义).

打开上篇中的解决方案WcfFirstDemo.sln

右键WebHost项目下面的文件:Service.svc,如下图:

WCF基础（上）

点击连接如图:

WCF基础（上）

得到如图效果:

默认Namespace是http://tempuri.org/ WCF基础（上）

微软官方建议:修改Service的Namespace,使其包含:公司域名+项目名+版本号(如:日期表示版本号)

修改项目:WcfFirstDemoServiceLib下面的IService.cs代码如下:

[ServiceContract(Namespace="http://wwww.cnblogs.com/WCF/2012/07/28")]
 2     public interface IService1
 3     {
 4         [OperationContract]
 5         string GetData(int value);
 6 
 7         [OperationContract]
 8         CompositeType GetDataUsingDataContract(CompositeType composite);
 9       
10     }

右键项目WcfFirstDemoServiceLib 选择重新编译,成功以后,重新用浏览器打开service.svc,得到如下图:

WCF基础（上）

此时已经改变了Service默认的Namespace了,client端需要更新一下,否则运行client端是会报异常的.操作如下图:

WCF基础（上）

1.2修改Service的Name.默认情况下定义service的接口部分(如本例:IService)的名字就是Service的名字.但有时需要让client看到的service的名字跟server端看到的的service名字不一样.

我们先看一下WCFClient项目下面的app.config

WCF基础（上）

修改WcfFirstDemoServiceLib项目下的IService.cs文件

[ServiceContract(Namespace="http://wwww.cnblogs.com/WCF/2012/07/28",Name="DemoService")]
 2     public interface IService1
 3     {
 4         [OperationContract(Name="GetAge")]
 5         string GetData(int value);
 6 
 7         [OperationContract]
 8         CompositeType GetDataUsingDataContract(CompositeType composite);
 9       
10     }

重新编译WcfFirstDemoServiceLib项目.更新client端对service的引用.此时你会发现client端app.config文件前后发生了变化:

WCF基础（上）

此时WCFClient所生成的代理类的名字也会变化,你需要修改WCFClient

DemoService proxy = null;
1         private void Form1_Load(object sender, EventArgs e)
2         {
3             proxy = new DemoServiceClient("BasicHttpBinding_DemoService");
4 
5         }
1         private void btnGetData_Click(object sender, EventArgs e)
2         {
3             this.tbOutputBox.Text = proxy.GetAge(Convert.ToInt32(this.tbInputbox.Text));
4         }

注:上面代码中DemoService 对应server端IService接口;DemoServiceClient对应server端的Service类.

当client端的app.config文件中只包含一个endpoint时,可以直接用proxy=new DemoServiceClient()传空参数,当然也可以传这个endpoint的name进去;但是当app.config包含多个endpoint时必须把endpoint的name传进去才能new出proxy对象.

2.DataContract.

WCF的Server和client之间利用特定格式的Message(消息)进行通信的。但是我们使用的高级语言：不论在Server端还是在client端，我们处理的业务数据都被封装成了对象。所以想把server端的对象传送到client（或相反方向）时，我们必须有能力把这些对象转换成特定格式的message，到另一端接收到message后再把它转回成对象。C#的基础类型（如int,string,float,bool等）可以做到这一点。因为一旦确定了Server端或client所用的编程语言，就可以确定这些基础类型的内存占用情况（例如：一个Server端定义的int变量在C#中占用多大内存空间是已知的，那么client端即便使用的是其他语言也完全可以计算出该变量的内存占用情况）。可是我们自己定义的类型可是五花八门了（比如：server端定义的Person类new出的object到底占用多大内存空间，就算Server端与client端使用同一种语言，Client端是不知道的Person类的对象的内存占用情况的。）

遇到这种请款下，我们怎么办呢？这时就轮到[DataContract]露面了。

WCF基础（上）

ServiceContract做的工作是指定service向client提供了哪些函数可供调用。DataContract做的工作就是指定在Server端与client端之间可以传送的数据。[DataContract]的作用就是指定当需要传送某个类（如：Person类）的对象时，将该对象转化成为XML.接受方接到XML以后，再按同样的方式还原成对象。

[DataContract]Attribute 标在class定义上面一行。[DataMember]Attribute标在Property定义上面一行，field不需要Attribute修饰。

[DataContract]
 2     public class CompositeType
 3     {
 4         bool boolValue = true;
 5         string stringValue = "Hello ";
 6 
 7         [DataMember]
 8         public bool BoolValue
 9         {
10             get { return boolValue; }
11             set { boolValue = value; }
12         }
13 
14         [DataMember]
15         public string StringValue
16         {
17             get { return stringValue; }
18             set { stringValue = value; }
19         }
20     }

[DataContract]Attribute 可以像[ServiceContract]一样设置Name和Namespace.

[DataMember] Attribute 可以有以下属性：

EmitDefaultValue 设置一个默认值
IsRequired 进行序列化/反序列化时该值一定不可为空值
Name Property的名字
Order 设置进行序列化/反序列化的顺序

2.1修改DataContract的默认namespace ,

[DataContract(Namespace = "http://wwww.cnblogs.com/WCF/2012/07/28", Name = "CompositeTypeDemo")]
 2     public class CompositeType
 3     {
 4         bool boolValue = true;
 5         string stringValue = "Hello ";
 6 
 7         [DataMember(Name="GetBool")]
 8         public bool BoolValue
 9         {
10             get { return boolValue; }
11             set { boolValue = value; }
12         }
13 
14         [DataMember(Name="GetString")]
15         public string StringValue
16         {
17             get { return stringValue; }
18             set { stringValue = value; }
19         }
20     }