createWSRRDefinition 命令

在线编辑

可使用 createWSRRDefinition 命令创建 WSRR 定义。

createWSRRDefinition 命令为多步骤命令，在此命令中，步骤定义连接定义的类型及其特定属性。 您只能指定一个步骤，因为一个 WSRR 定义仅可具有一个连接定义。

使用下列命令列示所有 WSRR 管理命令：
$AdminTask help SIBXWSRRAdminCommands

createWSRRDefinition 命令是使用 wsadmin 脚本编制客户机的 AdminTask 对象来运行的。

先决条件

必须满足以下条件：
  • 该命令必须在 Deployment Manager 节点上运行。
  • 如果 Deployment Manager 已停止，请使用 wsadmin -conntype none 选项以断开连接的方式运行该命令。
  • 如果 Deployment Manager 正在运行，那么必须通过具有 WebSphere Application Server 配置者特权的用户标识进行连接。 请勿使用 wsadmin -conntype none 选项。

位置

从 deployment_manager_profile/bin 目录启动 wsadmin 脚本编制客户机。 createWSRRDefinition 命令不会写入日志文件，但是 wsadmin 脚本编制客户机始终会编写 profile_root/logs/wsadmin.traceout 日志文件，您在此将找到异常堆栈跟踪和其他信息。

语法

createWSRRDefinition
-name definitionName
-connectionType WEBSERVICE
-defaultCacheExpiryTimeout timeout
[-description defDescription]

参数

-name definitionName
必需参数，用于指定 WSRR 定义的名称（采用字符串形式）。
-connectionType WEBSERVICE
必需参数，用于指定连接类型。 唯一的连接类型是 WEBSERVICE。
-defaultCacheExpiryTimeout 超时
必需参数，用于指定高速缓存的超时（秒）。 值 0 指示决不对查询结果进行高速缓存。 缺省值是 300。
-description defDescription
可选参数，提供定义的简要描述。 此参数作为参考提供。

步骤

如果指定多个步骤，那么会抛出异常。
要为与 WSRR 定义关联的 Web Service 连接设置属性，可为注册表 URL、认证别名和 SLL 配置指定值，如下所示：
-WSConnection {{registryURL authAlias repertoire}}
要使用缺省注册表 URL（http://localhost:9080/WSRRCoreSDO/services/WSRRCoreSDOPort），请为第一个值指定一对双引号 ("")。 要省略认证别名，请为第二个值指定一对双引号 ("")。 要省略指令表（SLL 配置），请为第三个值指定一对双引号 ("")。

示例

以下示例显示了如何使用缺省连接：
wsadmin>AdminTask.createWSRRDefinition( ['-name', 'mydefName', '-description', my description',
		 	'-defaultCacheExpiryTimeout', '300', '-connectionType', 'WEBSERVICE'] )
以下示例显示了如何设置连接属性：
wsadmin>AdminTask.createWSRRDefinition( ['-name', 'mydefName', '-description', my description', 
    '-defaultCacheExpiryTimeout', '300', '-connectionType', 'WEBSERVICE', 
    '-WSConnection ', ['-registryUrl', 'http://localhost:9080', '-authAlias', 'AUTH_ALIAS1', '-repertoire', 'SSL_CONFIG1']] )
以下示例显示了如何使用备用列表语法来设置一个连接属性：
wsadmin>AdminTask.createWSRRDefinition( ['-name', 'defName', '-description', my description', 
    '-defaultCacheExpiryTimeout', '300', '-connectionType', 'WEBSERVICE', 
    '-WSConnection', [ ["" AUTH_ALIAS1  ""] ]] )