wcf类库及宿主

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

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

 1 using Newtonsoft.Json;
 2 using System;
 3 using System.Collections.Generic;
 4 using System.Linq;
 5 using System.Runtime.Serialization;
 6 using System.ServiceModel;
 7 using System.Text;
 8 
 9 namespace WcfServiceLibrary1
10 {
11     [ServiceContract]
12     public interface IService1
13     {
14         [OperationContract]
15         string GetDataUsingDataContract(CompositeType composite);
16 
17         // TODO: 在此添加您的服务操作
18     }
19 
20     // 可以将 XSD 文件添加到项目中。在生成项目后，可以通过命名空间“WcfServiceLibrary1.ContractType”直接使用其中定义的数据类型。
21     [DataContract]
22     public class CompositeType
23     {
24         [DataMember]
25         public string  UserName{set;get;}
26 
27         [DataMember]
28         public string FullName { set; get; }
29 
30         [DataMember]
31         public string Sex { set; get; }
32         [DataMember]
33         public string Email { set; get; }
34         [DataMember]
35         public string Depart { set; get; }
36         /// <summary>
37         /// 工作性质
38         /// </summary>
39         [DataMember]
40         public string WorkType { set; get; }
41         [DataMember]
42         public string Phone { set; get; }
43 
44         [DataMember]
45         public string ID { set; get; }
46 
47         public string ToJson()
48         {
49             return JsonConvert.SerializeObject(this);
50         }
51     }
52 }

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

 1 using System;
 2 using System.Collections.Generic;
 3 using System.Linq;
 4 using System.Runtime.Serialization;
 5 using System.ServiceModel;
 6 using System.Text;
 7 
 8 namespace WcfServiceLibrary1
 9 {
10     public class Service1 : IService1
11     {
12         public string GetDataUsingDataContract(CompositeType composite)
13         {
14             if (composite == null)
15             {
16                 throw new ArgumentNullException("composite");
17             }
18 
19             return "你好:" + composite.UserName;
20         }
21     }
22 }

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

一、wpf寄宿：

 1 using System;
 2 using System.Collections.Generic;
 3 using System.IO;
 4 using System.Linq;
 5 using System.Net;
 6 using System.ServiceModel;
 7 using System.ServiceModel.Description;
 8 using System.Text;
 9 using System.Threading.Tasks;
10 using System.Windows;
11 using System.Windows.Controls;
12 using System.Windows.Data;
13 using System.Windows.Documents;
14 using System.Windows.Input;
15 using System.Windows.Media;
16 using System.Windows.Media.Imaging;
17 using System.Windows.Navigation;
18 using System.Windows.Shapes;
19 using WcfServiceLibrary1;
20 
21 namespace WpfInterface
22 {
23     public partial class MainWindow : Window
24     {
25         public MainWindow()
26         {
27             InitializeComponent();
28         }
29         private void Window_Loaded(object sender, RoutedEventArgs e)
30         {
31             WCFInit();
32         }
33 
34         private ServiceHost Host = null;
35         void WCFInit()
36         {
37             if (Host == null)
38             {
39                 Host = new ServiceHost(typeof(WcfServiceLibrary1.Service1));
40 
41                 Host.Open();
42 
43                 this.wcfService.Text = "wcf服务已启动";
44             }
45         }
46 
47         private void Window_Closed(object sender, EventArgs e)
48         {
49             if (Host != null)
50             {
51                 Host.Close();
52             }
53         }
54     }
55 }

ServiceHost来自 命名空间：System.ServiceModel，WcfServiceLibrary1.Service1来自类库，所以宿主项目必须引用 System.ServiceModel和wcf类库。39-41行，能够如此简洁地实例化ServiceHost，得益于App.config：

 1 <?xml version="1.0" encoding="utf-8" ?>
 2 <configuration>
 3 
 4   <appSettings>
 5     <add key="aspnet:UseTaskFriendlySynchronizationContext" value="true" />
 6   </appSettings>
 7   <system.web>
 8     <compilation debug="true" />
 9   </system.web>
10   <!-- 部署服务库项目时，必须将配置文件的内容添加到 
11   主机的 app.config 文件中。System.Configuration 不支持库的配置文件。-->
12   <system.serviceModel>
13 
14     <services>
15       <service name="WcfServiceLibrary1.Service1">
16         <host>
17           <baseAddresses>
18             <add baseAddress = "http://localhost:8003/Service1/" />
19           </baseAddresses>
20         </host>
21         <!-- Service Endpoints -->
22         <!-- 除非完全限定，否则地址将与上面提供的基址相关 -->
23         <endpoint address="" binding="basicHttpBinding" contract="WcfServiceLibrary1.IService1">
24           <!-- 
25               部署时，应删除或替换下列标识元素，以反映
26              用来运行所部署服务的标识。删除之后，WCF 将
27               自动推断相应标识。
28           -->
29           <identity>
30             <dns value="localhost"/>
31           </identity>
32         </endpoint>
33         <!-- Metadata Endpoints -->
34         <!-- 元数据交换终结点供相应的服务用于向客户端做自我介绍。 -->
35         <!-- 此终结点不使用安全绑定，应在部署前确保其安全或将其删除-->
36         <endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange"/>
37       </service>
38     </services>
39     <behaviors>
40       <serviceBehaviors>
41         <behavior>
42           <!-- 为避免泄漏元数据信息，
43           请在部署前将以下值设置为 false -->
44           <serviceMetadata httpGetEnabled="True" httpsGetEnabled="True"/>
45           <!-- 要接收故障异常详细信息以进行调试，
46           请将以下值设置为 true。在部署前设置为 false 
47             以避免泄漏异常信息-->
48           <serviceDebug includeExceptionDetailInFaults="False" />
49         </behavior>
50       </serviceBehaviors>
51     </behaviors>
52   </system.serviceModel>
53 
54 </configuration>

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

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

binding：basicHttpBinding（通讯协议）

contract：WcfServiceLibrary1.IService1（契约）

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

二、word插件寄宿：

 1     private void ThisAddIn_Startup(object sender, System.EventArgs e)
 2         {
 3             try
 4             {
 5                 //创建宿主的基地址
 6                 Uri baseAddress = new Uri("http://localhost:8004/Service1");
 7 
 8                 //创建宿主
 9                 host = new ServiceHost(typeof(WcfServiceLibrary1.Service1), baseAddress);
10 
11                 host.AddServiceEndpoint(typeof(WcfServiceLibrary1.IService1), new WSHttpBinding(), "");
12 
13                 //将HttpGetEnabled属性设置为true
14                 ServiceMetadataBehavior smb = new ServiceMetadataBehavior();
15                 smb.HttpGetEnabled = true;
16 
17                 //将行为添加到Behaviors中
18                 host.Description.Behaviors.Add(smb);
19 
20                 //打开宿主
21                 host.Open();
22                 Console.WriteLine("WCF中的HTTP监听已启动....");
23             }
24             catch (Exception ex)
25             {
26                 Console.WriteLine(ex.Message);
27             }
28             finally
29             {
30                 Console.WriteLine("word插件已启动");
31             }
32         }

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

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