示例一中我们使用了scvutil命令自动生成了服务的客户端代理类:
svcutil http://localhost:8000/?wsdl /o:FirstServiceClient.cs
命令中http://localhost:8000/?wsdl连接返回一个XML,该XML即为元数据:用以描述如何与服务的终结点进行交互。正因为有元数据的存在,svcutil命令才能自动生成客户端代理类。
元数据遵循Web服务描述语言(WSDL)标准,所以可被多种语言支持,除WCF的svcutil外,Java程序员也可使用诸如WSDL2Java的工具生成Java语言的客户端代理类。
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
-
<?xml version="1.0" encoding="utf-8" ?>
-
<configuration>
-
<system.serviceModel>
-
<services>
-
<service name="Xfrog.Study.WCF.FirstService" behaviorConfiguration="behaviorConfiguration">
-
......
-
</service>
-
</services>
-
<behaviors>
-
<serviceBehaviors>
-
<behavior name="behaviorConfiguration">
-
<serviceMetadata httpGetEnabled="true"/>
-
</behavior>
-
</serviceBehaviors>
-
</behaviors>
-
</system.serviceModel>
-
</configuration>
已终结点方式公开服务的元数据
此方案下,服务的元数据也是一个服务终结点,其形式与服务终结点完全一致,只是endpoint中的绑定和契约是特定于元数据的,。
关于元数据的绑定类型有以下四种方式,分别对应不同的访问协议:
对应于HTTP协议的mexHttpBinding
对应于HTTPS协议的mexHttpsBinding
对应于命名管道协议的mexNamedPipeBinding
对应于TCP协议的mexTcpBinding
在配置文件中元数据的终结点定义方式和我们的服务终结点定义方式完全一致,通过<endpoint>节点来定义,其中address属性指定元数据的地址,同样可以使用绝对地址和相对地址,binding属性指定元数据的绑定类型,即上述4种绑定类型之一,contract属性指定契约类型,元数据的契约类型固定为IMetadataExchange
以下配置文件为示例添加了一个元数据地址,该元数据使用http协议,访问路径为http://localhost:8000/mex
-
<?xml version="1.0" encoding="utf-8" ?>
-
<configuration>
-
<system.serviceModel>
-
<services>
-
<service name="Xfrog.Study.WCF.FirstService" behaviorConfiguration="behaviorConfiguration">
-
......
-
<endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange"></endpoint>
-
</service>
-
</services>
-
<behaviors>
-
<serviceBehaviors>
-
<behavior name="behaviorConfiguration">
-
<serviceMetadata httpGetEnabled="true"/>
-
</behavior>
-
</serviceBehaviors>
-
</behaviors>
-
</system.serviceModel>
-
</configuration>
注意:以终结点的方式公开的元数据,无法通过浏览器查看元数据内容
使用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来实现的话,服务端可以无需公开元数据,而客户端使用离线元数据文档来产生代理类。