Java API for XML Web Services (JAX-WS) 2.0, JSR 224 是 Java EE 5 平台的一个重要组成部分。作为 Java API for XML-based RPC 1.1(JAX-RPC) 的后续发行,JAX-WS使用 Java 技术简化了 Web 服务的开发任务。它解决了 JAX-RPC 1.1 中存在的一些问题,提供了对 SOAP 1.1、SOAP 1.2 和 XML 等多个协议的支持,并提供了一个工具专门支持 HTTP 等其他协议。JAX-WS 使用 JAXB 2.0 进行数据绑定,并支持通过定制控制生成的服务端点接口。通过其对注释的支持,JAX-WS 简化了 Web 服务开发并减少了运行时 JAR 文件的大小.
本文档将简要介绍如何使用 IDE 开发 JAX-WS Web 服务并在三个不同的客户机中使用它——Java SE 应用程序中的 Java 类以及 Web 应用程序中的 servlet 或 JSP 页面。本文档所创建的三个客户机都是单独的应用程序,他们都使用相同的 Web 服务。有关客户机的高级教程,请参阅 JAX-WS Web 服务客户机入门。
本教程所需要的软件
开始之前,需要在您的计算机中下载并安装以下软件:
NetBeans IDE 6.0 Web & Java EE( 下载)。
Java Standard Development Kit(JDK)版本 5.0 或版本 6.0( 下载)。
Glassfish V2 或 Tomcat Web Server,两者都可在 NetBeans IDE 6.0 安装程序中选择安装。
创建 Web 服务
本练习的目标是创建一个适合所选部署容器的项目。然后,我们将在项目中创建一个 Web 服务。
选择容器
可以将 Web 服务部署在 Web 容器或 EJB 容器中。这由实现的选择决定。比如说,如果计划部署到 Tomcat Web Server 中且其中只有一个 Web 容器,则应该选择创建一个 Web 应用程序,而不是 EJB 模块。
选择 File > New Project(Ctrl-Shift-N)选项。选择 Web 类别中的 Web Application 选项,或者选择 Enterprise 类别中的 EJB Module。
将项目命名为 CalculatorWSApplication。
根据所使用的部署服务器,执行以下操作:
对于 GlassFish,将 Java EE Version 设置为 Java EE 5.
对于 Tomcat Web Server,取消选中 Set Source Level to 1.4 复选框。
单击 Finish 按钮。
通过学习 Java 类创建 Web 服务
右键单击 CalculatorWSApplication 节点,然后选择 New > Web Service 选项。
将 Web 服务命名为 CalculatorWS,并在 Package 字段中键入 org.me.calculator,然后单击 Finish 按钮。
Projects 窗口将显示新 Web 服务的结构,并且可视化设计器将显示在编辑器区域。比如说对于 Web 应用程序,IDE 应如下所示: