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诉诸支持所有的绑定，因此此时的服务绑定并不会受到宿主的限制。

---

到此，四种宿主方式简单实践入门就完成了。

博主水平有限，理论知识有待提升，望和诸位博友共同学习进步。