通过

HTTP 适配器（BizTalk Server 示例）

  • 项目

HTTP 适配器示例演示如何实现BizTalk Server中使用的请求/响应和请求/响应通信范例。

本示例所在的位置

<Samples Path>\AdaptersDevelopment\HttpAdapter\

下表显示了本示例中的文件及其用途说明：

文件 说明
\Design-Time\Adapter Management 包含实现此适配器的设计时部分的项目。
\Run-Time\HttpReceive 包含实现请求/响应适配器通信模式的项目。 这是一个独立的接收器。
\Run-Time\HttpSend 包含实现要求/响应适配器通信模式的项目。

如何使用本示例

此示例旨在用作开发自定义适配器的框架。 在某些情况下，BizTalk Server可能需要将消息传输到特定的自定义应用程序，或使用不存在本机适配器的协议。 第三方公司编写了支持其他协议的适配器。 您可能要在决定编写某一自定义适配器前确定是否存在可用于您的协议的适配器。 如果您无法找到支持您的通信要求的适配器，则可以开发自定义适配器。

编写自定义适配器可能颇具挑战性。 为了简化此过程，Microsoft 开发了称作适配器框架的基础框架。 您可以将此框架以及 BizTalk Server SDK 中的示例适配器源代码为基础进行开发。 有关自定义适配器和适配器框架的详细信息，请参阅本文档末尾的 “另请参阅” 部分。

生成并初始化示例适配器

重要

如果是在 64 位计算机上安装 BizTalk 或安装位置已修改，则需要相应修改 OutboundAssemblyPath、InboundAssemblyPath、AdapterMgmtAssemblyPath。

生成和初始化 HTTP 适配器示例

  1. 在命令窗口中，导航到下面的文件夹：

    <示例路径>\AdaptersDevelopment\HttpAdapter

  2. 运行 Setup.bat 文件，该文件将执行以下操作：

    • 编译 HTTPAdapter 及其所有依存关系。

    • 创建由适配器的接收方使用的 Internet 信息服务 (IIS) 应用程序。

    在 IIS 7.0 上，必须确保运行此 IIS 应用程序的应用程序池的标识是以下组的成员：

  • BizTalk Isolated Host Users 组。

  • IIS_WPG 组。

  • 在 IIS 7.0 上，必须迁移应用程序才能使用集成 .NET 模式。 可以在命令行窗口中使用以下命令迁移应用程序配置，包括 httpHandlers> 配置部分的内容<， (窗口必须以管理员) 身份运行：

    %systemroot%\system32\inetsrv\APPCMD.EXE migrate config "Default Web Site/HttpReceive"

  • 在迁移应用程序后，它既可以在经典模式下也可以在集成 .NET 模式下运行，还可以在下级平台上运行。

注意

在尝试运行本示例前，你应确认在生成和初始化过程中未报告任何错误。

注意

如果选择在不运行 Setup.bat 文件的情况下打开并生成本示例中的项目，则必须先使用 .NET Framework 强名称实用工具 (sn.exe) 创建一个强名称密钥对。 使用该密钥对可以对生成的程序集签名。

注意

若要撤销 Setup.bat 所做的更改，请运行 Cleanup.bat。 第二次运行 Setup.bat 之前，必须运行 Cleanup.bat。

注册示例适配器

注册 HTTP 适配器示例

  1. 在 Windows 资源管理器中，导航到BizTalk Server的安装驱动器，然后导航到<“示例路径>\适配器”“开发”\HTTPAdapter。

  2. 若要将示例适配器添加到注册表，请双击“ HTTP”。NET.reg.

    注意

    HTTP。NET.reg 包含指向 BizTalk Server 安装目录的硬编码路径。 如果未在默认位置安装BizTalk Server，或者从以前版本的 BizTalk Server 升级了BizTalk Server安装，则必须修改文件 HTTP。具有适当路径的 NET.reg。 更新与“OutboundAssemblyPath”和“AdapterMgmtAssemblyPath”值相关联的路径，使其指向指定文件的正确位置。

    重要

    如果在 64 位计算机上安装 BizTalk，请将 HKEY_CLASSES_ROOT\CLSID\ 注册表项的所有实例更改为 HTTP 中的 HKEY_CLASSES_ROOT\Wow6432Node\CLSID\ 。NET.reg 注册表文件。

  3. 在 “注册表编辑器 ”对话框中，单击“ 是 ”将示例适配器添加到注册表，然后单击“ 确定”。

  4. 若要关闭 Windows 资源管理器，请在“ 文件 ”菜单上单击“ 关闭”。

安装示例适配器

安装 HTTP 适配器示例

  1. 单击“开始”菜单，依次选择“所有程序”、“Microsoft BizTalk Server 20xx”、“BizTalk Server管理”。

  2. 在 BizTalk Server 管理控制台中，展开“BizTalk Server管理”树，然后展开 BizTalk 组树，然后展开“平台设置”树。

  3. 右键单击“ 适配器”，单击“ 新建”，然后单击“ 适配器”。

  4. 在“ 适配器属性 ”对话框中，执行以下操作。

    使用此选项 要执行此操作
    名称 键入 “HTTP.NET”。
    适配器 从下拉列表中选择“ HTTP.NET ”。
    说明 键入 “示例 HTTP.NET 适配器”。

  5. 单击 “确定” 。

  6. 现在该适配器显示在 BizTalk 管理控制台右侧窗口中的适配器列表中。

停止并重新启动主机实例

停止并重新启动 HTTP 适配器示例的主机实例

  1. 单击“开始”菜单，依次选择“所有程序”、“Microsoft BizTalk Server 20xx”和“BizTalk Server管理”。

  2. 在BizTalk Server管理控制台中，展开“BizTalk Server管理”树，然后展开“平台设置”，然后单击“主机实例”。

  3. 在结果窗格中，右键单击通常 (主机实例，计算机名称) ，然后单击“ 停止”。

    主机实例的状态更改为 “已停止”。

  4. 在结果窗格中，右键单击主机实例，然后单击“ 启动”。

    现在，HTTP.NET 适配器已经准备就绪，可供您的应用程序使用了。 配置适配器时， 虚拟目录 传输属性的格式为：/httpreceive/httpreceive.aspx？optionalQueryString。

注释

HTTP.NET 适配器使用 Samples Path>\AdaptersDevelopment\BaseAdapter\v1.0.中<提供的 BaseAdapter 类。2\. BaseAdapter 项目中提供的类可以加快适配器的开发速度。 请参考 BaseAdapter 代码注释了解所提供的类的详细信息。

另请参阅

注册适配器
适配器示例 - 用法
开发自定义适配器
适配器框架概述
使用适配器框架工具
开发接收适配器
开发发送适配器
如何部署自定义适配器
设计适配器的提示
适配器设计时配置