在web项目中发布jaxws

概述

在web项目中发布基于jaxws的webservice。

参考文章： 用JAX-WS在Tomcat中发布WebService

参考文章说，如果不是servlet3.0及以上，需要配置servlet，请注意。

 

servlet3.0的web.xml的框架：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xmlns="http://java.sun.com/xml/ns/javaee"
         xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
         id="WebApp_ID" version="3.0" metadata-complete="false">
    <display-name>Archetype Created Web Application</display-name>
</web-app>

Maven依赖

<!-- JAXWS-RI -->
<dependency>
    <groupId>com.sun.xml.ws</groupId>
    <artifactId>jaxws-rt</artifactId>
    <version>2.2.10</version>
</dependency>

依赖分析结果：

[INFO] \- com.sun.xml.ws:jaxws-rt:jar:2.2.10:compile
[INFO]    +- javax.xml.bind:jaxb-api:jar:2.2.12-b140109.1041:compile
[INFO]    +- javax.xml.ws:jaxws-api:jar:2.2.11:compile
[INFO]    +- javax.xml.soap:javax.xml.soap-api:jar:1.3.7:compile
[INFO]    +- javax.annotation:javax.annotation-api:jar:1.2:compile
[INFO]    +- javax.jws:jsr181-api:jar:1.0-MR1:compile
[INFO]    +- com.sun.xml.bind:jaxb-core:jar:2.2.10-b140802.1033:compile
[INFO]    +- com.sun.xml.bind:jaxb-impl:jar:2.2.10-b140802.1033:compile
[INFO]    +- com.sun.xml.ws:policy:jar:2.4:compile
[INFO]    +- org.glassfish.gmbal:gmbal-api-only:jar:3.1.0-b001:compile
[INFO]    |  \- org.glassfish.external:management-api:jar:3.0.0-b012:compile
[INFO]    +- org.jvnet.staxex:stax-ex:jar:1.7.7:compile
[INFO]    +- com.sun.xml.stream.buffer:streambuffer:jar:1.5.3:compile
[INFO]    +- org.jvnet.mimepull:mimepull:jar:1.9.4:compile
[INFO]    +- com.sun.xml.fastinfoset:FastInfoset:jar:1.2.13:compile
[INFO]    +- org.glassfish.ha:ha-api:jar:3.1.9:compile
[INFO]    +- com.sun.xml.messaging.saaj:saaj-impl:jar:1.3.25:compile
[INFO]    +- org.codehaus.woodstox:woodstox-core-asl:jar:4.2.0:runtime
[INFO]    +- org.codehaus.woodstox:stax2-api:jar:3.1.1:runtime
[INFO]    \- com.sun.org.apache.xml.internal:resolver:jar:20050927:compile

不使用Maven，需要人工导入上述jar包；可以尝试在http://mvnrepository.com/中获取。

服务实现

假设你已经清楚如何使用jaxws实现webservice，这里仅提供简略的说明和代码。

这里写一个简单的服务，返回“hello, jaxws!”字符串。

服务接口

IHelloJAXWSService.java

package cn.ljl.baseframe.test.jaxws;
import javax.jws.WebResult;
import javax.jws.WebService;
@WebService
public interface IHelloJAXWSService {
    @WebResult(name = "helloWorld")
    public String getHelloWord();
}

服务实现类

HelloJAXWSServiceImpl.java

package cn.ljl.baseframe.test.jaxws;
import javax.jws.WebService;
@WebService(endpointInterface = "cn.ljl.baseframe.test.jaxws.IHelloJAXWSService")
public class HelloJAXWSServiceImpl implements IHelloJAXWSService {
    @Override
    public String getHelloWord() {
        String helloWorld = "hello, jaxws!";
        return helloWorld;
    }
}

配置endpoints

在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">
    <!-- 服务路径http://网站路径/services/hello -->
    <endpoint name="hello"
        implementation="cn.ljl.baseframe.test.jaxws.HelloJAXWSServiceImpl"
        url-pattern="/services/hello" />
</endpoints>

注意：网上多个文章都要求这个文件是UTF-8编码，没有测试是否必须。

测试

来自为知笔记(Wiz)