生成 JAX-WS Web 服务客户端
另请参见
可以在 Web 应用程序、Java 应用程序或 MIDP 客户端 (MIDlet) 中使用 Web 服务。有关在 MIDlet 中使用 Web 服务的信息,请参见 Java ME Mobility 文档。
对于 JAX-WS 客户端,所有导入的 WSDL 文件和架构都由 IDE 自动解析。对于 JAX-RPC 客户端,在开始之前,请注意,如果要使用的 WSDL 文件从本地文件系统中导入架构和/或其他 WSDL 文件,则只有事先将导入的架构和 WSDL 文件复制到 WEB-INF/wsdl(或 META-INF/wsdl)文件夹,才能正常使用 Web 服务客户端。如果您未执行此操作,则在以下操作过程结束时,wscompile 工具将无法找到这些导入的文件。
创建 Web 服务客户端:
- 创建要包含 Web 服务客户端的项目。根据您要使用 Web 服务的方式,创建一个 Web 应用程序项目或 Java 应用程序项目。
- 从“项目”窗口或“文件”窗口中,右键单击项目中的节点,然后选择“新建”>“其他”。将出现“新建文件”向导。在“类别”下选择“Web 服务”。在“文件类型”下选择“Web 服务客户端”。单击“下一步”。
- 访问 Web 服务客户端要使用的 Web 服务的 WSDL 文件。根据提供者所分发的内容,请执行以下操作:
- 要通过本地文件系统上的项目生成客户端,请单击“项目”并浏览至项目的 Web 服务端口图标。
- 要通过本地文件系统上的 WSDL 文件生成客户端,请单击“本地文件”并浏览至本地文件系统上的 WSDL 文件。
- 要通过正在运行的 Web 服务生成客户端,请单击 "WSDL URL",然后键入或粘贴 Web 服务的 URL。如果您受到公司防火墙的保护,请单击“代理设置”并设置代理主机和端口号。
- 指定要生成客户端文件所在的包。在完成向导时,可以在“文件”窗口的 build 文件夹中找到生成的客户端文件。请参见在“项目”窗口中公开 Web 服务客户端。
- 对于 JAX-RPC (J2EE 1.4) 客户端(可以通过插件管理器中的“JAX-RPC Web 服务”插件获取对该客户端的支持),从“客户端类型”下拉列表中选择 Web 服务客户端类型:
- J2EE 容器生成的静态桩模块。此类型基于 JSR-109,它通过以下方式来增强 JSR-101:定义将 Web 服务打包到标准 J2EE 模块中,包含新的部署描述符,以及定义作为会话 Bean 或 Servlet 实现的 Web 服务。这是推荐的类型,也是可移植(通过 J2EE 1.4 规范)的类型。当选择此类型时,IDE 将在部署描述符中添加部署信息,并且容器将生成桩模块和其他工件。
- IDE 生成的静态桩模块。仅适用 JAX-WS (J2EE 1.4) Web 服务。此类型基于 JAX-RPC,它定义了 WSDL 与 Java 之间的映射。它还定义了用来调用远程 Web 服务的客户端 API,以及用来驻留 Web 服务的服务器上的运行时环境。此类型是无法移植的。当选择此类型时,IDE 会生成桩模块和其他工件,并将它们打包到归档文件中进行部署。
- 如果在 Java 应用程序中使用 Web 服务,则不会使用任何 J2EE 应用服务器。应用程序将作为独立的 JVM 进程运行,并且针对每个项目来设置其 JVM 参数。因此,J2EE 容器生成的静态桩模块不适用 Java 应用程序,“客户端类型”下拉列表中不会显示该桩模块。
对于 Java SE 客户端,使用“JAX 版本”下拉列表指定要创建 JAX-WS 客户端还是 JAX-RPC 客户端。
- 如果要在调用 Web 服务时使用原始 XML 消息,请选择“生成分发代码”。客户端代码是使用 java.xml.ws.Dispatch 接口生成的,而不是常用的服务端点接口。这是一项高级功能,缺省情况下不选择该功能。
- 单击“完成”。
- 另请参见
- 关于 Web 服务客户端
- 关于 Web 服务
法律声明