JAX-WS的例子

JAX-WS是JAX-RPC的后继新技术，日渐流行。于是我也来试试。看了IBM上的一些文章，对比JAX-WS和JAX-RPC的，JAX-WS带来不少好处。通过使用 Java™ API for XML Web Services (JAX-WS) 技术设计和开发 Web 服务，可以带来很多好处，能简化 Web 服务的开发和部署，并能加速 Web 服务的开发。

JAX-WS 简介

为何使用 JAX-WS？

JAX-WS 是用于简化使用 Java 构造 Web 服务和 Web 服务客户机的工作的技术。该技术提供了完整的 Web 服务堆栈，可减少开发和部署 Web 服务的任务。JAX-WS 支持 WS-I Basic Profile 1.1，后者可确保使用 JAX-WS 堆栈开发的 Web 服务能够供采用 WS-I Basic Profile 标准使用任意语言开发的任意客户机使用。JAX-WS 还包括了 Java Architecture for XML Binding (JAXB) 和 SOAP with Attachments API for Java (SAAJ)。

JAXB 提供了一种非常方便的方法来将 XML 模式映射到 Java 代码的表示形式，从而支持数据绑定功能。JAXB 消除了将 SOAP 消息中的 XML 模式消息转换为 Java 代码的工作，因而不必全面了解 XML 和 SOAP 解析。JAXB 规范定义 Java 和 XML 模式之间的绑定。SAAJ 提供了标准的方法来处理 SOAP 消息中包含的 XML 附件。

而且，JAX-WS 提供了用于将传统 Java 对象（Plain Old Java Object，POJO）类转换为 Web 服务的 Annotation 库，从而加速了 Web 服务的开发工作。另外，它还指定了从采用 Web 服务描述语言（Web Services Description Language，WSDL）定义的服务到实现该服务的 Java 类之间的详细映射。采用 WSDL 定义的任意复杂类型都通过遵循 JAXB 规范定义的映射来映射为 Java 类。JAX-WS 之前与 Java Platform, Enterprise Edition (Java EE) 5 绑定。而 JAX-WS 2.0 规范是作为 Java Community Process (JCP) 的 JSR 224 开发的。

      学习了IBM的教程《设计与开发 JAX-WS 2.0 Web 服务》，这个教程主要是讲订单处理。还是比较简单，做完后为了加深印象，就自己做了一个最简单的HelloService，采用的是代码优先。使用的JDK为1.6版本的。

      首先，写一个类HelloService，这个类发布为服务。

package com.zzz.jaxws.service;

import javax.jws.WebMethod;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;

/**
* @description
* @version 创建时间：Apr 3, 2009 9:26:15 AM

*/
@WebService(serviceName="HelloService",
     portName="HelloServicePort",
     targetNamespace="http://jaxws.zzz/jaxws/hello")
@SOAPBinding(style=SOAPBinding.Style.DOCUMENT,use=SOAPBinding.Use.LITERAL,
     parameterStyle=SOAPBinding.ParameterStyle.WRAPPED)
public class HelloService {
@WebMethod
public String sayHello(String s){
   System.out.println("hello,"+s);
   return s;
}
}

这个类里用到了Annotation，使用@WebService，定义了服务名，端口名和名称空间。使用@SOAPBinding定义了WSDL的绑定样式，这里采用的是document/literal-wrapped。使用@WebMethod定义了发布的服务。看起来，和普通的Java类没什么区别。

        完成了服务类的编写，需要发布服务了。这里是专门写一个发布类来发布服务，我们这里使用JDK1.6中自带的web服务器，把服务发布到它里面。

      

生成 JAX-WS 构件

运行 wsgen 工具，以生成订单处理 Web 服务的 JAX-WS 可移植构件。此工具将读取 Web SEI 类，并生成 Web 服务部署和调用所需的所有构件。wsgen 工具生成需要发布的 Web 服务的 WSDL 文件和 XSD 模式。

为了生成 JAX-WS 构件，首先需要编译服务和 Bean 源文件：

1. 打开命令提示符，并进入到 c:\JAXWS-Tutorial目录(我把代码都拷贝到了c:\JAXWS-Tutorial下)。
2. 运行以下命令，以编译 Java 文件，并将类文件放入其各自文件夹中：
   
   javac com\zzz\jaxws\service\*.java
   
   
3. 运行以下命令，以生成 JAX-WS 构件：
   
   wsgen -cp . com.zzz.jaxws.service.HelloService -wsdl

       运行此命令后，应该在 JAXWS-Tutorial 文件夹中看到生成的 HelloService.wsdl和 HelloService_schema1.xsd，而且会看到在 com\zzz\jaxws\service\jaxws 文件夹中创建了 JAX-WS 构件。

        编写发布类HelloServicePublisher。

package com.zzz.jaxws.service.publisher;

import javax.xml.ws.Endpoint;

import com.zzz.jaxws.service.HelloService;

/**
* @description 发布HelloService.java为服务
* @version 创建时间：Apr 3, 2009 9:37:30 AM

*/
public class HelloServicePublisher {

public void publish(){
   Endpoint.publish("http://localhost:8080/services/HelloService",
     new HelloService());
}
public static void main(String[] args){
   HelloServicePublisher publish = new HelloServicePublisher();
   publish.publish();
}
}

这个服务的发布类很简单，就是使用Endpoint.publish()发布。publish() 接受两个参数：Web 服务的位置和 JAX-WS Web 服务实现类。

1. 从 c:\JAXWS-Tutorial 文件夹运行以下命令，以编译 HelloServicePublisher ：
   
   javac com\zzz\jaxws\service\publisher\HelloServicePublisher.java
   
   
2. 然后运行以下命令：
   
   java com.zzz.jaxws.service.publisher.HelloServicePublisher
3. 打开浏览器，并导航到http://localhost:8080/services/HelloService?wsdl，可以看见生成的WSDL。

        到这里服务发布完了，需要编写客户端来调用了。JAX-WS 提供了名为 wsimport 的工具，用于从 WSDL 生成 JAX-WS 可移植构件。生成的可移植构件通常包括以下内容：

• SEI
• 服务（需要实现的服务实现类）
• 从模式类型生成的 JAXB 生成类
• 从 wsdl:fault 映射的异常类（如果有）

客户机使用生成的构件调用 Web 服务。Web 服务客户机并不需要处理任何 SOAP 格式（如创建或解析 SOAP 消息）。这将由 JAX-WS 运行时予以处理，此运行时将使用生成的构件代码（JAXB 生成类）。Web 服务将处理 Java 代码（JAXB 生成类），从而减少了开发 Web 服务客户机和对 Web 服务调用操作的工作。

       使用wsimport命令生成客户端使用的构件：

wsimport -keep -p com.zzz.jaxws.service.client http://localhost:8080/services/HelloService?wsdl

-keep 选项指示保留生成的文件，-p 选项指定需要在其中生成构件的包名称。http://localhost:8080/services/HelloService?wsdl指定 WSDL 文件的位置。

package com.zzz.jaxws.service.client;

import java.net.MalformedURLException;
import java.net.URL;

import javax.xml.namespace.QName;

/**
* @description
* @version 创建时间：Apr 3, 2009 9:49:41 AM

*/
public class HelloServiceClient {

private final QName qName=new QName(
    "http://jaxws.zzz/jaxws/hello","sayHello");

public static URL getWSDLURL(String urlStr){
   URL url = null;
   try {
    url = new URL(urlStr);
   } catch (MalformedURLException e) {
    e.printStackTrace();
   }
   return url;
}

public void process(URL url){
   HelloService_Service service = new HelloService_Service(url,qName);
   HelloService port = service.getHelloServicePort();
   String response = port.sayHello("world");
   System.out.println("result:"+response);
}

/**
* @param args
*/
public static void main(String[] args) {
   if(args.length!=1){
    System.out.println("Please enter parameter.");
    return;
   }
   URL url = getWSDLURL(args[0]);
   HelloServiceClient client = new HelloServiceClient();
   client.process(url);
}

}

生成HelloService_Service的实例，

对服务调用 getHelloServicePort()，以检索到服务的代理（也称为端口）。端口实现服务所定义的接口。

调用端口的 sayHello方法，并同时传入一个字符参数。

要运行 Web 服务客户机，请首先从 JAXWS-Tutorial 文件夹运行以下命令来编译 Web 服务客户机：

javac com\zzz\jaxws\service\client\HelloServiceClient .java

通过使用以下命令提供订单处理 Web 服务的 WSDL URL 来运行 Web 服务客户机：

java com.zzz.jaxws.service.client.HelloServiceClient http://localhost:8080/services/HelloService?wsdl

这时，后在后台看见: hello,world

到这里，已经成功地创建和发布了 Web 服务，并通过 Web 服务客户机成功地执行了此服务。