在命令提示符下启动 UDDI 实用程序工具
您可以在命令提示符下启动 UDDI 实用程序工具。在某些情况下,需要满足一些先决条件,然后才能运行命令。
通过设置 PATH 语句以包括随 WebSphere® Application Server 一起提供的 Java™ 代码,确保使用正确级别的 Java 代码。例如,从命令行上输入:![[Windows]](../images/windows.gif)
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
![[Windows]](../images/windows.gif)
set PATH=app_server_root\java\bin;%PATH%
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
export PATH=app_server_root/java/bin:$PATH
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
. /$DB2_HOME/db2profile
注: DB2 用户在 $HOME/sqllib/db2profile 中必须具有 db2profile。
请使用下列其中一种方法来启动 UDDI 实用程序工具:
- 输入以下命令并使用指定的属性文件来设置类路径和其他参数:
java - jar UDDIUtilityTools.jar {function} [options]
注: 在从命令行运行 UDDIUtilityTools.jar 之前,请确保编辑 UDDIUtilityTools.properties 文件。如果将此属性文件保存到不同于 UDDIUtilityTools.jar 文件的目录中,请将属性文件的位置作为命令行参数的一部分进行指定。
- 输入以下命令,其中 CommandLineProcessor 是用于处理 UDDI 实用程序工具的命令行参数、设置配置以及调用相应功能的类:
java CommandLineProcessor
- UDDIUtilityTools.jar 的用法:
java -jar UDDIUtilityTools.jar {function} [options]
- 功能:
-promote <entity source> Promote entities between registries -export <entity source> Extract entities from a registry to XML -delete <entity source> Delete entities from a registry -import Create entities from XML to a registry where <entity source> is one of: -tmodel|-business|-service|-binding <key> Specify a single entity type and key -keysFile | -f <filename> Specify a file that contains entity types and keys
- 选项:
-properties <filename> Specify the path to a configuration file -overwrite | -o Overwrite an entity if it already exists -log | -v Output verbose messages -definitionFile <filename> Specify the path to a UDDI entity definition file -importReferenced Import entities that are referenced by source entities
以下命令行选项会覆盖配置文件中的属性设置:
- overwrite
- log
- definitionFile
- importReferenced
示例
以下示例使用 Windows 操作系统文件系统。
java -jar UDDIUtilityTools.jar -promote -keysFile
C:/uddikeys.txt
将单一业务导出到当前目录中属性文件所指定的实体定义文件。
java -jar UDDIUtilityTools.jar -export
-business 28B8B928-2B2E-4EC9-A647-1E40651E4752
将单一业务导出到当前目录中属性文件所指定的实体定义文件,并使用键文件来指定要导出的实体。
java -jar UDDIUtilityTools.jar -export -keysFile
C:/myKeyFiles/keyFile01.txt
将单一业务导出到当前目录中属性文件所指定的实体定义文件,并使用键文件来指定要导出的实体。另外,在命令行上显示详细输出。
java -jar UDDIUtilityTools.jar -export -keysFile
C:/myKeyFiles/keyFile02.txt -v
导入缺省实体定义文件(在当前目录中的 UDDIUtilityTools.properties 文件中指定)的内容。
java -jar UDDIUtilityTools.jar -import
导入缺省实体定义文件(在当前目录中的 UDDIUtilityTools.properties 文件中指定)的内容,并将所引用的 tModel 实体导入到目标注册中心。
java -jar UDDIUtilityTools.jar -import -importReferenced
从所指定位置的实体定义文件中导入实体。
注意正斜杠的使用,即使这是一个在 Windows 操作系统文件系统上的示例。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
java -jar UDDIUtilityTools.jar -import -definitionFile
C:/myEDFs/entities01.xml
从包含所引用 tModel 实体的缺省实体定义文件中导入实体。overwrite 选项指定任何覆盖实体,不包括目标注册中心中的所引用 tModel 实体。
java -jar UDDIUtilityTools.jar -import -overwrite -importReferenced
使用在指定位置的属性文件将单一服务从源升级到目标注册中心。
java -jar UDDIUtilityTools.jar -promote
-service 67961D67-330F-4F14-8210-E74A58E710F3
-properties
C:/UUT/myUUTProps.properties
升级键文件中指定的一组实体。
java -jar UDDIUtilityTools.jar -promote -keysFile
C:/myKeyFiles/keyFile03.txt
升级键文件中指定的一组实体,并覆盖目标注册中心中的现有实体。
java -jar UDDIUtilityTools.jar -promote -keysFile
C:/myKeyFiles/keyFile04.txt
-overwrite
升级键文件中指定的一组实体,其中包括所引用的 tModel 实体。
java -jar UDDIUtilityTools.jar -promote -keysFile
C:/myKeyFiles/keyFile05.txt
-importReferenced
升级键文件中指定的一组实体,但也创建一个包含所升级实体的实体定义文件。
java -jar UDDIUtilityTools.jar -promote -keysFile
C:/myKeyFiles/keyFile06.txt
-definitionFile
C:/myEDFs/entities02.xml
逻辑删除单一 tModel 实体。无法逻辑删除 tModel 实体。
java -jar UDDIUtilityTools.jar -delete
-tModel UUID:1E2B9D1E-E53D-4D36-9D46-6CCC176C466A
删除键文件中指定的所有实体。除了 tModel 实体之外,会从目标注册中心中物理删除所有其他实体。
java -jar UDDIUtilityTools.jar -delete -keysFile
C:/myKeyFiles/keyFile04.txt
键文件示例
以下示例显示要从目标注册中心中导出、升级或删除的键:
#
# Keys of entities to be exported, promoted from source registry or deleted
# from target registry
#
# Note: keys must be comma separated and on SAME line
# Note: property names are case sensitive. ('tmodels=' are ignored)
businesses=97C77097-AC6C-4CA0-A6C4-452F7045C470,
4975E949-581F-4FCA-AD5F-E08280E05F9F
services=BB3864BB-1578-4833-8179-14391F14791F
bindings=
tModels=273F1727-7BFF-4FB5-A1FD-BA5C45BAFD9C
如果 importReferenced 属性设置为 true,referencedTModels 部分中的 tModel 列表被导入到目标注册中心。如果 referencedTModel 是新的,那么创建最小实体。如果 referencedTModel 已存在,无论覆盖属性值如何,其从不被覆盖。此方法可防止不必要地更新公共引用的 tModel 实体,例如,分类 tModel 实体。
如果要更新 referencedTModel,那么必须手动将 referencedTModel 定义移至实体定义文件中的 tModel 实体部分并将 overwrite 设为 true。