使用 UDDI 的 Web 服务描述和发现（第一部分）[转自微软]

简介

uddi - web 服务的全球注册表

• 如何发现 web 服务？
• 如何按照某种合理的方式分类信息？
• 对本地化有什么影响？
• 对专用技术有什么影响？如何保障发现机制的互操作性？
• 当应用依赖于某项 web 服务时，如何在运行时与该发现机制进行交互？

工作原理

• “已经发布了哪些基于 wsdl 并是为指定行业建立的 web 服务接口？”
• “哪些公司已经为其中一个接口写好了实现？”
• “目前提供的 web 服务（以某种方式分类）有哪些？”
• “某个公司提供了哪些 web 服务？”
• “如果要使用某个公司的 web 服务，需要与谁联系？”
• “某个 web 服务的实现细节是什么？”

wsdl 和 uddi

用 uddi 进行注册

步骤 1：为 uddi 条目建立模型

1. 确定 web 服务实现所需使用的 tmodel（wsdl 文件）。
   与开发 com 组件类似，开发 web 服务时可以使用现有的接口，也可以使用自己设计的接口。如果 web 服务基于现有 wsdl，则需要确定该 wsdl 文件是否已经在 uddi 上注册。如果是，就需要记录其名称和 tmodelkey，这是注册 wsdl 文件时 uddi 所生成的 guid。
   另一方面，如果 web 服务所基于的 wsdl 文件尚未在 uddi 上注册，就需要准备创建一个新的 tmodel 来代表这个接口。此 tmodel 应具有统一资源标识符 (uri) 格式 (mycompany-com:samplewebservice-interface:v1) 的名称，并指向 wsdl 文件所在的位置。
   如果 web 服务是 microsoft® visual studio® .net 服务，则可以使用 .asmx 文件（也就是：<http://www.mycompany.com/samplewebservice.asmx?wsdl>）中的查询字符串来生成 wsdl 说明。但是，visual studio .net 生成的 wsdl 文件与调用 web 服务的访问点紧密耦合在一起，如果 web 服务接口有多个实现，访问点可能就不适用了。如果不希望 wsdl 文件有多个实现，这就不是问题。
2. 如果需要，可以用多种语言确定公司的名称和简介，以及公司 web 服务的主要联系方法。
   uddi 支持 xml:lang 名称空间，它允许公司用多种语言提供公司简介。另外，uddi 还允许列出联系方式，包括电子邮件、电话和地址信息。联系列表用于列出公司内与 web 服务相关的资源。例如，如果有人想要使用您的 web 服务，并需要联系相应的业务关系经理，应该联系谁？使用公司的 web 服务时，有关技术问题和谁联系？该联系人也应该列出。
3. 为公司确定适当的分类和标识。
   通过 microsoft uddi 节点 http://uddi.microsoft.com/default.aspx（英文）浏览当前支持的 uddi 分类法。当前支持的分类法有北美行业分类系统 (naics)、通用标准产品和服务代码 (unspsc)、iso 3166、标准行业分类 (sic) 和 geoweb 地理分类。请选择一种最适于您的公司的分类。
4. 确定公司通过 uddi 提供的 web 服务。
   下一步，确定公司要在公共 uddi 节点上注册的 web 服务。这项服务有多个访问点吗？是否要给使用此 web 服务的客户提供其他必需的参数和信息？
   注意，在 uddi 上注册 web 服务并不意味着每个人都有访问权。可以为 uddi 注册表条目依次设置安全、授权和身份验证。仅知道 web 服务的存在并不意味着就可以实际调用该服务。在授权访问 web 服务之前，公司之间通常需要进行一些额外的交流。
5. 为服务确定适当的分类。
   如同可以将公司分类一样，也可以将 web 服务分类。因此，公司可能按商业级别被分类为 naics: software publisher (51121)，而其旅馆预约 web 服务的服务级别可能被分类为 naics: hotels and motels (72111)。

步骤 2：注册 uddi 条目

注意：您可以在模拟环境中练习注册过程，地址是 http://test.uddi.microsoft.com/default.aspx（英文），这是实际投入使用节点的复本。这对于在正式使用之前熟悉注册过程很有帮助。

使用 microsoft 的 web 用户界面

1. 在注册服务之前，确保将 wsdl 文件注册为 tmodel，因为在以后的过程中会需要 tmodel。
2. 将 wsdl 文档注册为 tmodel 时，应该使用“uddi 类型分类法”对 tmodel 分类。至少应将 wsdl 分类为“specification for a web service”(wsdlspec)。
   使用这种分类方法，可以确保 tmodel 的分类符合“using wsdl in a uddi registry”最佳实践文档（英文）的原则。因为 tmodel 能包含对 wsdl 文件以外的文档的引用，所以给 tmodel 提供一些分类是很重要的。很多工具（例如 visual studio .net）靠这些分类来缩小查询的结果集。
3. 将 wsdl 接口注册为 tmodel 后，需要给公司业务添加相应的联系信息以及分类信息。只要您认为合适，可以添加任意多的分类。
4. 继续添加要通过 uddi 公开的 web 服务。因为服务可以有多种实现，所以需要给每个添加的服务添加一个绑定。对于每个绑定，需要提供 web 服务的访问点，即 <http://www.mycompany.com/samplewebservice.asmx>。
5. 每个绑定都需要为所支持的接口创建一个引用。microsoft ui 将这些作为“规范签名”来调用。规范签名就是包含 wsdl 接口的 tmodel。microsoft ui 会提供一个屏幕，允许您基于其 urn 来搜索 tmodel。这个 tmodel 可以是在步骤 1 中注册的，也可以是别人注册的 wsdl 文件的 tmodel。
6. 最后，系统会显示选项，要求提供一个关于特定 web 服务的概述文档的 http 地址，以及任何相关的实例参数。

使用 microsoft uddi .net sdk 编程进行注册

using microsoft.uddi;using microsoft.uddi.binding;using microsoft.uddi.business;using microsoft.uddi.service;using microsoft.uddi.servicetype;

// 您最好先运行这个程序，在 https://test.uddi.microsoft.com/publish// 上进行注册测试publish.url = "https://uddi.microsoft.com/publish";publish.user = "您的帐户";publish.password = "************";

// 创建 tmodelsavetmodel stm = new savetmodel();stm.tmodels.add();stm.tmodels[0].name = "此处插入 urn";stm.tmodels[0].descriptions.add("zh","此处插入说明");stm.tmodels[0].overviewdoc.overviewurl = "此处插入 wsdl 的 url";// 下一行是给 tmodel 正确分类所必需的stm.tmodels[0].categorybag.add ( "uddi-org:types","wsdlspec","uuid:c1acf26d-9672-4404-9d70-39b756e62ab4" );string stmodelkey = "";// 发送到 udditry{   tmodeldetail tmd = stm.send();   stmodelkey = tmd.tmodels[0].tmodelkey;         }catch (uddiexception ue){   console.writeline ( ue.message );   return;}catch (exception e){   console.writeline ( e.message );   return;}

// 创建公司savebusiness sb = new savebusiness();sb.businessentities.add();sb.businessentities[0].name = "此处插入公司名称";sb.businessentities[0].descriptions.add("zh","此处插入说明");// 创建公司服务sb.businessentities[0].businessservices.add();sb.businessentities[0].businessservices[0].name = "此处插入服务名称";sb.businessentities[0].businessservices[0].descriptions.add("zh","此处插入服务说明");// 创建绑定模板sb.businessentities[0].businessservices[0].bindingtemplates.add();sb.businessentities[0].businessservices[0].bindingtemplates[0].description.add("zh","此处插入绑定说明");sb.businessentities[0].businessservices[0].bindingtemplates[0].accesspoint.text = "此处插入访问点";sb.businessentities[0].businessservices[0].bindingtemplates[0].accesspoint.urltype = microsoft.uddi.api.urltypeenum.http;// 创建 tmodel 实例信息sb.businessentities[0].businessservices[0].bindingtemplates[0].tmodelinstancedetail.tmodelinstanceinfos.add();sb.businessentities[0].businessservices[0].bindingtemplates[0].tmodelinstancedetail.tmodelinstanceinfos[0].descriptions.add("zh","此处插入说明");// 使用上面的 tmodelkey 字符串sb.businessentities[0].businessservices[0].bindingtemplates[0].tmodelinstancedetail.tmodelinstanceinfos[0].tmodelkey = stmodelkey;// 发送到 udditry{   businessdetail bd = sb.send();   // 显示 xml   console.writeline ( bd );}catch (uddiexception ue){   console.writeline ( ue.message );   return;}catch (exception e){   console.writeline ( e.message );   return;}

步骤 3：在 uddi 中搜索条目

总结