WCF宿主实践入门
本篇属于WCF实践入门,由于博主本人水平有限,没有理论上的介绍,仅仅从其几种不同的宿主方式分别介绍WCF的使用。
WCF有多种宿主方式:1、自托管宿主,2、windows service宿主,3、IIS宿主,4、WAS宿主
本篇一一进行简要介绍(win7 + vs2012)。
一、自托管宿主
利用WCF提供的ServiceHost<T>提供的Open()和Close()方法。
- 新建WCF服务库
- 新建WCF宿主应用程序
1)新建一个解决方案,名称为WcfService1Study。新建一个WCF服务库如下图:
2)我们将接口和类名分别重命名IDataService和DataService(读者自便),简化其中代码如下(只是为了实验而已)
//IDataService.cs namespace WcfServiceLibrary { // 注意: 使用“重构”菜单上的“重命名”命令,可以同时更改代码和配置文件中的接口名“IService1”。 [ServiceContract] public interface IDataService { [OperationContract] CompositeType GetData(); } // 使用下面示例中说明的数据约定将复合类型添加到服务操作。 // 可以将 XSD 文件添加到项目中。在生成项目后,可以通过命名空间“WcfServiceLibrary.ContractType”直接使用其中定义的数据类型。 [DataContract] public class CompositeType { bool boolValue = true; string stringValue = "Hello "; [DataMember] public bool BoolValue { get { return boolValue; } set { boolValue = value; } } [DataMember] public string StringValue { get { return stringValue; } set { stringValue = value; } } } }
//DataService.cs namespace WcfServiceLibrary { // 注意: 使用“重构”菜单上的“重命名”命令,可以同时更改代码和配置文件中的类名“Service1”。 public class DataService : IDataService { public CompositeType GetData() { //仅仅返回一个类 return new CompositeType(); } } }
到此,我们的WCF类库已经建好了。
3)修改App.config
默认在不修改配置文件的情况下,vs会自动给我们的服务配置到一个端口,如下 http://localhost:8733/Design_Time_Addresses/WcfServiceLibrary1/Service1/
我们修改App.config如下:
<?xml version="1.0" encoding="utf-8" ?> <configuration> <appSettings> <add key="aspnet:UseTaskFriendlySynchronizationContext" value="true" /> </appSettings> <system.web> <compilation debug="true" /> </system.web> <!-- 部署服务库项目时,必须将配置文件的内容添加到 主机的 app.config 文件中。System.Configuration 不支持库的配置文件。--> <system.serviceModel> <services> <service name="WcfServiceLibrary.DataService"> <host> <baseAddresses> <add baseAddress="http://localhost:8081/WcfServiceLibrary/DataService/" /> </baseAddresses> </host> <!-- Service Endpoints --> <!-- 除非完全限定,否则地址将与上面提供的基址相关 --> <endpoint address="" binding="basicHttpBinding" contract="WcfServiceLibrary.IDataService"> <!-- 部署时,应删除或替换下列标识元素,以反映 用来运行所部署服务的标识。删除之后,WCF 将 自动推断相应标识。 --> <identity> <dns value="localhost"/> </identity> </endpoint> <!-- Metadata Endpoints --> <!-- 元数据交换终结点供相应的服务用于向客户端做自我介绍。 --> <!-- 此终结点不使用安全绑定,应在部署前确保其安全或将其删除--> <!--<endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange"/>--> </service> </services> <behaviors> <serviceBehaviors> <behavior> <!-- 为避免泄漏元数据信息, 请在部署前将以下值设置为 false --> <serviceMetadata httpGetEnabled="True" httpsGetEnabled="True"/> <!-- 要接收故障异常详细信息以进行调试, 请将以下值设置为 true。在部署前设置为 false 以避免泄漏异常信息--> <serviceDebug includeExceptionDetailInFaults="False" /> </behavior> </serviceBehaviors> </behaviors> </system.serviceModel> </configuration>
主要改动是服务地址的改动和约束(因为我们的类重命名了)的改动
<baseAddresses> <add baseAddress="http://localhost:8081/WcfServiceLibrary/DataService/" /> </baseAddresses>
<endpoint address="" binding="basicHttpBinding" contract="WcfServiceLibrary.IDataService">
vs2012集成了wcf的测试客户端,ctrl+F5即可启动并测试wcf服务,效果如下:
注意这里的【配置文件】菜单,里面包含有客户端对应的配置信息,接下来我们会用到。
到这里,我们的WCF库已经建好、配置好,也测试通过了。接下来建立宿主程序。
4)新建一个ConsoleApplication,命名为ConsoleAppSelfHost,增加对刚刚建好的WCF库的项目引用。
添加 System.ServiceModel引用,修改代码如下:
using System.ServiceModel; namespace ConsoleAppSelfHost { class Program { static void Main(string[] args) { using (ServiceHost host = new ServiceHost(typeof(WcfServiceLibrary.DataService))) { host.Open(); Console.WriteLine("wcf data service is running!"); Console.Read();//阻塞宿主程序结束,期间供客户端调用该wcf服务 host.Close(); } } } }
5)修改ConsoleApplication的App.config,将第三步中标红文字操作的内容拷贝到配置文件即可。
6)测试运行,如下:
查了好久都没有找到解决方案~~~最后仔细看了下这个错误,“未经处理的异常: System.InvalidOperationException: 服务“WcfServiceLibrary.DataService”有零个应用程序(非基础结构)终结点。这可能是因为未找到应用程序的配置文件,或者在配置文件中未找到与服务名称匹配的服务元素,或者服务元素中未定义终结点。”,问题是出在配置文件,我试着将WCF服务库的配置文件中的services节点拷贝到宿主程序配置中,测试,通过!
我的理解:在这种自宿主方式下,WCF服务库的配置文件其实只是用来测试的,其能真正对外服务则需要宿主程序进行配置,即宿主程序就是服务端,而WCF服务库在这种方式下其实就是一个类库,仅仅提供dll即可。
经过修改,最终宿主程序的配置文件如下:
<?xml version="1.0" encoding="utf-8" ?> <configuration> <startup> <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" /> </startup> <system.serviceModel> <services> <service name="WcfServiceLibrary.DataService"> <endpoint address="" binding="basicHttpBinding" contract="WcfServiceLibrary.IDataService"> <identity> <dns value="localhost" /> </identity> </endpoint> <host> <baseAddresses> <add baseAddress="http://localhost:8081/WcfServiceLibrary/DataService/" /> </baseAddresses> </host> </service> </services> <client> <endpoint address="http://localhost:8081/WcfServiceLibrary/DataService/" binding="basicHttpBinding" contract="WcfServiceLibrary.IDataService"></endpoint> </client> </system.serviceModel> </configuration>
运行,通过,大功告成。通过宿主Console窗口可以查看效果(在宿主运行期间,即wcf服务打开的时候,通过WCF的地址也可查看wsdl)。
二、windows service宿主
Windows Service宿主的实现就是依赖Windows Service项目,在Windows服务类(继承了ServiceBase类)的OnStart()和OnStop()方法中启动和关闭WCF服务的功能。
1)继续使用上述的WCF服务类库
2)新建一个windows service项目,命名为WindowsServiceHost,增加对刚刚建好的WCF库的项目引用。
添加 System.ServiceModel引用,重命名Service1为WCFService,代码如下:
namespace WindowsServiceHost { public partial class WCFService : ServiceBase { ServiceHost _host = null; public WCFService() { InitializeComponent(); } protected override void OnStart(string[] args) { if (_host != null) { _host.Close(); _host = null; } _host = new ServiceHost(typeof(WcfServiceLibrary.DataService)); _host.Open(); } protected override void OnStop() { if (_host != null) { _host.Close(); _host = null; } } } }
3)配置文件和自宿主方式一样。
4)增加安装包程序
在WCFService的设计模式下右键【添加安装程序】即可。
5)我们通过在Visual Studio的Command Prompt模式下运行如下命令:
E:\testProjects\WcfService1Study\WindowsServiceHost\bin\Debug>InstallUtil WindowsServiceHost.exe
即可完成对服务宿主的安装。
6)在新安装的windows服务没有启动的时候,我们查看WCF的wsdl(配置的地址 http://localhost:8081/WcfServiceLibrary/DataService/)是无法访问的,当启动该服务之后,即可成功访问,说明Wcf服务成功寄宿在windows服务内。
三、IIS宿主
IIS宿主的使用相当简单。
1)新建wcf 服务应用程序,该应用程序可以被发布到IIS,即可完成IIS的寄宿。
本人修改了项目中的IService.cs为IMyWcfService.cs,Service.svc为MyWcfService.svc,CompositeType为MyWcfClass,读者自行随意修改。
我们将其发布地址设置为:http://127.0.0.1/WcfService1Study/
访问http://127.0.0.1/WcfService1Study/MyWcfService.svc,即可看到wsdl内容。
2)新建web应用程序,添加服务引用(wcf地址 http://127.0.0.1/WcfService1Study/MyWcfService.svc)即可调用wcf了。
web.config的内容都是自动添加的,每次更新服务应用,web.config也会更新。
四、WAS宿主
博主还没有对WAS宿主的大体认识,故借鉴大牛博客介绍如下:
WAS是IIS 7.0的一部分,但也可以独立地安装与配置。WAS支持所有可用的WCF传输协议、端口与队列。
利用WAS托管服务与IIS宿主托管服务的方法并没有太大的区别,仍然需要创建svc文件,同时在IIS中需要在站点中创建应有程序指向托管应用程序,还可以设置访问服务的别名与应用程序池。
由于WAS诉诸支持所有的绑定,因此此时的服务绑定并不会受到宿主的限制。
到此,四种宿主方式简单实践入门就完成了。
博主水平有限,理论知识有待提升,望和诸位博友共同学习进步。