本随笔参考自WCF编程系列(一)初识WCF,纯属读书笔记,加深记忆。
1、简介:Windows Communication Foundation(WCF)是微软为构建面向服务的应用程序所提供的统一编程模型。在WCF之前,.NET Framework提供了多种分布式技术,如ASP.NET Web服务、.NET Framework远程处理、企业服务、WSE以及Microsoft消息队列。一般我们在编写一个应用程序时通常会同时使用多项技术,所以,微软将这些分布式应用程序集成到了一起,形成了WCF这个框架。即通过WCF能实现上面所有的分布式功能。
2、WCF的基本组成
(1)、地址:定义服务的地址,也就是服务接口所在地的IP地址
(2)、绑定:定义服务的通讯方式(传输协议、编码方案)
(3)、契约:定义服务的具体实现
(4)、终结点(endpoint):由地址、绑定、契约共同构成一个终结点,服务器通过终结点向客户端公开服务,客户端通过终结点来调用服务。
注:WCF是面向接口编程
3、简易demo
(1)、第一步
i、首先创建一个IService类库(服务层)。
ii、引用引入System.ServiceModel命名空间和当前解决方案的Service命名空间和IService命名空间
iii、然后在服务层下面新建一个服务接口IUserInfoService,并在该接口上添加[ServiceContract]特性(及服务契约),表明该接口是一个服务
iiii、在接口中定义Add方法,并在方法上添加[OperationContract]特性,表示Add方法是IUserInfoService服务接口的一个服务方法,客户端可远程调用该方法
using System; using System.ServiceModel; namespace IService { [ServiceContract] public interface IUserInfoService { [OperationContract] //相当于WebService中的[WebMethod]特性标签 int Add(int a, int b); } }
(2)、第二步
i、创建一个Service类库(服务层的具体实现)
ii、实现服务层中的所有方法
using System; using IService; namespace Service { public class UserInfoService : IUserInfoService { public int Add(int a, int b) { return a + b; } } }
ok,到这里服务端的WCF服务创建完成
(3)、第三步,个人觉得是WCF最重要的一步,同时也是提现它功能强大的地方之一,提供WCF服务的宿主(它的宿主可以使任何应用程序,包括Web应用程序、控制台、Windows Form程序),这里使用控制台程序。
宿主程序:WCF通过改程序向外部发布服务,也就是说改程序必须保持启动的状态,否则WCF中的服务,外界将无法获取。
i、创建一个控制台程序Host,作为WCF的宿主程序
ii、引入System.ServiceModel命名空间和IService命名空间和Service命名空间
iii、通过下面的代码启动WCF服务
using System; using System.Collections.Generic; using System.Linq; using System.ServiceModel; using System.Text; using System.Threading.Tasks; namespace Host { class Program { static void Main(string[] args) { using (ServiceHost host = new ServiceHost(typeof(Service.UserInfoService))) { host.Open(); Console.WriteLine("服务器启动成功"); Console.ReadLine(); } } } }
当然,现在肯定启动不了,因为最重要的配置文件,还没有设置。使用WCF大部分时间,都在配配置文件。
(4)、第四步,编写WCF宿主的配置文件app.config,来配置我们的WCF程序
<?xml version="1.0" encoding="utf-8" ?> <configuration> <system.serviceModel> <services> <service name="Service.UserInfoService" behaviorConfiguration="behaviorConfiguration"> <host> <baseAddresses> <add baseAddress="http://localhost:8000/"/> </baseAddresses> </host> <endpoint address="" binding="basicHttpBinding" contract="IService.IUserInfoService"></endpoint> </service> </services> <behaviors> <serviceBehaviors> <behavior name="behaviorConfiguration"> <serviceMetadata httpGetEnabled="true"/> </behavior> </serviceBehaviors> </behaviors> </system.serviceModel> </configuration>
ok,所有的准备工作都以就绪,现在重新生成整个解决方法。右键Host,打开其本地文件夹,找到Host.exe程序,启动服务,注意不要关闭。
(5)、第五步,测试WCF服务是否能正常使用,有两种方法可供测试
i、打开浏览器输入服务地址:http://localhost:8000/,这个地址是我们在app.config文件中配置的UserInfoService服务的地址
ok,说明WCF服务端已经启动客户端可以正常调用
ii、使用vs2010以上的自带的WCF测试工具,通过这个工具,也可以测试当前服务是否正常启动。
输入服务地址,点击确定。
说明服务正常启动。
(6)、第六步,客户端访问,在确认服务端正常启动后,下面就要通过客户端来测试服务能否正常调用
i、创建一个名为Client的客户端控制台程序
ii、生成客户端代理类,通过代理类来调用服务端程序,生成客户端代理类有两种方式(我知道的),
第一种:通过微软的svcutil工具生成UserInfoService服务的客户端代理类,开始菜单/Microsoft Visual Studio 2012/Visual Studio Tools/Visual Studio 2012开发人员命令提示
打开该工具,在工具中定位到当前需要调用WCF服务的客户端目录下,然后输入
svcutil http://服务地址/?wsdl /o:客户端文件名.cs,,回车,在回车前需确认WCF服务端是开启的。回到Client项目,选择添加 现有项 ,然后选择这两个文件,添加后,将output.config重命名为App.config,ok,文件初始化完成,第一种方法介绍完毕,下面通过代码测试,代码如下:
using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; namespace Client { class Program { static void Main(string[] args) { UserInfoServiceClient client = new UserInfoServiceClient(); Console.WriteLine(client.Add(1, 2)); } } }
ok,说明Client调用WCF服务成功!
第二种方法:这种方法,仅限于Web客户端的调用,新建一个空Web应用程序,右击添加服务引用
,输入服务地址http://localhost:8000/,点击添加。
ok,客户端代理类添加成功。下面通过代码测试,当前Web项目能否正常使用WCF服务端服务,新建Web窗体,修改后台代码如下:
using System; using System.Collections.Generic; using System.Linq; using System.Web; using System.Web.UI; using System.Web.UI.WebControls; using Web.ServiceReference1; namespace Web { public partial class WebForm1 : System.Web.UI.Page { protected void Page_Load(object sender, EventArgs e) { UserInfoServiceClient client = new UserInfoServiceClient(); Response.Write(client.Add(1, 2)); } } }
运行当前窗体,,ok,说明everything is ok.