用JAX-WS在Tomcat中公布WebService
JDK中已经内置了Webservice公布，只是要用Tomcat等Webserver公布WebService，还须要用第三方Webservice框架。
Axis2和CXF是眼下最流行的Webservice框架，这两个框架各有长处。只是都属于重量级框架。
JAX-WS RI是JAX WebService參考实现。相对于Axis2和CXF，JAX-WS RI是一个轻量级的框架。
尽管是个轻量级框架，JAX-WS RI也提供了在Webserver中公布Webservice的功能。官网地址https://jax-ws.java.net/。以下用JAX-WS RI在Tomcat中公布WebService。
博客中的实例代码
http://download.csdn.net/detail/accountwcx/8922191
服务端
新建一个Maven Web项目。在项目中加入JAX-WS RI引用，pom.xml配置文件例如以下
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.rvho</groupId> <artifactId>jaxwsserver</artifactId> <version>0.0.1-SNAPSHOT</version> <packaging>war</packaging> <properties> <!-- 文件拷贝编码 --> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <!-- 输出编码 --> <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding> <!-- 编译编码 --> <maven.compiler.encoding>UTF-8</maven.compiler.encoding> </properties> <dependencies> <!-- JAXWS-RI --> <dependency> <groupId>com.sun.xml.ws</groupId> <artifactId>jaxws-rt</artifactId> <version>2.2.10</version> </dependency> </dependencies> </project>
package com.rvho.server.ws;
import java.util.Date;
import javax.jws.WebService;
/**
* WebService接口
*/
@WebService(name = "HelloWS", targetNamespace = "http://www.tmp.com/ws/hello")
public interface HelloWService {
/**
* 返回字符串
*
* @return
*/
String index();
/**
* 两个整数相加
*
* @param x
* @param y
* @return 相加后的值
*/
Integer add(Integer x, Integer y);
/**
* 返回当前时间
*
* @return
*/
Date now();
/**
* 获取复杂类型
* @param name 用户姓名
* @param age 用户年龄
* @return 返回用户类
*/
PersonEntity getPerson(String name, Integer age);
}创建服务接口实现类(SEI)
package com.rvho.server.ws.impl;
import java.util.Date;
import javax.jws.WebService;
import com.rvho.server.entity.PersonEntity;
import com.rvho.server.ws.HelloWService;
@WebService(
endpointInterface = "com.rvho.server.ws.HelloWService",
portName = "HelloWSPort",
serviceName = "HelloWSService",
targetNamespace = "http://www.tmp.com/ws/hello")
public class HelloWServiceImpl implements HelloWService {
public String index() {
return "hello";
}
public Integer add(Integer x, Integer y) {
return x + y;
}
public Date now() {
return new Date();
}
public PersonEntity getPerson(String name, Integer age) {
PersonEntity person = new PersonEntity();
person.setAge(age);
person.setName(name);
return person;
}
}服务中用到的复杂类型PersonEntity
package com.rvho.server.entity;
import java.io.Serializable;
public class PersonEntity implements Serializable {
private static final long serialVersionUID = -7211227324542440039L;
private String name;
private Integer age;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public Integer getAge() {
return age;
}
public void setAge(Integer age) {
this.age = age;
}
}在WEB-INF中创建WebService配置文件sun-jaxws.xml，配置文件里一个WebService相应一个Endpoint。
<?xml version="1.0" encoding="UTF-8"?
> <endpoints xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime" version="2.0"> <!-- 服务路径http://站点路径/services/hello --> <endpoint name="hello" implementation="com.rvho.server.ws.impl.HelloWServiceImpl" url-pattern="/services/hello" /> </endpoints>
在web.xml中加入WSServlet，假设Web项目使用Servlet 3.0则不须要下面配置。
<!-- Servlet 3.0或者以上不须要配置 --> <servlet> <servlet-name>jaxws</servlet-name> <servlet-class>com.sun.xml.ws.transport.http.servlet.WSServlet</servlet-class> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>jaxws</servlet-name> <url-pattern>/services</url-pattern> </servlet-mapping>
公布服务后，在浏览器中输入http://<站点路径>/services/hello能够看到例如以下页面
client
使用方法: wsimport [options] <WSDL_URI>
当中 [options] 包含:
-b <path> 指定 jaxws/jaxb 绑定文件或附加模式
(每一个 <path> 都必须具有自己的 -b)
-B<jaxbOption> 将此选项传递给 JAXB 模式编译器
-catalog <file> 指定用于解析外部实体引用的文件夹文件
支持 TR9401, XCatalog 和 OASIS XML 文件夹格式。
-d <directory> 指定放置生成的输出文件的位置
-encoding <encoding> 指定源文件所使用的字符编码
-extension 同意供应商扩展 - 不按规范
指定功能。使用扩展可能会
导致应用程序不可移植或
无法与其它实现进行互操作
-help 显示帮助
-httpproxy:<host>:<port> 指定 HTTP 代理server (端口默觉得 8080)
-keep 保留生成的文件
-p <pkg> 指定目标程序包
-quiet 隐藏 wsimport 输出
-s <directory> 指定放置生成的源文件的位置
-target <version> 按给定的 JAXWS 规范版本号生成代码
默觉得 2.2, 接受的值为 2.0, 2.1 和 2.2
比如, 2.0 将为 JAXWS 2.0 规范生成兼容的代码
-verbose 有关编译器在运行什么操作的输出消息
-version 输出版本号信息
-wsdllocation <location> @WebServiceClient.wsdlLocation 值
-clientjar <jarfile> 创建生成的 Artifact 的 jar 文件以及
调用 Web 服务所需的 WSDL 元数据。
-generateJWS 生成存根 JWS 实现文件
-implDestDir <directory> 指定生成 JWS 实现文件的位置
-implServiceName <name> 生成的 JWS 实现的服务名的本地部分
-implPortName <name> 生成的 JWS 实现的端口名的本地部分
扩展:
-XadditionalHeaders 映射标头不绑定到请求或响应消息不绑定到
Java 方法參数
-Xauthfile 用于传送下面格式的授权信息的文件:
http://username:password@example.org/stock?
wsdl
-Xdebug 输出调试信息
-Xno-addressing-databinding 同意 W3C EndpointReferenceType 到 Java 的绑定
-Xnocompile 不编译生成的 Java 文件
-XdisableAuthenticator 禁用由 JAX-WS RI 使用的验证程序,
将忽略 -Xauthfile 选项 (假设设置)
-XdisableSSLHostnameVerification 在提取 wsdl 时禁用 SSL 主机名
验证
演示样例:
wsimport stock.wsdl -b stock.xml -b stock.xjb
wsimport -d generated http://example.org/stock?wsdl
输入下面命令，就可以生成Java类
D:\Program Files\Java\jdk1.8.0_25\bin>wsimport.exe -encoding utf-8 -p com.rvho.client.wsdl.hello -d d:\wsdl\compile -s d:\wsdl\src http://localhost:8014/jaxwsserver/services/hello?wsdl
最后生成的clientJava类
package com.rvho.client.wsdl.hello;
import java.net.URL;
public class Client {
public static void main(String[] args) throws Exception {
URL wsdlUrl = new URL("http://localhost:8014/jaxwsserver/services/hello?wsdl");
HelloWSService helloWSS = new HelloWSService(wsdlUrl);
HelloWS helloWS = helloWSS.getHelloWSPort();
Integer x = 3;
Integer y = 5;
Integer add = helloWS.add(x, y);
System.out.println("add");
System.out.println("3 + 5 = " + add);
System.out.println("");
String name = "小明";
Integer age = 19;
PersonEntity person = helloWS.getPerson(name, age);
System.out.println("getPerson");
System.out.println("name = " + person.getName() + " age = " + person.getAge());
System.out.println("");
}
}
注意
警告: onComplete() failed for listener of type [org.apache.catalina.core.AsyncListenerWrapper] java.lang.IllegalStateException: It is illegal to call getRequest() after complete() or any of the dispatch() methods has been called at org.apache.catalina.core.AsyncContextImpl.getRequest(AsyncContextImpl.java:225) at com.sun.xml.ws.transport.http.servlet.WSAsyncListener$1.onComplete(WSAsyncListener.java:69) at org.apache.catalina.core.AsyncListenerWrapper.fireOnComplete(AsyncListenerWrapper.java:35) at org.apache.catalina.core.AsyncContextImpl.fireOnComplete(AsyncContextImpl.java:99) at org.apache.coyote.AsyncStateMachine.asyncPostProcess(AsyncStateMachine.java:208) at org.apache.coyote.AbstractProcessor.asyncPostProcess(AbstractProcessor.java:173) at org.apache.coyote.AbstractProtocol$AbstractConnectionHandler.process(AbstractProtocol.java:662) at org.apache.coyote.http11.Http11NioProtocol$Http11ConnectionHandler.process(Http11NioProtocol.java:222) at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.doRun(NioEndpoint.java:1566) at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.run(NioEndpoint.java:1523) at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142) at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617) at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61) at java.lang.Thread.run(Thread.java:745)
