要将 Java™ API for XML-Based Web Service (JAX-WS) 和 Java API for XML-based RPC (JAX-RPC) Web Service 客户机连接到正在进行组装的组件之间的任何 Web Service 或任何外部 Web Service,都需要配置服务端点。
开始之前
如果要将现有 JavaBeans 对象作为 Web Service 启用,那么可以开发可通过 HTTP 进行访问的 Java API
for XML-based remote procedure call (JAX-RPC) 或 Java API
for XML Web Service (JAX-WS) Web Service。有关其他信息,请参阅“使用 HTTP 来传输 Web Service 请求”信息。
可以使用管理控制台或属性文件来配置和管理 HTTP 端点 URL 片段。要了解如何使用属性文件来设置和管理 URL 片段,请参阅有关使用 Web Service 端点 URL 片段属性文件的信息。
此任务描述如何使用管理控制台来配置 HTTP 绑定的端点 URL 信息。
关于此任务
您可使用管理控制台中的“提供 HTTP 端点 URL 信息”面板为通过 HTTP 访问的 Web Service 指定 HTTP URL 前缀。HTTP URL 前缀提供特定于位置的信息,并用于组成已发布 WSDL 文件中所包含的完整端点 URL。
注: 管理控制台中的“提供 HTTP”面板显示包含 n Java API for XML-Based Web Service (JAX-WS) 和 Java API for XML-based RPC (JAX-RPC) Web Service 的模块。可以使用“提供 HTTP”面板提供两种 Web Service 类型的 URL 信息,但是,此面板并不指示您正在处理的服务类型。
要使用管理控制台配置这些前缀:
过程
- 打开管理控制台。
- 单击应用程序 > 企业应用程序 > application_instance > 提供 HTTP 端点 URL 信息。
- 指定 Web Service 的 URL 前缀。
在此步中,您指定要用于端点 URL 的协议(HTTP 或 HTTPS)以及 host_name 和 port_number。可通过选择缺省 HTTP URL 前缀从预定义列表选择前缀,或者您可使用定制 HTTP URL 前缀。
- 选择缺省 HTTP URL 前缀或定制 HTTP URL 前缀。
如果您选择缺省 HTTP URL 前缀,那么列表为您提供端点 URL 前缀的选项。此列表是模块中两组端口的组合:虚拟主机端口和应用程序服务器端口。如果直接访问 Web Service 的应用程序服务器,请使用此列表中的前缀。选择一个值,而且选中要使用前缀的模块复选框。
如果要使用定制 HTTP URL 前缀,在字段中输入值。选中要在前缀中使用的复选框。
如果您配置定制 HTTP URL 前缀,那么还必须在管理控制台中配置定制 JVM 属性
com.ibm.ws.webservices.enableHTTPPrefix 并将值设置为
true。在定义此定制属性之后,必须重新启动应用程序服务器才能使系统使用此属性。必须设置此定制
JVM 属性,以便在浏览器所返回的 ?WSDL 查询中以及返回给客户机的 WSDL 文件的 URL 字段中正确填写定制
HTTP 端点前缀信息。如果未对此定制属性定义 true 值,那么在服务返回给客户机的
WSDL 文件中,将不会反映定制 HTTP URL 前缀。要了解如何配置此定制 JVM 属性,请参阅有关使用管理控制台中的 JVM 定制属性面板来配置其他 HTTP 传输属性的文档。
支持的配置: com.ibm.ws.webservices.enableHTTPPrefix 定制属性仅适用于 JAX-RPC Web Service 应用程序。
sptcfg
- 单击应用。
URL 前缀(无论是缺省还是定制)都复制到所选的模块 HTTP URL 前缀字段。
- 单击确定。
将 URL 信息保存到您的工作空间。
结果
您指定了部分 URL 信息,使用这些信息构成使用“发布 WSDL 文件”面板发布的 WSDL 文件中的目标端点地址。
下一步做什么
配置 Java 消息服务 (JMS) 绑定和直接 Enterprise JavaBeans (EJB) 访问的任何其他 URL 端点信息。然后发布 WSDL 文件以使已部署的 Web Service 应用程序可用于客户机。