装入用户定义的值集数据
可以使用 UDDIUserDefinedValueSet 实用程序来执行以下操作:将值集数据装入 UDDI 注册中心、将现有的值集数据指定给另一个 tModel 实体以及卸载现有的值集数据。装入值集数据是作为一个过程步骤,用来将用户定义的值集添加到 UDDI 注册中心。
值集数据文件的格式
值集数据由唯一代码值、可选描述和指定它与其他代码值关系的父代码来标识。值集数据必须遵循此格式。
必须以 UTF-8 格式保存文件。
列名 | 最大长度 | 使用描述 |
---|---|---|
code | 765 | 值集中的唯一值,用于验证 |
description | 765 | 通常由 UDDI 用户控制台使用,并且在 keyedReference 元素中用作 keyName 值(可选) |
parentcode | 765 | 指示作为此代码的逻辑父代的现有代码,并且用于树显示 |
00#Food#00
10#Fruit#00
101#Apples#10
102#Oranges#10
103#Pears#10
1031#Anjou#103
1032#Conference#103
1033#Bosc#103
104#Pomegranates#10
20#Vegetables#00
201#Carrots#20
202#Potatoes#20
203#Peas#20
204#Sprouts#20
在本示例中,Food 是根节点的描述,并且它具有子节点 Fruit 和 Vegetables;这两个子节点的 parentcode 值与 Food 的代码值相同。
Food
Fruit
Apples
Oranges
Pears
Anjou
Conference
Bosc
Pomegranates
Vegetables
Carrots
Potatoes
Peas
Sprouts
UDDIUserDefinedValueSet 实用程序
可以使用 UDDIUserDefinedValueSet 实用程序来执行以下操作:将值集数据装入 UDDI 注册中心、将现有的值集数据指定给另一个 tModel 实体以及卸载现有的值集数据。此实用程序也支持 UDDI V2 中所使用的定制分类法文件。
此实用程序使用 UDDI 注册中心 JMX 接口,因此需要许多连接参数。
- 用法:
UDDIUserDefinedValueSet[.sh|.bat] '{'function'}' [options]
UDDIUserDefinedValueSet '{'function'}' [options]
UDDIUserDefinedValueSet.sh '{'function'}' [options]
- 功能:
-load <path> <key> Load value set data from specified file -newKey <oldKey> <newKey> Move value set to a new tModel -unload <key> Unload existing value set
- 选项:
-properties <path> Specify location of configuration file -host <host name> Application Server or deployment manager host -port <port> SOAP Lister port number -node <node name> Node running a UDDI server -server <server name> Server with UDDI deployed -columnDelimiter <delim> Character delimiter to denote field end -stringDelimiter <delim> Character delimiter to denote strings
- 连接器安全参数
-userName <name> -password <password> -trustStore <path> -trustStorePassword <password> -keyStore <name> -keyStorePassword <password>
确保您从中运行 UDDIUserDefinedValueSet 实用程序的命令窗口,使用合适的代码页和字体来显示值集名称中的字符。如果使用不正确的代码页或字体,那么在成功装入后可能会导致消息不清晰,且可能造成难以使用卸载和 newKey 功能。
UDDIUserDefinedValueSet 脚本位于 app_server_root/bin 目录中。
如果未提供任何连接参数,那么在使用缺省 Deployment Manager SOAP 端口号的本地主机上寻找连接;如果没有运行的 Deployment Manager,那么在使用缺省应用程序服务器 SOAP 端口号的本地主机上寻找连接。
命令参数不区分大小写。
可选择性地使用属性参数来指定配置文件。此配置文件确定您也可以在命令行上指定的可选属性。在命令行上指定的属性会覆盖配置文件中的值。这些属性主要是 JMX 连接参数和安全参数。
通常,当描述值包含与列定界符相同的字符时,使用 stringDelimiter 参数。例如,如果 columnDelimiter 参数设为逗号 (,) 且值集描述值为 "Fruits, citrus",请将 stringDelimiter 参数设为双引号 (") 并使用引号将描述引起来(例如,"Fruits, citrus"),以将此描述包括在值集数据文件中。请注意,必须将反斜杠 (\) 设为转义字符以显示已使用文字字符。
命令行参数和示例数据 | 属性和示例数据 | 注释 |
---|---|---|
-columnDelimiter # | column.delimiter=# | 用于值集数据文件的列定界符。 |
-stringDelimiter \" | string.delimiter=\" | 字段定界符。此值不同于 column.delimiter 值。 |
-host ibm.com | host=ibm.com | 正在运行 Deployment Manager 或应用程序服务器的系统的主机名 |
-port 8880 | port=8880 | Deployment Manager 或应用程序服务器的 SOAP 端口号。 |
-node ibmNode | node=ibmNode | 运行带有 UDDI 注册中心的服务器的节点名。 |
-server server1 | server=server1 | 运行 UDDI 注册中心的服务器。 |
-userName ibmuser | security.username=ibmuser | 用户名。如果已打开 WebSphere® Application Server 安全性,那么此值是必需的。 |
-password mypassword | security.password=mypassword | 密码。 |
-trustStore /TrustStoreLocation | security.truststore=/TrustStoreLocation | 信任库文件位置。 |
-keyStore ibmkeystore | security.keystore=ibmkeystore | 密钥库名称。 |
-trustStorepassword trustpass | security.truststore.password=trustpass | 信任库密码 |
-keyStorePassword keypass | security.keystore.password=keypass | 密钥库密码。 |
用法示例
在以下示例中,.xxx 是 .bat(Windows 操作系统)或 .sh(UNIX 和 Linux 操作系统)。
通过在 valuesetdata.txt 文件中使用 % 号作为列标记,在本地 UDDI 注册中心中装入 tModel 实体的值集数据。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
UDDIUserDefinedValueSet.xxx -load valuesetdata.txt
uddi:a708b8a7-35b5-451c-aafc-718ae071fcfe -columnDelimiter %
![[z/OS]](../images/ngzos.gif)
UDDIUserDefinedValueSet.sh -load valuesetdata.txt
uddi:a708b8a7-35b5-451c-aafc-718ae071fcfe -columnDelimiter %
在 Network Deployment 配置中的 UDDI 注册中心中,将值集数据从一个已检查 tModel 实体移至另一个已检查 tModel 实体。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
12345678901234567890123456789012345678901234567890123456789012345678901234567890
UDDIUserDefinedValueSet.xxx -newKey
uddi:a708b8a7-35b5-451c-aafc-718ae071fcfe
uddi:b819c9b8-46c6-562d-bb0d-829bf1820d0f -host depmanagerhost.ibm.com
-port 8879 -node uddinode -server uddiserver -override
![[z/OS]](../images/ngzos.gif)
UDDIUserDefinedValueSet.sh -newKey uddi:a708b8a7-35b5-451c-aafc-718ae071fcfe
uddi:b819c9b8-46c6-562d-bb0d-829bf1820d0f -host depmanagerhost.ibm.com
-port 8879 -node uddinode -server uddiserver -override
从启用安全性的服务器上的 tModel 实体中卸载值集。在文件 myproperties.properties 中提供连接和安全性参数,但在命令行上提供服务器和密码参数。在命令行上提供的参数会扩充或覆盖属性文件中的参数。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
UDDIUserDefinedValueSet.xxx -unload uddi:b819c9b8-46c6-562d-bb0d-829bf1820d0f
-server uddiserver -properties myproperties.properties -password myrealpassword
![[z/OS]](../images/ngzos.gif)
UDDIUserDefinedValueSet.sh -unload uddi:b819c9b8-46c6-562d-bb0d-829bf1820d0f
-server uddiserver -properties myproperties.properties -password myrealpassword