createWSNServicePoint 命令
使用 createWSNServicePoint 命令创建新 WS-Notification 服务点。
可按本主题中所述使用 wsadmin 工具创建新 WS-Notification 服务点,或按创建新的 V6.1 WS-Notification 服务点和创建新的 V7.0 WS-Notification 服务点中所述使用管理控制台进行创建。
要运行该命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
wsadmin
脚本编制客户机通过 Qshell 运行.
有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.
已经为服务集成总线命令提供了命令行帮助:
- 要获取可用的 WS-Notification 命令列表以及每个命令的简要描述,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('WSNotificationCommands')
- 要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('command_name')
AdminConfig.save()
用途
如果总线成员上存在 WS-Notification 服务点,那么意味着会在该总线成员中公开此 WS-Notification Web Service,并导致对与该服务点相关联的总线成员公开通知代理、预订管理器和发布者注册管理器的 Web Service 端点。WS-Notification 应用程序使用这些端点来与 WS-Notification 服务进行交互。
- 它在 WS-Notification 服务上创建新的 WS-Notification 服务点。
- 对于 V7.0 WS-Notification 服务点,这会导致代理充当的三个角色的 Web Service 端点在总线成员上公开。
- 对于 V6.1 WS-Notification 服务点,它创建三个服务集成总线入站端口以表示代理充当的三个角色,并在必要时创建服务集成总线端点侦听器,然后将新的或现有端点侦听器连接至与 WS-Notification 服务相关联的服务集成总线。
- 总线成员类型(服务器或集群)
- V6.1 WS-Notification 服务点的端点侦听器(创建新端点侦听器或使用现有端点侦听器)
- -eplName
- -eplURLRoot
- -eplWSDLServingURLRoot
- -transportURLRoot
- -transportSoapVersion
- -jaxwsHandlerListNB
- -jaxwsHandlerListSM
- -jaxwsHandlerListPRM
只能为 WebSphere® Application Server V7.0 或更高版本 总线成员上的 V7.0 WS-Notification 服务创建服务点。如果总线成员是集群,那么集群中的所有服务器必须是 WebSphere Application Server V7.0 或更高版本 应用程序服务器。
可为 WebSphere Application Server V6.1 或更高版本 应用程序服务器上的 V6.1 WS-Notification 服务创建服务点。
目标对象
WSNService
必需参数
- -name
条件参数
选择相关联的总线成员的服务器或集群:
- -server
- 要创建的 WS-Notification 服务点所在服务器的名称。
- 如果指定了 copyServicePoint 参数,那么不需要指定此参数。
- 如果使用了此参数,那么必须指定 node 参数,并且不能指定 cluster 参数。
- -node
- 服务器所在节点的名称。
- 如果指定了 copyServicePoint 参数,那么不需要指定此参数。
- 如果使用了此参数,那么必须指定 server 参数,并且不能指定 cluster 参数。
- -cluster
- 要创建的 WS-Notification 服务点所在集群的名称。
- 如果指定了 copyServicePoint 参数,那么不需要指定此参数。
- 如果使用了此参数,那么不能指定 server 和 node 参数。
对于 V6.1 WS-Notification 服务,选择是配置新的端点侦听器还是使用现有的端点侦听器:
- -eplName
- 端点侦听器的名称。
- 如果指定了 copyServicePoint 参数,那么不需要指定此参数。
- 如果已经在所选服务器或集群上定义了此端点侦听器,那么不应该指定 eplURLRoot 和 eplWSDLServingURLRoot 参数。否则,必须同时指定 eplURLRoot 和 eplWSDLServingURLRoot 参数。
- 仅对 V6.1 WS-Notification 服务指定此参数。
- -eplURLRoot
- 通过此端点侦听器访问的 Web Service 的外部可视端点地址 URL 的根。
- 如果指定了 copyServicePoint 参数,那么不需要指定此参数。
- 如果已经在所选服务器或集群上定义了此端点侦听器,那么不应该指定此参数。
- 仅对 V6.1 WS-Notification 服务指定此参数。
- -eplWSDLServingURLRoot
- 与此端点侦听器相关联的
WSDL 文件所在外部可视 HTTP URL 的根。在大多数情况下,此值是
http://host_name:port_number/SIBWS。有关更多信息,请参阅创建新的端点侦听器配置或createSIBWSEndpointListener 命令。
- 如果指定了 copyServicePoint 参数,那么不需要指定此参数。
- 如果已经在所选服务器或集群上定义了此端点侦听器,那么不应该指定此参数。
- 仅对 V6.1 WS-Notification 服务指定此参数。
对于 V7.0 WS-Notification 服务,请配置 Web Service 端点:
- -transportURLRoot
- WS-Notification 服务点的外部可视端点地址的根,格式如下:
其中 protocol 是 http 或 https。例如:protocol://host_nameport_number/service_location
http://myhostname:9080/ctx123/mySvc
- 通过管理控制台将 WSDL 发布至压缩文件时,可以使用此参数使特定的外部 Web 地址与 WS-Notification 服务相关联。请注意,此地址可能与公开 WS-Notification 服务的地址不同。通过代理访问 WS-Notification 服务时,需要此地址。
- 如果未指定此参数,那么底层 JAX-WS 实现会根据服务点安装过程中提供的信息创建适当的 URL。
- 如果指定了 copyServicePoint 参数,那么不需要指定此参数。
- 对于对 V6.1 WS-Notification 服务创建的服务点,此属性是 eplURLRoot 参数的等价项。仅对 V7.0 WS-Notification 服务指定此参数。
- -transportSoapVersion
- 对于 SOAP 1.1,允许的值为 1.1(缺省值),对于 SOAP 1.2,允许的值为 1.2。
- 如果指定了 copyServicePoint 参数,那么不需要指定此参数。
- 仅对 V7.0 WS-Notification 服务指定此参数。
从现有 WS-Notification 服务点定义复制配置:
- -copyServicePoint
- WS-Notification 服务上配置的现有服务点的名称,将从此服务点复制其他配置属性。如果指定此参数,那么只需指定 name 参数。所有其他值都是从所指定现有服务点中获取的。
可选参数
- -description
- -jaxwsHandlerListNB
- 如果指定了 copyServicePoint 参数,那么不需要指定此参数。
- 仅对 V7.0 WS-Notification 服务指定此参数。
- -jaxwsHandlerListSM
- 如果指定了 copyServicePoint 参数,那么不需要指定此参数。
- 仅对 V7.0 WS-Notification 服务指定此参数。
- -jaxwsHandlerListPRM
- 如果指定了 copyServicePoint 参数,那么不需要指定此参数。
- 仅对 V7.0 WS-Notification 服务指定此参数。
示例
在下列示例中,WS-Notification 服务点使用“使用 wsadmin 工具创建新的 WS-Notification 服务”主题中的示例所创建的 WS-Notification 服务 newService。
在使用现有端点侦听器 SIBWSHTTPChannel1 的 cluster1 上创建 V6.1 WS-Notification 服务点:
newServicePoint = AdminTask.createWSNServicePoint(newService,
[“-name”, “newServicePoint”, “-cluster”, “cluster1”, “-eplName”, “SIBWSHTTPChannel1”] )
在 node1 上的 server1 中创建 V6.1 WS-Notification 服务点,并在通道 1 上创建使用 SOAP over HTTP 的新端点侦听器,其中服务器的主机地址是 http://myHost:9080:
newServicePoint = AdminTask.createWSNServicePoint(newService,
[“-name”, “newServicePoint”, “-node”, “node1”, “-server”, “server1”, “-eplName”, “myNewEPL”,
“-eplURLRoot”, “http://myhost:9080/wsn”, “-eplWSDLServingURLRoot”, “http://myhost:9080/sibws”] )
在 node1 上的 server1 上创建 V7.0 WS-Notification 服务点(最少参数集合):
newServicePoint = AdminTask.createWSNServicePoint(newService,
[“-name”, “newServicePoint”, “-node”, “node1”, “-server”, “server1”,
“-transportURLRoot”, “http://myhost:9080/myWSN”] )
在 node1 上的 server1 上创建 V7.0 WS-Notification 服务点(完整参数集合):
newServicePoint = AdminTask.createWSNServicePoint(newService,
[“-name”, “newServicePoint”, “-node”, “node1”, “-server”, “server1”,
“-transportURLRoot”, “http://myhost:9080/myWSN”, “-transportSoapVersion”, “1.1”,
“-jaxwsHandlerListNB”, “nbList”, “-jaxwsHandlerListSM”, “smList”, “-jaxwsHandlerListPRM”, “prmList”] )