端点侦听器是接收入站服务消息的点(地址)。与 WebSphere® Application Server 一起提供的端点侦听器支持
SOAP over HTTP 和 SOAP over JMS 绑定。
关于此任务
端点侦听器是用于接收入站服务请求的物理端点。入站服务将总线目标描述为逻辑 Web Service。入站端口将(逻辑)入站服务与端点侦听器相关联以提供可在其中调用该服务的(物理)端点。因此,必须已定义端点侦听器,才能创建入站端口。
请求到达端点侦听器。该请求被传递至入站端口(可以在该端口上应用安全性和 JAX-RPC 处理程序列表),然后被发送至服务目标。响应反向遵循同一个路径。
要使用管理控制台来配置端点侦听器,请完成以下步骤:
过程
- 启动管理控制台。
- 在导航窗格中,单击下列其中一条路径:
这就显示了端点侦听器集合表单。
- 单击新建。 这就显示了“新建端点侦听器”向导。
- 通过完成以下步骤,使用该向导来创建新的端点侦听器配置。有关通过向导设置的属性的更多信息,请参阅端点侦听器 [设置]。您可能想要使用端点侦听器配置的示例值中给定的值。
- 选择侦听器名和绑定类型。
- 端点侦听器名
- 输入您选择用来标识此端点侦听器的名称。例如,wsgwsoaphttp、wsgwsoaphttp2、SOAPJMSChannel1
或 SOAPJMSChannel2。
- 绑定类型
- 选择此端点侦听器所支持的绑定类型。对于 SOAP over HTTP 或 SOAP over HTTPS 端点侦听器,请选择
SOAP/HTTP 或 SOAP/HTTPS。对于 SOAP over JMS 端点侦听器,请选择
SOAP/JMS。
- 可选: 配置 JMS 设置。
仅当在上一面板中已选择 SOAP/JMS 时,才会显示此面板。
可选择将端点侦听器应用程序部署为使用激活规范或侦听器端口。可以让侦听器端口稳定下来。有关更多信息,请参阅有关稳定功能的文章。应尽可能将端点侦听器应用程序部署为使用激活规范。只能将激活规范与缺省消息传递提供程序配合使用;可将激活规范或侦听器端口与 WebSphere MQ
消息传递提供程序配合使用。
从下拉列表中选择侦听器端口,或者选择先前配置的激活规范和队列连接工厂(如为同步 SOAP over JMS 端点侦听器配置 JMS 资源所述)。
- 配置必需的 URL。 为应用程序根和 WSDL 服务根配置 Web 地址。可以根据已知的虚拟主机来选择预先配置的地址,也可以创建新的值。
- URL 根
- 选择或输入外部客户机访问端点侦听器端点时使用的地址。 URL 根是端点侦听器应用程序的上下文根,它提供了用来在 WSDL 文件中构建端点地址(以将请求者定向到此端点侦听器)的 Web 地址的根。
- HTTP Server 可与独立应用程序服务器配合使用。或者,如果端点侦听器被外部客户机用于访问提供高可用性或工作负载管理的集群,那么您的集群通常会
使用适当配置的 HTTP Server(或 WebSphere 代理服务器)作为
IP sprayer 运行。在任一情况下,如果外部客户机通过 HTTP Server 或服务器集群并使用缺省端口 80 访问端点侦听器,请指定 HTTP Server 名称而不指定任何端口号。例如(对于 SOAP over HTTP 端点侦听器 1):
http://www.yourcompany.com/wsgwsoaphttp1
对于独立应用程序服务器,通常已配置端点侦听器以便客户机直接连接至个别应用程序服务器。如果端点侦听器被外部客户机用来访问集群,那么可按以下示例中所示配置该侦听器以便客户机直接连接至集群中的个别应用程序服务器,但这样做可能会限制集群的高可用性或工作负载管理功能。但是,如果允许外部客户机直接连接到应用程序服务器(例如,因为它是独立服务器或者在开发或测试环境中),那么请指定应用程序服务器主机名和端口号。 例如(对于 SOAP over HTTP 端点侦听器 1):http://your.server.name:9080/wsgwsoaphttp1
其中,端口号(在此示例中指定为 9080)与相关应用程序服务器的
WC_defaultHost 端口值相匹配。
- WSDL 服务 HTTP URL 根
- 输入在此端点侦听器上提供的入站服务的 WSDL 文件的 Web 地址根。此地址包含外部客户机访问端点侦听器应用程序时使用的 HTTP 地址的根,后跟 /sibws。它表示将 WSDL URL 发布至 UDDI 注册中心时使用的 URL。您对为
HTTP URL 根提供服务的 WSDL 指定的主机和端口名称通常与您对 URL 根指定的主题和端口名相匹配。
如果外部客户机通过 HTTP Server 或服务器集群来访问端点侦听器(通常使用缺省端口 80),那么此 URL 根包含 HTTP Server 名,并且不包含端口号。例如:
http://www.yourcompany.com/sibws
但是,如果允许外部客户机直接连接到应用程序服务器(例如在开发或测试环境中),那么此 URL 根包含应用程序服务器主机名和端口号。例如:
http://your.server.name:9080/sibws
注: WSDL 服务 HTTP URL 根仅由 WebSphere Application Server 的其他组件(尤其是 IBM UDDI 注册中心)在内部使用。对于所有其他使用而言,应通过入站服务的端点侦听器端点来访问 WSDL 文件。 要获取给定入站服务 WSDL 文件的位置详细信息,请将该 WSDL 文件发布到一个压缩文件(如修改现有的入站服务配置所述),然后在导出的 WSDL 文件中查找位置。
- 选择新端点侦听器应连接至的服务集成总线。只有应用程序服务器或集群所属的总线可供选择。
- 单击完成。
结果
如果处理成功地完成,那么会将端点侦听器列表更新为包括新的端点侦听器。否则,将显示错误消息。
下一步做什么
现在,可以选择此端点侦听器来将其用于入站服务了(如
使内部主管的服务可作为 Web Service所述)。