科技行者

行者学院 转型私董会 科技行者专题报道 网红大战科技行者

知识库

知识库 安全导航

至顶网软件频道使用 IDE 开发 JAX-WS Web服务

使用 IDE 开发 JAX-WS Web服务

  • 扫一扫
    分享文章到微信

  • 扫一扫
    关注官方公众号
    至顶头条

本文介绍了使用IDE开发JAX-WS Web服务以及在不同客户端中使用该服务……

来源:IT专家网 2008年4月4日

关键字: JAX-WS 开发 IDE java

  • 评论
  • 分享微博
  • 分享邮件
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服务的工作。并且通过对多种协议(如 SOAP 1.1、SOAP 1.2、XML)的支持,以及提供用于支持其他协议和 HTTP 的工具,它解决了 JAX-RPC 1.1 中存在的一些问题。JAX-WS 使用 JAXB 2.0 提供数据绑定服务,并支持通过定制来控制生成的服务端点接口。通过对标注的支持,JAX-WS 简化了 Web 服务开发,并缩小了运行时 JAR 文件的大小。

  本文档向您介绍了有关使用 IDE 开发 JAX-WS Web服务以及在三个不同的客户端(Java SE 应用程序中的 Java 类、Web 应用程序中的 Servlet 或 JSP 页)中使用该服务的基础知识。在本文档中创建的三个客户端是独立的应用程序,它们都使用同一个 Web服务。

  在开始之前,您需要在计算机中安装以下软件:

  •   NetBeans IDE 5.5
  •   Java Standard Development Kit (JDK) 版本 5.0 或版本 6.0
  •   Sun Java System Application Server 9.0

  安装并配置教程环境

  如果尚未注册 Sun Java System Application Server 9.0 的实例,则必须先进行注册,然后才可以着手开发 Java EE 5 应用程序:

  •   从主窗口中,选择“工具”>“服务器管理器”。
  •   单击“添加服务器”。选择 "Sun Java System Application Server",并为此实例指定一个名称,然后,单击“下一步”。
  •   指定服务器信息、应用服务器本地实例的位置以及要将 Web服务部署到的域。
  •   单击“完成”。

  注意:也可以部署到 Tomcat Web Server,但由于它仅具有一个 Web 容器,因此应在下一部分创建 Web 应用程序,而不是 EJB 模块。与 JSR-109 Web服务不同的是,JAX-WS Web服务可以成功地部署到 Tomcat Web 容器中。

  创建 Web服务

  本练习的目的是创建一个适用于您决定使用的部署容器的项目。在建立项目后,您将在其中创建 Web服务。

  选择容器

  您可以在 Web 容器或 EJB 容器中部署 Web 服务。这要取决于具体的选择。例如,如果您计划部署到仅具有 Web 容器的 Tomcat Web Server 上,则应该选择创建 Web 应用程序,而不是 EJB 模块。

  •   选择“文件”>“新建项目”(Ctrl-Shift-N)。从 "Web" 类别中,选择“Web 应用程序”,或者从“企业”类别中,选择“EJB 模块”。
  •   将项目命名为 CalculatorWSApplication。
  •   根据要使用的部署服务器,请执行以下操作:
    •   对于 Sun Java System Application Server,将 J2EE 版本设置为 "Java EE 5"。
    •   对于 Tomcat Web Server,请取消选中“将源代码级别设置为 1.4”复选框。
  •   单击“完成”。

通过 Java 类创建 Web服务

  •   右键单击 CalculatorWSApplication 节点,然后选择“新建”>“Web服务”。
  •   将 Web服务命名为 CalculatorWS,在“包”中键入 org.me.calculator,然后单击“完成”。
      将在“项目”窗口中显示新建的 Web服务。例如,对于 Web 应用程序,现在“项目”窗口将如下所示:

  IDE 将自动创建服务器所需的部署描述符(如果有)。对于 Sun Java System Application Server,则不需要部署描述符。对于部署到 Tomcat Web Server 的 Web 服务,将添加 sun-jaxws.xml 以及 web.xml 中的 WSServlet 项。

  对 Web服务进行编码

  本节的目的是对 IDE 生成的文件和代码执行一些有意义的操作。您将添加一个操作,该操作将从客户端接收到的两个数字相加起来。

  将业务逻辑添加到 Web 服务

  •   展开“Web 服务”节点,然后双击 "CalculatorWS" 节点。将在源代码编辑器中打开 Web 服务。请注意,代码中已存在了一个操作。它被注释掉了。现在,我们将从头开始创建一个新的操作。创建此操作的另一种方法是删除代码注释掉的行。
  •   在类主体(位于注释掉的代码之上或之下)中单击鼠标右键,然后选择“Web 服务”>“添加操作”。
  •   在“添加操作”对话框的上半部分,在“名称”中键入 add,并从“返回类型”下拉列表中选择 int。
  •   在“添加操作”对话框的下半部分,单击“添加”,然后创建一个类型为 int、名为 i 的参数。单击“确定”。
  •   重新单击“添加”,然后创建一个类型为 int、名为 j 的参数。
  •   单击位于“添加操作”对话框底部的“确定”。请注意,add 方法的框架已添加到源代码编辑器中:

  @WebMethod
  public int add(@WebParam(name = "i") int i, @WebParam(name = "j") int j) {
  // TODO implement operation
  return 0;
  }

  按如下所示更改 add 方法(更改内容以粗体显示):

  @WebMethod
  public int add(@WebParam(name = "i") int i, @WebParam(name = "j") int j) {
  int k = i + j;
  return k;
  }

 部署并测试 Web服务

  在将 Web服务部署到 Web 容器时,IDE 允许您测试 Web服务以查看它是否能够按预期的那样工作。鉴于此目的,我们在 IDE 中集成了 Sun Java System Application Server 提供的 Tester 应用程序。对于 Tomcat Web Server,也存在类似的工具。但是,Sun Java System Application Server 的 Tester 页允许您输入值并对其进行测试,而 Tomcat Web Server 则不允许这样做。在后一种情况下,您只能看到已部署了 Web 服务,但是不能对值进行测试。目前还没有用于测试 EJB 模块是否已成功部署的工具。

  测试是否已成功部署到 Web 容器:

  •   右键单击项目节点,选择“属性”,然后单击“运行”。根据要使用的部署服务器,请执行以下操作:
    •   对于 Sun Java System Application Server,在“相对 URL”字段中键入 /CalculatorWSService?Tester。
    •   对于 Tomcat Web Server,在“相对 URL”字段中键入 /CalculatorWS?Tester。
        注意:由于部署的 EJB 模块的结果不会显示在浏览器中,因此,如果您使用的是 EJB 模块,则不能执行上述步骤。
  •   右键单击项目节点,然后选择“运行项目”。

  IDE 将启动应用服务器、生成应用程序,并在浏览器中打开 tester 页(如果已将 Web 应用程序部署到 Sun Java System Application Server)。对于使用 Tomcat Web Server 和部署 EJB 模块来说,情况则有所不同:

    •   如果部署到 Tomcat Web Server,将看到以下内容(表明已成功部署了 Web 服务):

    •   如果部署了 EJB 模块,则“输出”窗口显示下面的消息才表明已成功部署:

  Deployment of application CalculatorWSApplication completed successfully
  Enable of CalculatorWSApplication in target server completed successfully
  Enable of application in all targets completed successfully
  All operations completed successfully
  run-deploy:
  run:
  BUILD SUCCESSFUL

如果部署到 Sun Java System Application Server,在 tester 页上键入两个数字,如下所示:

  将显示这两个数字的和:


使用 Web服务

  部署 Web服务后,我们需要创建一个客户端来使用 Web服务的 add 方法。在本练习中,我们将创建三个客户端,即 Java SE 应用程序中的 Java 类、Web 应用程序中的 Servlet 和 JSP 页。

  客户端 1:Java SE 应用程序中的 Java 类

  •   选择“文件”>“新建项目”(Ctrl-Shift-N)。从“常规”类别中,选择“Java 应用程序”。将项目命名为 CalculatorWS_Client_Application。
      注意:在编写本文档时,问题 10 还仍未得到解决,您必须在其路径不包含空格的项目文件夹中创建 Web服务客户端。例如,路径不能为 "C:\Documents and Settings\..."。
      单击“完成”。
  •   右键单击 "CalculatorWS_Client_Application" 节点,然后选择“新建”>“Web服务客户端”。
  •   在“项目”中,单击“浏览”。找到要使用的 Web 服务。选择 Web 服务后,单击“确定”。
  •   在“包”中键入 org.me.calculator.client,然后单击“完成”。
      将在“项目”窗口中显示新建的 Web服务客户端:

  •   双击 "Main.java" 以在源代码编辑器中将其打开。删除 TODO 注释,并在该行中单击鼠标右键。选择“Web服务客户端资源”>“调用 Web服务操作”。
  •   找到“添加”操作,然后单击“确定”。
  •   将带红色下划线的行更改为以下内容:

System.out.println("Sum: " + port.add(3,4));

  •   右键单击项目节点,然后选择“运行项目”。
      现在“输出”窗口会显示以下内容:

  compile:
  run:
  Sum: 7
  BUILD SUCCESSFUL (total time: 1 second)

客户端 2:Web 应用程序中的 Servlet
  •   选择“文件”>“新建项目”(Ctrl-Shift-N)。从 "Web" 类别中,选择“Web 应用程序”。将项目命名为 CalculatorWSServletClient。
      注意:在编写本文档时,问题 10 还仍未得到解决,您必须在其路径不包含空格的项目文件夹中创建 Web服务客户端。例如,路径不能为 "C:\Documents and Settings\..."。
      单击“完成”。
  •   右键单击 "CalculatorWSServletClient" 节点,然后选择“新建”>“Web服务客户端”。
  •   在“项目”中,单击“浏览”。找到要使用的 Web 服务。选择 Web服务后,单击“确定”。
  •   在“包”中键入 org.me.calculator.client,然后单击“完成”。
      将在“项目”窗口中显示新建的 Web服务客户端:

  •   右键单击项目节点,然后选择“新建”> "Servlet"。将 Servlet 命名为 ClientServlet,并将它放置在名为 org.me.calculator.client 的包中。单击“完成”。要使 Servlet 成为应用程序的入口点,请右键单击该项目节点,选择“属性”,单击“运行”,然后在“相对 URL”中键入 /ClientServlet。单击“确定”。
  •   在源代码编辑器中,删除注释掉 processRequest 方法主体的行。该行是注释掉代码部分的起始行:

/* TODO output your page here

  然后,删除注释掉代码部分的结束行:

*/

  在以下行之后添加一些空行:

out.println("<h1>Servlet ClientServlet at " + request.getContextPath () + "</h1>");

  现在,在您添加的一个空行中单击鼠标右键,选择“Web 服务客户端资源”>“调用 Web 服务操作”。将出现“选择要调用的操作”对话框。

 找到 add 操作,然后单击“确定”。

  现在 processRequest 方法应该如下所示(下面以粗体显示添加的代码):

    protected void processRequest(HttpServletRequest request, HttpServletResponse response)
    throws ServletException, IOException {
        response.setContentType("text/html;charset=UTF-8");
        PrintWriter out = response.getWriter();
        out.println("<html>");
        out.println("<head>");
        out.println("<title>Servlet ClientServlet</title>");
        out.println("</head>");
        out.println("<body>");
        out.println("<h1>Servlet ClientServlet at " + request.getContextPath () + "</h1>");

        try { // Call Web Service Operation
            org.me.calculator.client.CalculatorWSService service = new org.me.calculator.client.CalculatorWSService();
            org.me.calculator.client.CalculatorWS port = service.getCalculatorWSPort();
            // TODO initialize WS operation arguments here
            int arg0 = 0;
            int arg1 = 0;
            // TODO process result here
            int result = port.add(arg0, arg1);
            System.out.println("Result = "+result);
        } catch (Exception ex) {
            // TODO handle custom exceptions here
        }

        out.println("</body>");
        out.println("</html>");
        out.close();
    }

  将 arg0 和 arg1 的值更改为其他数值,如 3 和 4。

  将 System.out.println 语句更改为 out.println。

  添加输出异常的行(如果抛出异常)。

  现在 try/catch 块应该如下所示(会突出显示新行和更改行):

    try { // Call Web Service Operation
        org.me.calculator.client.CalculatorWSService service = new org.me.calculator.client.CalculatorWSService();
        org.me.calculator.client.CalculatorWSApplication port = service.getCalculatorWSApplicationPort();
        // TODO initialize WS operation arguments here
        int arg0 = 3;
        int arg1 = 4;

        // TODO process result here
        int result = port.add(arg0, arg1);
        out.println("<p>Result: " + result);
    } catch (Exception ex) {
        out.println("<p>Exception: " + ex);
    }

  •   右键单击项目节点,然后选择“运行项目”。
      将启动服务器(如果它尚未运行),生成并部署应用程序,并且打开浏览器以显示计算结果。

客户端 3:Web 应用程序中的 JSP 页

  •   选择“文件”>“新建项目”(Ctrl-Shift-N)。从 "Web" 类别中,选择“Web 应用程序”。将项目命名为 CalculatorWSJSPClient。
      注意:在编写本文档时,问题 10 还仍未得到解决,您必须在其路径不包含空格的项目文件夹中创建 Web 服务客户端。例如,路径不能为 "C:\Documents and Settings\..."。
      单击“完成”。
  •   右键单击 "CalculatorWSJSPClient" 节点,然后选择“新建”>“Web服务客户端”。
  •   在“项目”中,单击“浏览”。找到要使用的 Web服务。选择 Web服务后,单击“确定”。
  •   在“包”中键入 org.me.calculator.client,然后单击“完成”。
      将在“项目”窗口中显示新建的 Web服务客户端。
  •   在“Web 页”文件夹中,双击 "index.jsp" 以在源代码编辑器中将其打开。
  •   在“Web 服务引用”节点中,展开表示 Web服务的节点。现在将公开要从客户端调用的 add 操作。
  •   将 add 操作拖动到客户端的 index.jsp 页上,并将其放在 H1 标记之下。现在,将在 index.jsp 页中生成用于调用服务操作的代码。
      将 arg0 和 arg1 的值更改为其他数值,如 3 和 4。
  •   右键单击项目节点,然后选择“运行项目”。
      将启动服务器(如果它尚未运行),生成并部署应用程序,并且打开浏览器以显示计算结果:
    • 评论
    • 分享微博
    • 分享邮件
    邮件订阅

    如果您非常迫切的想了解IT领域最新产品与技术信息,那么订阅至顶网技术邮件将是您的最佳途径之一。

    重磅专题
    往期文章
    最新文章