wcf类库及宿主

说起wcf，一直以来总是直接创建wpf的应用程序，这样默认的宿主是IIS。如果想更换宿主，那么我们首先得创建wcf类库。

这个类库会自动创建一个app.config文件。到最后部署的时候，把它移到宿主的项目下。看看IService1.cs：

using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Runtime.Serialization;
using System.ServiceModel;
using System.Text;

namespace WcfServiceLibrary1
{
    [ServiceContract]
    public interface IService1
    {
        [OperationContract]
        string GetDataUsingDataContract(CompositeType composite);

        // TODO: 在此添加您的服务操作
    }

    // 可以将 XSD 文件添加到项目中。在生成项目后，可以通过命名空间“WcfServiceLibrary1.ContractType”直接使用其中定义的数据类型。
    [DataContract]
    public class CompositeType
    {
        [DataMember]
        public string  UserName{set;get;}

        [DataMember]
        public string FullName { set; get; }

        [DataMember]
        public string Sex { set; get; }
        [DataMember]
        public string Email { set; get; }
        [DataMember]
        public string Depart { set; get; }
        /// <summary>
        /// 工作性质
        /// </summary>
        [DataMember]
        public string WorkType { set; get; }
        [DataMember]
        public string Phone { set; get; }

        [DataMember]
        public string ID { set; get; }

        public string ToJson()
        {
            return JsonConvert.SerializeObject(this);
        }
    }
}

该接口只提供一个方法，接收一个对象，返回string，再来看它的实现：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Runtime.Serialization;
using System.ServiceModel;
using System.Text;

namespace WcfServiceLibrary1
{
    public class Service1 : IService1
    {
        public string GetDataUsingDataContract(CompositeType composite)
        {
            if (composite == null)
            {
                throw new ArgumentNullException("composite");
            }

            return "你好:" + composite.UserName;
        }
    }
}

然后，我们创建宿主程序。

一、wpf寄宿：

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Net;
using System.ServiceModel;
using System.ServiceModel.Description;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;
using WcfServiceLibrary1;

namespace WpfInterface
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }
        private void Window_Loaded(object sender, RoutedEventArgs e)
        {
            WCFInit();
        }

        private ServiceHost Host = null;
        void WCFInit()
        {
            if (Host == null)
            {
                Host = new ServiceHost(typeof(WcfServiceLibrary1.Service1));

                Host.Open();

                this.wcfService.Text = "wcf服务已启动";
            }
        }

        private void Window_Closed(object sender, EventArgs e)
        {
            if (Host != null)
            {
                Host.Close();
            }
        }
    }
}

ServiceHost来自 命名空间：System.ServiceModel，WcfServiceLibrary1.Service1来自类库，所以宿主项目必须引用 System.ServiceModel和wcf类库。39-41行，能够如此简洁地实例化ServiceHost，得益于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="WcfServiceLibrary1.Service1">
        <host>
          <baseAddresses>
            <add baseAddress = "http://localhost:8003/Service1/" />
          </baseAddresses>
        </host>
        <!-- Service Endpoints -->
        <!-- 除非完全限定，否则地址将与上面提供的基址相关 -->
        <endpoint address="" binding="basicHttpBinding" contract="WcfServiceLibrary1.IService1">
          <!-- 
              部署时，应删除或替换下列标识元素，以反映
             用来运行所部署服务的标识。删除之后，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>

wcf配置的三要素，简称ABC。

baseAddress：http://localhost:8003/Service1（地址）

binding：basicHttpBinding（通讯协议）

contract：WcfServiceLibrary1.IService1（契约）

针对这三要素，最复杂的和不好理解的就是bingding。binding背后隐藏了wcf的通讯机制，需要再单独研究。

二、word插件寄宿：

    private void ThisAddIn_Startup(object sender, System.EventArgs e)
        {
            try
            {
                //创建宿主的基地址
                Uri baseAddress = new Uri("http://localhost:8004/Service1");

                //创建宿主
                host = new ServiceHost(typeof(WcfServiceLibrary1.Service1), baseAddress);

                host.AddServiceEndpoint(typeof(WcfServiceLibrary1.IService1), new WSHttpBinding(), "");

                //将HttpGetEnabled属性设置为true
                ServiceMetadataBehavior smb = new ServiceMetadataBehavior();
                smb.HttpGetEnabled = true;

                //将行为添加到Behaviors中
                host.Description.Behaviors.Add(smb);

                //打开宿主
                host.Open();
                Console.WriteLine("WCF中的HTTP监听已启动....");
            }
            catch (Exception ex)
            {
                Console.WriteLine(ex.Message);
            }
            finally
            {
                Console.WriteLine("word插件已启动");
            }
        }

由于word插件中不能使用配置文件，所以WCF的ABC三要素硬编码实现。

注意：wcf宿主程序启动时，必须以管理员的权限启动，否则会报错。