UDDIPublish 工具参考

可以从命令行使用 UDDIPublish 工具来将 Web Service 作为企业实体或服务发布至 UDDI 注册中心。可以发布到公用或专用注册中心。一旦设置了命令行,就可以使用以下语法和自变量来运行此工具:

语法

要发布企业实体:

要发布企业服务:

自变量

企业实体

必需自变量:

-business
指定将在注册中心中创建新的企业实体。
-businessName <name>
指定新企业的易懂名称。如果 <name> 包含任何空格,则将其括在引号中。

可选自变量:

-inquiryURL<inquiry API URL>
设置 UDDI 注册中心的查询 API 的 URL。如果没有指定此自变量,则缺省值是 http://localhost:6080/uddisoap/inquiryapi。
注意:如果正在使用具有缺省设置的单元测试 UDDI 注册中心,则将 -inquiryURL 设置为 http://localhost:9080/uddisoap/inquiryapi。
-publishURL<publish API URL>
设置 UDDI 注册中心的发布 API 的 URL。如果没有指定此自变量,则缺省值是 https://localhost:6443/uddisoap/publishapi。
注意:如果正在使用具有缺省设置的单元测试 UDDI 注册中心,则将 -publishURL 设置为 http://localhost:9080/uddisoap/publishapi。
-businessKey <key>
指定最初发布企业时由 UDDI 注册中心为企业生成的唯一企业密钥。如果对注册中心中多次出现其名称的企业尝试取消发布,则此选项就会成为必需选项。如果返回了失败消息,指出具有指定企业名的企业数目以及这些企业各自的唯一密钥,您应该用此自变量重试命令。
-businessDescription <description>
指定新企业的文本描述。如果 <description> 包含任何空格,则将其括在引号中。
-username <name>
指定要传递至专用 UDDI 注册中心的用户名。
-password <password>
指定所提供的用户名的 UDDI 注册中心密码。
-uddiprops <location of properties file>
指定一个常规 Java™ 属性文件,它包含由等号分隔的名称-值对。请参阅附加属性
-verbose
在工具运行时显示额外的信息。
-help
显示帮助信息。
 

企业服务

必需自变量:

-service
指定将在注册中心中创建新的企业服务。
-serviceName <name>
指定新企业服务的易懂名称。如果 <name> 包含任何空格,则将其括在引号中。
-businessName <name>
指定将要包含新服务的企业实体的易懂名称。如果 <name> 包含任何空格,则将其括在引号中。
-wsdlLocation <URI of WSDL describing new service>
指定一个 URI,它指向一个 WSDL 文档,其中包含对服务的描述。此 URI 设置为新服务关联的 tModel 中 <overviewURL> 元素的值,tModel 是由此工具自动创建的。
-accessPoint <URL of where the new service exists on the network>
指定新服务的网络访问点。此 URL 设置为新服务关联的绑定模板中 <accessPoint> 元素的值,绑定模板是由此工具自动创建的。提供的访问点需要具有服务 WSDL 文档中的 <port> 定义所指定的那个地址。

可选自变量:

-inquiryURL <inquiry API URL>
设置 UDDI 注册中心的查询 URL。如果没有指定此自变量,则缺省值是 http://localhost:6080/uddisoap/inquiryapi。
注意:如果正在使用具有缺省设置的单元测试 UDDI,则将 -inquiryURL 设置为 http://localhost:9080/uddisoap/inquiryapi。
-publishURL <publish API URL>
设置 UDDI 注册中心的发布 URL。如果没有指定此自变量,则缺省值是 https://localhost:6443/uddisoap/publishapi。
注意:如果正在使用具有缺省设置的单元测试 UDDI,则将 -publishURL 设置为 http://localhost:9080/uddisoap/publishapi。
-businessKey <key>
指定企业实体(它包含要删除的服务)的唯一企业密钥。如果对某个企业服务尝试取消发布,而该企业服务属于在注册中心中具有多个实例的命名服务,则此选项就会成为必需选项。在那种情况下,只有企业名不足以标识容器企业。将返回失败消息,该消息指出了具有指定企业实体名的企业数目以及这些企业各自的唯一密钥。您应该用此自变量重试命令。
-serviceKey <key>
指定最初发布服务时由 UDDI 注册中心为服务生成的唯一服务密钥。如果对注册中心中多次出现其名称的企业服务尝试取消发布,则此选项就会成为必需选项。如果是这种情况,则会返回失败消息,该消息指出了具有指定服务名的企业服务数目以及这些企业各自的唯一密钥。您应该用此自变量重试命令。
-serviceDescription <description>
指定新企业服务的文本描述。如果 <description> 包含任何空格,则将其括在引号中。
-username <name>
指定要传递至专用 UDDI 注册中心的用户名。
-password <password>
指定所提供的用户名的 UDDI 注册中心密码。
-uddiprops <location of properties file>
指定一个常规 Java 属性文件,它包含由等号分隔的名称-值对。请参阅附加属性
-verbose
在工具运行时显示额外的信息。
-help
显示帮助信息。

附加属性

借助 UDDIPublish 的 -uddiprops 自变量,可以指定包含附加输入信息的 Java 属性文件的位置。在注册中心中,企业和服务可以与这个附加的分类信息相关联,以便顺利地执行发现过程。可以将此信息以键引用的形式添加至已发布的项的类别包结构。类别包可以包含许多键引用,每个键引用都包含一个类别的名称和值,被发布项就属于这个类别。

UDDIPublish 使用下列属性:

属性 用途
wsdk.uddi.publish.url 覆盖远程 UDDI 注册中心的发布 API 的 URL。除非设置此属性,否则此工具将发布至专用注册中心。
wsdk.uddi.inquiry.url 覆盖远程 UDDI 注册中心的查询 API 的 URL。除非设置此属性,否则此工具将把查询发送至专用注册中心。
wsdk.uddi.publish.bs.keyref.name.<id> 键引用结构的名称部分。属性名的 <id> 部分就是将文件中旨在应用于特定键引用的不同属性条目链接到一起的部分。<id> 可以是任何字符串,它不包含可以解释为属性定界符的字符。
wsdk.uddi.publish.bs.keyref.value.<id> 键引用结构的值部分。属性名的 <id> 部分就是将文件中旨在应用于特定键引用的不同属性条目链接到一起的部分。<id> 可以是任何字符串,它不包含可以解释为属性定界符的字符。
wsdk.uddi.publish.bs.keyref.tmodelkey.<id> 键引用结构的可选 tModel 键。此属性的值应该是目标目录中的某个 tModel 文档的 UUID,该文档包含相应的键引用所支持的分类规范。属性名的 <id> 部分就是将文件中旨在应用于特定键引用的不同属性条目链接到一起的部分。<id> 可以是任何字符串,它不包含可以解释为属性定界符的字符。

可以将属性文件 <WS-install-dir>\wstools\eclipse\plugins\com.ibm.etools.webservice.was.creation.core_5.1.0\properties\speedstart.properties 与 UDDIPublish 配合使用来在作为 IBM® Speed Start 程序一部分的公用 IBM 测试注册中心中创建企业和服务并对它们进行分类。下面的内容例示了该文件:

# Properties specific to IBM Speed Start
# URLs pointing to IBM test registry
wsdk.uddi.publish.url=https://uddi.ibm.com/testregistry/publishapi
wsdk.uddi.inquiry.url=http://uddi.ibm.com/testregistry/inquiryapi

# Added to category bags belonging to published services
wsdk.uddi.publish.bs.keyref.name.1=Web service information for the developerWorks Web services community
wsdk.uddi.publish.bs.keyref.value.1=General
wsdk.uddi.publish.bs.keyref.tmodelkey.1=UUID:8F497C50-EB05-11D6-B618-000629DC0A53
wsdk.uddi.publish.bs.keyref.name.2=Web service information for the developerWorks Speed Start community
wsdk.uddi.publish.bs.keyref.value.2=Speed Start
wsdk.uddi.publish.bs.keyref.tmodelkey.2=UUID:8F497C50-EB05-11D6-B618-000629DC0A53

# Added to category bags belonging to published business
wsdk.uddi.publish.be.keyref.name.1=Web service information for the developerWorks Web services community
wsdk.uddi.publish.be.keyref.value.1=General
wsdk.uddi.publish.be.keyref.tmodelkey.1=UUID:8F497C50-EB05-11D6-B618-000629DC0A53
wsdk.uddi.publish.be.keyref.name.2=Web service information for the developerWorks Speed Start community
wsdk.uddi.publish.be.keyref.value.2=Speed Start
wsdk.uddi.publish.be.keyref.tmodelkey.2=UUID:8F497C50-EB05-11D6-B618-000629DC0A53

可以将属性文件 <WS-install-dir>\wstools\eclipse\plugins\com.ibm.etools.webservice.was.creation.core_5.1.0\properties\testregistry.properties 与 UDDIPublish 配合使用来将企业和服务发布至 IBM UDDI V2 企业测试注册中心。同样,为了能够使用 IBM UDDI V2 企业注册中心,可以使用文件 <WS-install-dir>\wstools\eclipse\plugins\com.ibm.etools.webservice.was.creation.core_5.1.0\properties\businessregistry.properties。

使用条款 | 反馈
(C) Copyright IBM Corporation 1999, 2005. All Rights Reserved.