WCF热带鱼书学习手记 - metadata

WCF – MetaData

WCF的metadata描述了客户端如何同服务进行交互。通过metadata，我们可以利用一些工具生成proxy代码，比如SvcUtil.exe，客户端编程基本上是基于这些proxy的

服务有两种方案可以发布自己的元数据。一种是基于HTTP-GET协议提供元数据；另一种则为元数据交换方式，它往往使用一个专门的终结点，称之为元数据交换终结点。元数据交换终结点与其它终结点相似，仍然包含了地址、绑定与契约，但是使用的服务契约为WCF提供的接口IMetadataExchange。

实际上，这两种发布元数据的方式代表了它使用了两种不同的标准协议，前者为HTTP/GET请求，后者为WS-MetadataExchange(MEX)。在WCF，以MetadataExchangeClientMode枚举类型表示这两种元数据交换模式：

 

public enum MetadataExchangeClientMode

{

    MetadataExchange,

    HttpGet

} 

 

1. HTTP-GET

起用了这种方式的metadata发布，客户端可以通过浏览器察看并确认元数据。同前面几篇文章介绍的一样，启用方法也是2种：编成和配置。

配置元数据发布是通过添加ServiceBehavior来实现的，例子如下：

<system.serviceModel>

    <services>

      <service name="MyNamespace.MyService" behaviroConfiguration="MEXGET">

        <endpoint contract = "MyNamespace.IMyService"

                  binding  = "wsHttpBinding"

                  address  = "http://localhost:8000/MyService"

        />

      </service>

    </services>

    <behaviors>

        <serviceBehaviors>

            <behavior name="MEXGET">

                <serviceMetadata httpGetEnabled="true"/>

            </behavior>

        </serviceBehaviors>

    </behaviors>

</system.serviceModel>

 

编程方式：

 

ServiceHost host = new ServiceHost(typeof(MyService));

ServiceMetadataBehavior metadataBehavior = host.Description.Behaviors.Find<ServiceMetadataBehavior>();

if(metadataBehavior == null)

{

    metadataBehavior = new ServiceMetadataBehavior();

    metadataBehavior.HttpGetEnabled = true;

    host.Description.Behaviors.Add(metadataBehavior);

}

Binding wsHttpBinding = new WSHttpBinding();

host.AddServiceEndpoint(typeof(IMyService),

                        wsHttpBinding,

                        new Uri("http://localhost:8086/MyService/"));

host.Open();

...            

host.Close();

 

2. Metadata-Exchange

这种方式是通过定义特定的endpoint的方式来发布元数据，这种endpoint被称作元数据终结点或者MEX终结点。WCF为MEX终结点的ABC分别给出了各自的定义。

• A - 类似于普通的endpoint地址。
• B - 基于http, https, tcp和icp协议的binding。例如，mexTcpBinding, mexNamePipeBinding, mexHttpBinding….
• C - IMetadataExchange接口。其实现由WCF自动提供。

以下是一个配置Mex endpoint的例子：

 

<system.serviceModel>

    <services>

      <service name="MyNamespace.MyService" behaviroConfiguration="MEX">

        <endpoint contract = "MyNamespace.IMyService"

                  binding  = "wsHttpBinding"

                  address  = "http://localhost:8000/MyService"

        />

        <endpoint contract = "IMetadataExchange"

                          binding  = "mexHttpBinding"

                          address  = "http://localhost:8000/MEX"

        />

      </service>

    </services>

    <behaviors>

        <serviceBehaviors>

            <behavior name="MEX">

                <serviceMetadata/>

            </behavior>

        </serviceBehaviors>

    </behaviors>

</system.serviceModel>

 

同样可以通过编程的方式来启动mex endpoint：

 

BindingElement bindingElement = new TcpTransportBindingElement();

CustomBinding binding = new CustomBinding(bindingElement);

Uri tcpBaseAddress = new Uri("net.tcp://localhost:9000");

ServiceHost host = new ServiceHost(typeof(MyService), tcpBaseAddress);

if(metadataBehavior == null)

{

    metadataBehavior = new ServiceMetadataBehavior();

    host.Description.Behaviors.Add(metadataBehavior);

}

host.AddServiceEndpoint(typeof(IMetadataExchange), binding, "MEX");

host.Open();

...            

host.Close();