大网数据广告活动
.NET 与 C# 开发

操作格式化程序和操作选择器

· 52CE 我爱测

此示例演示如何使用 Windows Communication Foundation (WCF) 扩展性点以允许消息数据中格式不同于 WCF 的需要。 默认情况下,WCF 格式化程序要求下包含方法参数soap:body元素。 但是,此示例演示如何实现一个自定义操作格式化程序,用于分析 HTTP GET 查询字符串中的参数数据并使用该数据调用方法。

此示例演示如何使用 Windows Communication Foundation (WCF) 扩展性点以允许消息数据中格式不同于 WCF 的需要。 默认情况下,WCF 格式化程序要求下包含方法参数soap:body元素。 但是,此示例演示如何实现一个自定义操作格式化程序,用于分析 HTTP GET 查询字符串中的参数数据并使用该数据调用方法。

该示例基于Getting Started,它可以实现ICalculator服务协定。 它演示如何更改 Add、Subtract、Multiply 和 Divide 消息,以便对客户端到服务器请求使用 HTTP GET,对服务器到客户端响应使用带有 POX 消息的 HTTP POST。

为此,此示例提供了以下功能:

Note: 本主题的最后介绍了此示例的设置过程和生成说明。

主要概念

QueryStringFormatter -操作格式化程序是负责将消息转换为一个参数对象数组和一条消息到参数对象的数组的 WCF 中的组件。 这在客户端是使用 xref:System.ServiceModel.Dispatcher.IClientMessageFormatter 接口完成的,在服务器上是使用 xref:System.ServiceModel.Dispatcher.IDispatchMessageFormatter 接口完成的。 通过这些接口,用户可以从 Serialize 和 Deserialize 方法获得请求和响应消息。

在此示例中,QueryStringFormatter 同时实现了这两个接口,并且在客户端和服务器上均已实现。

请求:

响应:

  • 在此示例中,HTTP GET 只用于请求。 该格式化程序将响应的发送委托给本来用于生成 XML 消息的原始格式化程序。 此示例的目的之一是演示如何实现此类委托格式化程序。

UriPathSuffixOperationSelector 类

用户可以通过 xref:System.ServiceModel.Dispatcher.IDispatchOperationSelector 接口实现自己的逻辑,决定应为哪个操作调度特定的消息。

在此示例中,必须在服务器上实现 UriPathSuffixOperationSelector 以选择合适的操作,因为操作名称包含在 HTTP GET URI 中,而不是包含在消息的操作标头中。 此示例设置为只允许不区分大小写的操作名称。

SelectOperation 方法采用传入消息,并在其消息属性中查找 Via URI。 它从 URI 中提取操作名称后缀,查看内部表以获取应将该消息调度给的操作名称,并返回该操作名称。

EnableHttpGetRequestsBehavior 类

UriPathSuffixOperationSelector 组件可以通过编程方式或者通过终结点行为进行设置。 此示例实现了 EnableHttpGetRequestsBehavior 行为,这是在服务的应用程序配置文件中指定的。

在服务器上:

xref:System.ServiceModel.Dispatcher.DispatchRuntime.OperationSelector* 设置为 xref:System.ServiceModel.Dispatcher.IDispatchOperationSelector 实现。

默认情况下,WCF 使用精确匹配的地址筛选器。 传入消息中的 URI 包含一个操作名称后缀,后跟包含参数数据的查询字符串,因此终结点行为还将地址筛选器更改为前缀匹配筛选器。 它使用 WCFxref:System.ServiceModel.Dispatcher.PrefixEndpointAddressMessageFilter实现此目的。

安装操作格式化程序

指定格式化程序的操作行为是唯一的。 默认情况下始终为每个操作实现这样一个行为,以创建必要的操作格式化程序。 但是,这些行为看起来就像另一个操作行为;它们不能通过其他任何属性进行标识。 若要安装替换行为,该实现必须查找特定格式化程序行为,安装 WCF 类型加载程序默认情况下并将其替换为或添加兼容行为的默认行为之后运行。

这些操作格式化程序行为可以在调用 xref:System.ServiceModel.Channels.CommunicationObject.Open*?displayProperty=nameWithType 之前通过编程方式进行设置,或者通过指定一个在默认行为之后执行的操作行为来进行设置。 但是,通过终结点行为(并进而通过配置)并不能轻松完成设置,因为行为模式不允许用一个行为替换另一个行为,或者通过其他方式修改说明树。

在客户端上:

必须实现 xref:System.ServiceModel.Dispatcher.IClientMessageFormatter 实现,以使其能够将请求转换为 HTTP GET 请求,并委托原始格式化程序做出响应。 这是通过调用 EnableHttpGetRequestsBehavior.ReplaceFormatterBehavior 帮助器方法实现的。

这必须在调用 CreateChannel 之前完成。

void ReplaceFormatterBehavior(OperationDescription operationDescription, EndpointAddress address)  
{  
    // Remove the DataContract behavior if it is present.  
    IOperationBehavior formatterBehavior = operationDescription.Behaviors.Remove<DataContractSerializerOperationBehavior>();  
    if (formatterBehavior == null)  
    {  
        // Remove the XmlSerializer behavior if it is present.  
        formatterBehavior = operationDescription.Behaviors.Remove<XmlSerializerOperationBehavior>();  
        ...  
    }  
  
    // Remember what the innerFormatterBehavior was.  
    DelegatingFormatterBehavior delegatingFormatterBehavior = new DelegatingFormatterBehavior(address);  
    delegatingFormatterBehavior.InnerFormatterBehavior = formatterBehavior;  
   operationDescription.Behaviors.Add(delegatingFormatterBehavior);  
}  

在服务器上:

用户体验

在服务器上:

  • 服务器 ICalculator 实现不需要更改。

  • 服务的 App.config 必须使用自定义 POX 绑定,该绑定将 messageVersion 元素的 textMessageEncoding 属性设置为 None。

    <bindings>  
      <customBinding>  
        <binding name="poxBinding">  
          <textMessageEncoding messageVersion="None" />  
          <httpTransport />  
        </binding>  
      </customBinding>  
    </bindings>  
    
  • 服务的 App.config 还必须指定自定义 EnableHttpGetRequestsBehavior(通过将其添加到行为扩展部分并使用它来实现)。

    <behaviors>  
      <endpointBehaviors>  
        <behavior name="enableHttpGetRequestsBehavior">  
          <enableHttpGetRequests />  
        </behavior>  
      </endpointBehaviors>  
    </behaviors>  
    
    <extensions>  
      <behaviorExtensions>  
        <!-- Enabling HTTP GET requests: Behavior Extension -->  
        <add   
          name="enableHttpGetRequests"           type="Microsoft.ServiceModel.Samples.EnableHttpGetRequestsBehaviorElement, QueryStringFormatter, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />  
      </behaviorExtensions>  
    </extensions>  
    
  • 在调用 xref:System.ServiceModel.Channels.CommunicationObject.Open* 之前添加操作格式化程序。

在客户端上:

  • 客户端实现不需要更改。

  • 客户端 App.config 必须使用自定义 POX 绑定,该绑定将 messageVersion 元素的 textMessageEncoding 属性设置为 None。 与服务的一个区别在于,客户端必须允许手动寻址,以便修改传出“收件人”地址。

    <bindings>  
      <customBinding>  
        <binding name="poxBinding">  
          <textMessageEncoding messageVersion="None" />  
          <httpTransport manualAddressing="True" />  
        </binding>  
      </customBinding>  
    </bindings>  
    
  • 客户端 App.config 必须指定与服务器相同的自定义 EnableHttpGetRequestsBehavior。

  • 在调用 xref:System.ServiceModel.ChannelFactory`1.CreateChannel 之前添加操作格式化程序。

运行示例时,操作请求和响应将显示在客户端控制台窗口中。 所有四个操作(Add、Subtract、Multiply 和 Divide)都必须成功。

Important: 您的计算机上可能已安装这些示例。 在继续操作之前,请先检查以下(默认)目录:

<InstallDrive>:\WF_WCF_Samples

如果此目录不存在,请转到Windows Communication Foundation (WCF) 和.NET Framework 4 的 Windows Workflow Foundation (WF) 示例若要下载所有 Windows Communication Foundation (WCF) 和WF示例。 此示例位于以下目录:

<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Formatters\QueryStringFormatter

设置、生成和运行示例
  1. 请确保您具有执行的 Windows Communication Foundation 示例的一次性安装过程。

  2. 若要生成解决方案,请按照中的说明生成 Windows Communication Foundation 示例。

  3. 若要在单或跨计算机配置中运行示例,请按照中的说明运行 Windows Communication Foundation 示例。

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。