JAX-WS简单例子

1、下载jaxws-ri

到jax-ws官网下载，我下载的是jaxws-ri-2.2.8.zip，解压之后lib目录下就是我们开发会需要的用到的jar包。

2、服务端

2.1. 创建Dynamic Web project

需要新建目录build，wsdl和wssrc，目录结构如下图：

2.2. 写webservice如下：（参考了5天学会jaxws-webservice编程）

import javax.jws.WebMethod;
import javax.jws.WebService;

@WebService
public class Hello {
	@WebMethod
	public String say(String name) {
		return ("Hello: " + name);
	}
}

@WebService注释在类上，告诉jax-ws这个类是一个webservice；

@WebMethod注释在public方法上，告诉jax-ws这个方法是一个soap方法；

2.3. 进入项目根目录(如：JaxWsServer1)，确保wssrc目录清空

wsgen -cp ./WebContent/WEB-INF/classes -r ./wsdl -s ./wssrc -d ./build -wsdl xxx.Hello

执行结果在wsdl和wssrc中生成了文件，我们后面会用到。

参数解释如下：

-cp <path>                 same as -classpath <path>

-r <directory>             resource destination directory, specify where to place resouce files such as WSDLs

-s <directory>            specify where to place generated source files

-d <directory>            specify where to place generated output files

-wsdl[:protocol]         generate a WSDL file.  

The protocol is optional. Valid protocols are soap1.1 and Xsoap1.2, the default is soap1.1.  

Xsoap1.2 is not standard and can only be used in conjunction with the -extension option

2.4. wssrc目录下生成了jaxws目录，目录下包含Say.java和SayResponse.java

这里要说明的是JAX-WS RI 2.2.8使用了JAXB 2.2，并且大量使用注释方式。

2.5. 部署

2.5.1. web方式

a. web.xml中添加listener

    <listener>
        <listener-class>
            com.sun.xml.ws.transport.http.servlet.WSServletContextListener
        </listener-class>
    </listener>

b. 新建WebContent/WEB-INF/sun-jaxws.xml

<?xml version="1.0" encoding="UTF-8"?>
<endpoints xmlns='http://java.sun.com/xml/ns/jax-ws/ri/runtime'
	version='2.0'>
	<endpoint name='Hello' implementation='xxx.Hello'
		url-pattern='/HelloService' />
</endpoints>

c. 打包在web容器里运行

2.5.2. 程序方式

编写一个main函数，运行即可

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

测试

http://localhost:8080/Hello/HelloService?wsdl

3、客户端（异步方式调用）

3.1. 新建一个java project

3.2. 本地方式获取wsdl

根目录下建一个binding.xml的文件，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<bindings xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" wsdlLocation="wsdl/HelloService.wsdl"
    xmlns="http://java.sun.com/xml/ns/jaxws">
    <bindings node="wsdl:definitions">
        <enableAsyncMapping>true</enableAsyncMapping>
    </bindings>
</bindings>

项目根目录中创建wsdl目录，把Server端的wsdl及xsd文件都手工拷贝到客户端工程的wsdl目录下；

项目根目录中运行wsimport -keep -b binding.xml -d bin -s src wsdl/HelloService.wsdl

HelloService中替换file:/C:/workspace_eclipse_3_7/JaxWsAsyncClient1/wsdl/HelloService.wsdl为http://localhost:8080/Hello/HelloService?wsdl

3.3. 服务器方式获取（推荐）

根目录下建一个binding.xml的文件，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<bindings xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" wsdlLocation="http://localhost:8080/Hello/HelloService?wsdl"
    xmlns="http://java.sun.com/xml/ns/jaxws">
    <bindings node="wsdl:definitions">
        <enableAsyncMapping>true</enableAsyncMapping>
    </bindings>
</bindings>

wsimport -keep -b binding.xml -d bin -s src http://localhost:8080/Hello/HelloService?wsdl

3.4. 客户端访问服务端

a. 等待方式

public class HelloAsyncPollingClient {

	/**
	 * @param args
	 */
	public static void main(String[] args) throws Exception {
		HelloService service = new HelloService();
		Hello port = service.getHelloPort();
		Response<SayResponse> sayAsync = port.sayAsync("James");
		while (!sayAsync.isDone()) {
			System.out.println("is not down");
		}
		try {
			SayResponse callNameResponse = sayAsync.get();
			String message = callNameResponse.getReturn();
			System.out.println(message);
		} catch (Exception ex) {
		}
	}

}

b. 回调方式

public class HelloAsyncCallBackClient {
	// 由于此callBack当请求发出去以后当前的这个connection就会关闭 ,为了达到测试的目的，加入了sleep，让客户
	// 端程序等待服务器端得返回。
	// callback类型的client要传入一个javax.xml.ws.AsyncHandler类型的匿名内部类，当soapMessage 到达时，Jax-
	// ws会调handleResponse这个方法来处理response.
	public static void main(String[] args) throws Exception {
		HelloService service = new HelloService();
		Hello port = service.getHelloPort();
		port.sayAsync("Mk", new AsyncHandler<SayResponse>() {
			public void handleResponse(Response<SayResponse> res) {
				try {
					SayResponse response = null;
					response = res.get();
					String message = response.getReturn();
					System.out.println(message);
				} catch (Exception e) {
					e.printStackTrace();
				}
			}
		});
		Thread.sleep(2000);
	}
}