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

UDP 激活

· 52CE 我爱测

此示例基于传输:UDP示例。 它扩展传输:UDP示例,以使用 Windows 进程激活服务 (WAS) 支持进程激活。

此示例基于传输:UDP示例。 它扩展传输:UDP示例,以使用 Windows 进程激活服务 (WAS) 支持进程激活。

该示例主要由三个部分组成:

  • UDP 协议激活器,代表要激活的应用程序接收 UDP 消息的独立进程。

  • 使用 UDP 自定义传输发送消息的客户端。

  • 通过 UDP 自定义传输接收消息的服务(承载于 WAS 激活的工作进程中)。

UDP 协议激活器

UDP 协议激活器是 WCF 客户端和 WCF 服务之间的桥梁。 该激活器通过 UDP 协议在传输层提供数据通信。 它主要有两个功能:

  • WAS 侦听器适配器 (LA),它与 WAS 协作激活进程以响应传入消息。

  • UDP 协议侦听器,它代表要激活的应用程序接受 UDP 消息。

激活器必须作为独立的程序在服务器计算机上运行。 通常,WAS 侦听器适配器(如 NetTcpActivator 和 NetPipeActivator)在长时间运行的 Windows 服务中实现。 但是,为了简单明确起见,此示例将协议激活器作为独立的应用程序实现。

WAS 侦听器适配器

UDP 的 WAS 侦听器适配器是在 UdpListenerAdapter 类中实现的。 该适配器是与 WAS 交互以针对 UDP 协议执行应用程序激活的模块。 这一过程是通过调用下列 Webhost API 实现的:

  • WebhostRegisterProtocol

  • WebhostUnregisterProtocol

  • WebhostOpenListenerChannelInstance

  • WebhostCloseAllListenerChannelInstances

最初调用 WebhostRegisterProtocol 之后,侦听器适配器将为 applicationHost.config(位于 %windir%\system32\inetsrv)中注册的所有应用程序接收来自 WAS 的回调 ApplicationCreated。 在此示例中,我们仅在启用 UDP 协议(协议 ID 为“net.udp”时)的情况下处理应用程序。 如果其他实现对应用程序的动态配置更改(例如,应用程序从禁用转换为启用)作出响应,这些实现可能会以不同的方式处理上述情况。

当收到回调 ConfigManagerInitializationCompleted 时,则表示 WAS 已经完成协议初始化的所有通知。 此时,侦听器适配器已准备处理激活请求。

当首次传入针对某个应用程序的新请求时,侦听器适配器会将 WebhostOpenListenerChannelInstance 调入 WAS,从而启动工作进程(如果尚未启动)。 然后加载协议处理程序,并可以启动侦听器适配器与虚拟应用程序之间的通信。

在中 %SystemRoot%\System32\inetsrv\ApplicationHost.config 中注册的侦听器适配器 <listenerAdapters> 部分如下所示:

<add name="net.udp" identity="S-1-5-21-2127521184-1604012920-1887927527-387045" />  

协议侦听器

UDP 协议侦听器是协议激活器内部的模块,它代表虚拟应用程序在 UDP 终结点进行侦听。 它在 UdpSocketListener 类中实现。 终结点表示为 IPEndpoint,其端口号从站点协议的绑定中提取。

控制服务

在此示例中,我们可以使用 WCF 激活器与 WAS 工作进程之间进行通信。 驻留在激活器中的服务称为“控制服务”。

协议处理程序

侦听器适配器调用 WebhostOpenListenerChannelInstance 之后,WAS 进程管理器将启动工作进程(如果尚未启动)。 工作进程内部的应用程序管理器随后使用该 ListenerChannelId 的请求加载 UDP 进程协议处理程序 (PPH)。 PPH 反过来调用IAdphManager。StartAppDomainProtocolListenerChannel 若要启动 UDP AppDomain 协议处理程序 (ADPH)。

HostedUDPTransportConfiguration

该信息按如下方式在 Web.config 中注册:

<serviceHostingEnvironment>  
<add name="net.udp" transportConfigurationType="Microsoft.ServiceModel.Samples.Hosting.HostedUdpTransportConfiguration, UdpActivation, Version=1.0.0.0, Culture=neutral, PublicKeyToken=6fa904d2da1848d6" />  
</serviceHostingEnvironment>  

此示例的特殊设置

此示例只能在 Windows Vista、Windows Server 2008 或 Windows 7 上生成和运行。 若要运行此示例,必须首先正确设置所有组件。 使用下列步骤安装该示例。

设置此示例
  1. 安装 ASP.NET 4.0 使用以下命令。

    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
    
  2. 在 Windows Vista 上生成项目。 编译后,该项目还将在后期生成阶段执行下列操作:

    • 将 UDP 绑定安装到“默认网站”站点。

    • 创建虚拟应用程序“ServiceModelSamples”,指向物理路径“%SystemDrive%\inetpub\wwwroot\servicemodelsamples”。

    • 这还为该虚拟应用程序启用“net.udp”协议。

  3. 启动用户接口应用程序“WasNetActivator.exe”。 单击安装程序选项卡上,选中以下复选框,然后单击安装安装它们:

    • UDP 侦听器适配器

    • UDP 协议处理程序

  4. 单击激活的用户界面应用程序"WasNetActivator.exe"选项卡。 单击启动按钮以启动侦听器适配器。 现在即可运行程序。

    NOTE 完成此示例后,必须运行 Cleanup.bat,从“默认网站”中移除 net.udp 绑定。

示例用法

编译后,生成四个不同的二进制文件:

  • Client.exe:客户端代码中。 App.config 编译到客户端配置文件 Client.exe.config 中。

  • UDPActivation.dll:包含所有主要 UDP 实现的库。

  • Service.dll:服务代码中。 此代码被复制到虚拟应用程序 ServiceModelSamples 的 \bin 目录。 服务文件是 Service.svc,配置文件是 Web.config。编译后,这两个文件将被复制到以下位置:%SystemDrive%\Inetpub\wwwroot\ServiceModelSamples。

  • WasNetActivator:UDP 激活器程序。

  • 确保所有的必需部分均已正确安装。 下列步骤说明如何运行该示例:

  1. 确保已启动下面的 Windows 服务:

    • Windows 进程激活服务 (WAS)。

    • Internet 信息服务 (IIS):W3SVC.

  2. 然后启动激活器 WasNetActivator.exe。 下激活选项卡上的唯一协议UDP,在下拉列表中选择。 单击启动按钮启动激活器。

  3. 启动激活器后,可以通过在命令窗口中运行 Client.exe 来运行客户端代码。 下面是示例输出:

    Testing Udp Activation.  
    Start the status service.  
    Sending UDP datagrams.  
    Type a word that you want to say to the server: Hello, world!  
        Sending datagram: Hello, world![0]  
        Sending datagram: Hello, world![1]  
        Sending datagram: Hello, world![2]  
        Sending datagram: Hello, world![3]  
        Sending datagram: Hello, world![4]  
    Calling UDP duplex contract (ICalculatorContract).  
        0 + 0 = 0  
        1 + 2 = 3  
        2 + 4 = 6  
        3 + 6 = 9  
        4 + 8 = 12  
    Getting status and dump server traces:  
        Operation 'Hello' is called: Hello, world![0]  
        Operation 'Hello' is called: Hello, world![1]  
        Operation 'Hello' is called: Hello, world![2]  
        Operation 'Hello' is called: Hello, world![3]  
        Operation 'Hello' is called: Hello, world![4]  
        Operation 'Add' is called: 0 + 0  
        Operation 'Add' is called: 1 + 2  
        Operation 'Add' is called: 2 + 4  
        Operation 'Add' is called: 3 + 6  
        Operation 'Add' is called: 4 + 8  
    Press <ENTER> to complete test.  
    

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\Transport\UdpActivation

历史资料。此文对应 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(示例代码)

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

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