如何:使用 UDDI 类别搜索解析服务终结点

目标

本部分演示如何使用 ESB Designer域特定语言 (DSL) 创建基于路线的路由名单,该名单使用通用说明、发现和集成 (UDDI) 3 解析程序通过类别搜索查找服务终结点。 在此方案中,服务终结点将是在 UDDI 中发布的文件终结点。

在本操作方法主题中,你将完成以下步骤:

  • 创建路线路由名单以解析服务终结点。

  • 配置路线,以使用 UDDI 3 解析程序将消息路由到服务终结点。

  • 使用路线测试客户端示例应用程序测试行程。

必备条件

本操作方法主题中的过程要求完成 开发活动的先决条件

步骤

创建行程模型

  1. 在 Visual Studio 中,打开 C:\HowTos\Patterns\Patterns.sln。

  2. 在“解决方案资源管理器”中,右键单击“行程库”项目,指向“添加”,然后单击“新建行程”。

  3. “添加新项”对话框中的“名称”框中键入 UDDI3CategorySearch,然后单击“添加”。

配置行程的属性

  1. 在 Visual Studio 中,单击 UDDI3CategorySearch.itinerary 的设计图面。 在 UDDI3CategorySearch 属性窗口中,配置以下属性:

    1. “模型导出程序 ”下拉列表中,单击“ XML 行程导出程序”。

    2. “扩展程序设置” 部分的 “行程 XML 文件 ”属性旁边,单击省略号按钮 (...) 。

    3. “选择 XML 文件”对话框中的“文件名”框中键入 C:\HowTos\Itineraries\UDDI3CategorySearch,然后单击“保存”。

      注意

      此步骤使你能够将行程作为 XML 导出到本地文件位置。 通过将行程导出到本地文件位置而不是行程数据库,可以使用 ESB 测试客户端应用程序来测试行程。 稍后将在此操作说明主题中完成此过程。

定义行程的结构

  1. 从“工具箱”中,将 On-Ramp 模型元素拖到设计图面。 在 OnRamp1 属性窗口中,配置以下属性:

    1. 单击 Name 属性,然后键入 ReceiveNAOrder

    2. “扩展程序 ”下拉列表中,单击“ On-Ramp ESB 扩展程序”。

    3. “BizTalk 应用程序 ”下拉列表中,单击“ Microsoft.Practices.ESB”。

    4. “接收端口 ”下拉列表中,单击“ OnRamp.行程”。

  2. 从“工具箱”中,将 “路线服务 ”模型元素拖到设计图面。 在“行程服务1”属性窗口中,配置以下属性:

    1. 单击 Name 属性,然后键入 CategoryRoute

    2. “行程服务扩展程序 ”下拉列表中,单击“ 消息传递扩展程序”。

    3. “容器 ”下拉列表中,展开“ ReceiveNAOrder”,然后单击“ 接收处理程序”。

    4. “服务名称”下拉列表中,单击“Microsoft.Practices.ESB.Services.Routing

  3. 右键单击 CategoryRoute 模型元素的 Resolver 集合,然后单击“添加新冲突解决程序”。 在 Resolver1 属性窗口中,配置以下属性:

    1. 单击 Name 属性,然后键入 CategorySearch

    2. “冲突解决程序实现” 下拉列表中,单击“ Uddi3 冲突解决程序扩展”。

    3. “解析程序名字对象 ”下拉列表中,单击“ UDDI3”。

    4. 单击 “类别搜索 ”属性,然后单击省略号按钮 (...) 。

    5. “名称值属性编辑器 ”对话框中,单击“ 添加”。

    6. 单击 Name 属性,然后键入 uddi:esb:biztalkapplication

    7. 单击 Value 属性,然后键入 GlobalBank.ESB

    8. “名称值属性编辑器 ”对话框中,单击“ 添加”。

    9. 单击 Name 属性,然后键入 uddi:esb:portname

    10. 单击 Value 属性,然后键入 OrderFileServicev3

    11. “名称值属性编辑器 ”对话框中,单击“ 添加”。

    12. 单击 Name 属性,然后键入 uddi:esb:version

    13. 单击 Value 属性,然后键入 1

    14. 单击“ 确定” 关闭“ 名称值属性编辑器 ”对话框。

  4. 右键单击 CategorySearch 冲突解决程序,然后单击“ 测试冲突解决程序配置”。

    注意

    验证“输出”窗口中显示的输出。

  5. 在“工具箱”中,单击“ 连接器”。 将连接从 ReceiveNAOrder 模型元素拖动到 CategoryRoute 模型元素。

  6. 从“工具箱”中,将 Off-Ramp 模型元素拖到设计图面上,然后将其置于 CategoryRoute 模型元素的右侧。 在 OffRamp1 属性窗口中,配置以下属性:

    1. 单击 Name 属性,然后键入 SendNAOrder

    2. “扩展程序 ”下拉列表中,单击“ 关闭渐变 ESB 扩展程序”。

    3. “BizTalk 应用程序 ”下拉列表中,单击“ GlobalBank.ESB”。

    4. “发送端口 ”下拉列表中,单击“ DynamicResolutionOneWay”。

  7. 从“工具箱”中,将 “路线服务 ”模型元素拖动到设计图面,然后将其放置在 CategoryRoute 模型元素和 SendNAOrder 模型元素之间。 在“行程服务1”属性窗口中,配置以下属性:

    1. 单击 Name 属性,然后键入 SendPortFilter

    2. “行程服务扩展程序 ”下拉列表中,单击“ 非斜坡扩展程序”。

    3. “Off-Ramp ”下拉列表中,展开“ SendNAOrder”,然后单击“ 发送处理程序”。

  8. 在“工具箱”中,单击“ 连接器”。 将连接从 CategoryRoute 模型元素拖动到 SendPortFilter 模型元素。

  9. 在“工具箱”中,单击“ 连接器”。 将连接从 SendPortFilter 模型元素拖动到 SendNAOrder 模型元素。

导出模型以用于路线测试客户端

  1. 在 Visual Studio 中,右键单击 UDDI3CategorySearch 路线的设计图面,然后单击“ 导出模型”。

    注意

    将在 Visual Studio 中打开行程的 XML 版本。

  2. 保存所有项目项目。

  3. 在 Windows 资源管理器中,浏览到 C:\HowTos\Itineraries,并注意创建行程 XML (UDDI3CategorySearch.xml) 。

测试行程

  1. 使用开发 活动的先决条件 (C:\HowTos\ESB.Itinerary.Test.exe - 快捷方式) 中创建的快捷方式打开路线测试客户端示例应用程序。

  2. 在“行程测试客户端”中,清除“使用 WCF 服务检查”框,然后单击“加载路线”。

  3. “打开路线文件 ”对话框中,浏览到 C:\HowTos\Itineraries。 选择 “UDDI3CategorySearch.xml”,然后单击“ 打开 ”以加载行程。

  4. 单击“ 确定 ”清除“ 行程加载成功 ”消息。

  5. 在“路线测试客户端”中,单击“ 加载消息 ”框旁边的省略号按钮 (...) 。

  6. “选择要加载的 XML 文档 ”对话框中,浏览到 C:\HowTos。 选择“NAOrderDoc.xml”,然后单击“ 打开 ”以加载测试消息。

  7. 单击“ 提交请求” 按钮。 测试完成后,单击“ 确定 ”关闭出现的确认。

  8. 在 Windows 资源管理器中,浏览到 C:\Projects\Microsoft.Practices.ESB\Source\Samples\DynamicResolution\Test\Filedrop\Out ,并验证 %MessageID%.xml 消息是否已写入目录。

其他资源

有关详细信息,请参阅下列相关主题: