(1) java-ws实现webservice

(一) java-ws实现webservice

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 源文件：

打开命令提示符，并进入到 c:\JAXWS-Tutorial目录(我把代码都拷贝到了c:\JAXWS-Tutorial下)。运行以下命令，以编译 Java 文件，并将类文件放入其各自文件夹中：?

javac com\zzz\jaxws\service\*.java

运行以下命令，以生成 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 服务实现类。

从 c:\JAXWS-Tutorial 文件夹运行以下命令，以编译?HelloServicePublisher ：

javac com\zzz\jaxws\service\publisher\HelloServicePublisher.java

然后运行以下命令：

java com.zzz.jaxws.service.publisher.HelloServicePublisher打开浏览器，并导航到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 服务客户机成功地执行了此服务。