使用 HTTP 对 JAX-WS 应用程序传输 Web Service 请求

将现有的 JavaBeans 对象启用为 Web Service 时,可以开发 HTTP 可访问的 Java™ API for XML-Based Web Services (JAX-WS) Web Service。

开始之前

必须将注释的 JAX-WS JavaBeans 对象启用为 Web Service。(可选)可以从注释的 JAX-WS JavaBeans 组件运行 wsgen 命令以创建 Web Service 描述语言 (WSDL) 文件。必须指定将 -wsdl 选项与 wsgen 命令配合使用以创建 WSDL 文件。

例如:[Windows]
app_server_root/bin wsgen.bat  -classpath . -wsdl -servicename {http://mynamespace}MyService example.Stock.MyService 
[AIX][HP-UX][Linux][Solaris]
app_server_root/bin wsgen.sh  -classpath . -wsdl -servicename {http://mynamespace}MyService example.Stock.MyService 
[IBM i]
app_server_root/bin wsgen  -classpath . -wsdl -servicename {http://mynamespace}MyService example.Stock.MyService 
支持的配置 支持的配置: z/OS® 平台不支持 wsimportwsgenschemagenxjc 命令行工具。随在 z/OS 平台上运行的 WebSphere® Application Server 一起提供的组装工具提供了此功能。请针对 JAX-WS 应用程序查看这些命令行工具,以更多地了解这些工具。sptcfg

要了解如何使用注释来开发 JAX-WS Web Service,请阅读有关使用 JavaBeans 为 JAX-WS 应用程序开发 Java 工件的内容。

关于此任务

应用程序服务器支持使用 HTTP 来传输 Web Service 客户机请求。借助 HTTP,Web Service 客户机和服务器可以通过 SOAP 消息通信。SOAP 是底层通信协议,在支持 Web Services for Java Platform, Enterprise Edition (Java EE) 和 Java API for XML-Based Web Services (JAX-WS) 规范的 Web Service 中使用。

HTTP 是 Web Service 的最常用传输方法。

过程

  1. 将 HTTP 绑定和 SOAP 地址添加到 WSDL 文件。

    Web Service 的 WSDL 文件必须包括 HTTP 绑定和指定 HTTP 端点 URL 字符串的 SOAP 地址,以便能够在 HTTP 传输方法上进行访问。HTTP 绑定是包含 soap:binding 元素的 wsdl:binding 元素,其传输属性以 soap/http 结束。

    除了 HTTP 绑定外,引用 HTTP 绑定的 wsdl:port 元素必须包含在 WSDL 文件的 wsdl:service 元素中。wsdl:port 元素包含 soap:address 元素,它的位置属性指定 HTTP 端点 URL 字符串。

    开发 Web Service 时,可以使用诸如 file:unspecified_location 之类的占位符作为端点 URL 字符串。

    注: 如果在不使用 WSDL 文件的情况下将 JAX-WS JavaBeans 组件部署为 Web Service,将自动为此组件生成 WSDL 文件。
  2. 对于 JAX-WS Web Service 应用程序,不需要进行 HTTP 传输方法配置。应用程序服务器自动生成 HTTP 传输设置。Web 应用程序归档 {WAR) 文件仅需要 JavaBeans 对象以及正确安装的可选 WSDL 文件。
  3. 部署 Web Service 应用程序
  4. 配置 HTTP 传输方法的安全性

    要配置安全 HTTP 传输方法,请将 SSLTransport 策略连接至应用程序。要指定基本认证传输令牌,请使用管理控制台来设置 HTTPTransport 绑定中的用户标识和密码属性。

  5. (可选)配置 HTTP 会话管理

    HTTP 会话管理使 JAX-WS Web Service 应用程序能够对应用程序用户显示为动态。

  6. (可选)配置 JAX-WS 客户机的异步响应侦听器

    可以在 JAX-WS 瘦客户机和应用程序客户机环境中使用异步响应侦听器来接收通过异步方式调用的请求的响应。

  7. 配置 HTTP 绑定的端点 URL 信息

    WSDL 发布程序使用此部分 URL 字符串为企业归档 (EAR) 文件中定义的每个端口组件生成实际的 HTTP URL。已发布的 WSDL 文件可供需要调用 Web Service 的客户机使用。

结果

您具有使用 HTTP 来传输 JAX-WS Web Service 客户机请求的 JavaBeans 对象。

下一步做什么

发布 WSDL 文件

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_httptransportjaxws
文件名:twbs_httptransportjaxws.html