如何配置wcf终结点?
来源:广州中睿信息技术有限公司
发布时间:2012/10/21 23:25:16 编辑:itlead 阅读 2745



  一 配置文件方式

  WCF服务公开自己的元数据可采用两种方案,一是使用基于HTTP-GET协议提供元数据,二是使用专门的终结点方式。

  下面将讲述如何通过配置文件来公开服务的元数据

  以HTTP-GET方式公开元数据:

  此方法我们在我们前述示例中已经使用

  1.在Host项目配置文件中,<service>配置节点中指定behaviorConfiguration值为 behaviorConfiguration

  2.在<behaviors><serviceBehaviors>下添加一个name属性为 behaviorConfiguration的<behavior>节点

  3.在<behavior>下添加子节点<serviceMetadata> 将httpGetEnabled属性设为true,通过此属性启用HTTP-GET元数据

  4.以HTTP-GET方式公开的元数据可通过服务地址加wsdl参数的形式来获取:如 http://localhost:8000/?wsdl

    1.jpg

  已终结点方式公开服务的元数据

  此方案下,服务的元数据也是一个服务终结点,其形式与服务终结点完全一致,只是endpoint中的绑定和契约是特定于元数据的,。

  关于元数据的绑定类型有以下四种方式,分别对应不同的访问协议:

  对应于HTTP协议的mexHttpBinding

  对应于HTTPS协议的mexHttpsBinding

  对应于命名管道协议的mexNamedPipeBinding

  对应于TCP协议的mexTcpBinding

  在配置文件中元数据的终结点定义方式和我们的服务终结点定义方式完全一致,通过<endpoint>节点来定义,其中address属性指定元数据的地址,同样可以使用绝对地址和相对地址,binding属性指定元数据的绑定类型,即上述4种绑定类型之一,contract属性指定契约类型,元数据的契约类型固定为IMetadataExchange

  以下配置文件为示例添加了一个元数据地址,该元数据使用http协议,访问路径为http://localhost:8000/mex

   2.jpg

  注意:以终结点的方式公开的元数据,无法通过浏览器查看元数据内容

 

  使用svcutil下载服务元数据

  通过元数据URL来下载元数据:

  WCF中我们并不需要直接操作元数据,不过svctuil工具还是提供了元数据下载工具,通过指定/t:metadata参数及元数据url即可下载服务的元数据,如下载上述通过终结点指定的元数据,可使用如下命令:

  svcutil /t:metadata http://localhost:8000/mex

  当然,运行此命令之前,你需要先启动我们的服务。命令运行完成后,会在当前目录生成三个文件:

  tempuri.org.wsdl 服务的WSDL描述文档

  tempuri.org.xsd 服务的XML架构定义文档

  schemas.microsoft.com.2003.10.Serialization.xsd 包含一组.NET基础类型的XML架构定义

  后两个xsd文档在wsdl中被引用(xsd:import),通过这两个XML架构定义文件,元数据导入工具可以验证wsdl元数据是否符合WSDL标准。

 

  通过服务程序集来下载元数据

  如果服务类是使用WCF编写的,则svcutil可直接使用服务的程序集(注意:不是宿主程序集)来生成元数据文档,而服务也无需公布自己的元数据,命令如下:

  svcutil XfrogWCFService.dll --注意:试验时,请先将当前路径切换到XfrogWCFService.dll所在目录

  与使用元数据URL方式一样,最终会产生一致的三个文档。

  通过下载的元数据生成客户端代理类

  使用svcutil下载的元数据文档,我们可以使用svcutil命令来生成服务的客户端代理类,而无需使用服务的元数据URL,假设当前目录中存在上述三个元数据文件,则命令如下:

  svcutil tempuri.org.* /o:FirstServiceClient.cs /config:App.config

  命令执行成功后,会在当前目录下生成客户端的代理类的代码文件及配置文件。

 

  安全性

  公开服务的元数据后,实际上使我们的服务端多了一种被攻击的可能,当然你可以使用HTTPS安全连接绑定的终结点来保护你的元数据终结点,但如果你的客户端同样是使用WCF来实现的话,服务端可以无需公开元数据,而客户端使用离线元数据文档来产生代理类。


  二 编程方式

  ServiceHost类

  即服务宿主类,它为我们的服务提供一个运行环境。ServiceHost的构造函数有三个重载:

  ServiceHost() 使用无参数的构造必须要有相应的配置文件设置。

  ServiceHost(Object,Uri[]) Object参数为一个服务类的实例(如示例一中的FirstService类),Uri[]参数指定服务终结点的默认基地址,对应于我们配置文件中的<host><baseAddress>配置节点下设置。此构造函数使用于”单实例”的服务。

  ServiceHost(Type,Uri[]) Type参数指定服务的类型(使用typeof获取),对应于配置文件中<service>配置节点的name属性,如示例一中的<service name="Xfrog.Study.WCF.FirstService"…>,Uri[]参数指定服务终结点的默认基地址。

 

  ServiceHost.AddServiceEndPoint方法

  顾名思义,此方法用于向宿主添加一个服务终结点,该方法有8个重载,但实际上可区分为两个版本:三参数版本和四参数版本,三参数版本中,三个参数依次传入终结点的契约类型、绑定及地址,其中契约类型可以使用String类型传入服务契约的全局限定名(如示例一中的"Xfrog.Study.WCF.IFirstService",也可以使用typeof操作符来传入契约的类型(Type);绑定参数传入一个 Binding对象,该对象可以通过预定义绑定类型来实例化;地址参数可以使用String类型传入也可以使用Uri类型实例传入,与使用配置文件相似,地址可使用绝对地址或相对地址。由于第一、三参数分别有两个重载,所以三参数版本对应有6个重载版本。

  四参数的版本,除了前述三个参数外,第四个参数为一个Uri类型,该地址表示一个服务的侦听地址,即服务通过该地址来侦听客户端的请求。所以四参数的版本实际上是提供了“多个终结点在同一个地址上侦听”的功能。


  示例

  通过编程方式为示例一添加终结点:

  1.复制实例一文件夹,将其改名为XfrogWCFStudy003

  2.打开Host项目下的App.config文件,屏蔽掉配置内容:

    3.jpg

  3.修改Host项目Program.cs代码如下:

    4.jpg

  示例

  1.通过编程方式启用元数据

  2.获取终结点信息

  Program.cs代码如下,请参照MSDN了解类的使用方法

   5.jpg

 

 

本站技术原创栏目文章均为中睿原创或编译,转载请注明:文章来自中睿,本站保留追究责任的权利。