Web Service 客户机端口信息
使用此页面为 Web Service 客户机端口指定请求超时、覆盖端点,以及覆盖绑定名称空间。
Web Service 可以有多个端口。您可以查看并配置每个已定义 Web Service 端口的端口属性。Web Service 在 Web Service 客户机绑定页面上列出。
- 单击 。
- 单击 。
- 单击端口信息下的编辑。
此管理控制台页面应用于 Java™ API for XML-Based Web Services (JAX-WS) 和 Java API for XML-based RPC (JAX-RPC) Web Service。覆盖端点 URL 字段是唯一受 JAX-WS 客户机支持的字段。其他字段都不适用于 JAX-WS 客户机。
端口
指定端口的名称。
请求超时
指定 Web Service 客户机在此端口上等待请求完成的时间(以秒计)。如果未指定超时,那么客户机要等待的缺省请求超时是 300 秒。如果该值设置为 0(零),那么使用的超时是底层传输机制的缺省值。此字段仅受 JAX-RPC 客户机支持。
此设置的典型使用为:当配置客户机使用 JMS 传输访问 Web Service 时,定制客户机的行为,使它等待预期请求完成的时间比缺省时间长。根据网络条件或 Web Service 实现的特征,也许一定要调整超时。
覆盖端点 URL
指定用于覆盖当前端点的端点的名称。在此端口上调用请求的客户机使用此端点,不使用 WSDL 文件中指定的端点。此字段既受 JAX-WS 客户机支持,也受 JAX-RPC 客户机支持。
调用 JAX-RPC 或者 JAX-WS 客户机时,会将请求发送至 WSDL(Web Service 描述语言)文件中的端口的 SOAP 地址位置属性中所指定的 URL。这两种编程模型还使客户机能够通过程序设置端点地址 URL。对于 JAX-RPC,客户机使用 javax.xml.rpc.Stub.ENDPOINT_ADDRESS_PROPERTY 属性来设置端点地址 URL;对于 JAX-WS,客户机使用 javax.xml.ws.BindingProvider.ENDPOINT_ADDRESS_PROPERTY 属性。
如果组装的应用程序包含静态绑定的 Web Service 客户机,那么使用开发期间使用的 WSDL 文件中识别的实现(服务端点)将该客户机锁定进来。覆盖端点是配置部署的 WSDL 属性的另一种方法。
覆盖的端点 URI 属性是根据每个端口指定的。它不需要模块中的备用 WSDL 文件。覆盖的端点 URI 优先于部署的 WSDL 属性。客户机将此值用于服务端点 URI 或 SOAP 地址,而不使用静态客户机绑定中的值。

- 通常,此字段不会影响非受管 JAX-WS 客户机,这是因为如果您只有非受管客户机,那么您无法编辑此字段。但是,如果您只有受管客户机,或者您同时具有受管客户机和非受管客户机,那么您可以编辑此字段,并且非受管客户机可能会受到属性设置的影响。如果不想让非受管 JAX-WS 客户机服务将请求发送至在此字段中所指定的端点 URL,那么将以下定制属性添加至 JVM 设置:
将此定制属性添加至应用程序服务器的 JVM 设置并将其设置为 true,可防止非受管 JAX-WS 客户机服务访问将覆盖 WSDL 文件中的端点的端点 URL。com.ibm.ws.websvcs.unmanaged.client.dontUseOverriddenEndpointUri
- 在更新操作中替换了模块或应用程序时,不会持久保存被覆盖的端点 URL 设置。
覆盖的绑定
指定要与此端口协同使用的 WSDL 文件绑定名称空间 URI,而不是 WSDL 文件中的名称空间。此绑定不需要在 WSDL 文件中存在。客户机使用此绑定(而不是 WSDL 文件中指定的绑定)调用此端口上的请求。只有指定了覆盖的端点才能指定覆盖的绑定名称空间。此字段仅受 JAX-RPC 客户机支持。