mvn构建JAX-WS项目含服务端和客户端代码实现

java中WebService框架有很多，像Axis,XFire,CXF等，除了上述框架外，JDK中自带JAX-WS框架。相比而言，JWS是轻量级的，使用非常简便，可与Spring集成使用。

下面就详述如何通过mvn构建WebService服务端及客户端。

1.引包。

在mvn项目的pom文件中加入依赖包

<dependency>
    <groupId>com.sun.xml.ws</groupId>
    <artifactId>jaxws-rt</artifactId>
    <version>2.2.8</version>
</dependency>

引完包后记得重新构建项目，命令方式如下

mvn eclipse:eclipse -Dwtpversion=2.0 -DdownloadSources=true

2.写服务端代码，举Hello服务类如下

@WebService
public class Hello {

    @WebMethod
    public String sayHello(@WebParam(name = "name") String name) {// @WebParam来指定wsdl文件schema的参数名称，而不是显示为arg0,arg1等，以增加可读性
        return String.format("Hello, %s", name);
    }
}

上面通过注解@WebService表明这是一个WebService类，其中注解@WebMethod、@WebParam非必需。

3.服务发布

有两种方式发布自己的WebService

• 方式一：

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

直接通过Endpoint.publish方式进行WebService发布，一般用作调试。运行该类后在浏览器访问http://localhost/HelloService如下图

• 方式二:

发布到web容器中。下面以tomcat为例说明发布配置过程
在WEB-INF目录下新建sun-jaxws.xml文件(该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="HelloService" implementation="com.gvtv.learn.ws.server.Hello"
        url-pattern="/HelloService" />
<!-- url-pattern需要与web.xml中对应的servlet的url-pattern一致 -->
</endpoints>

然后修改web.xml，增加Listener和Servlet如下：

<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >

<web-app>
    <display-name>Archetype Created Web Application</display-name>

    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath*:conf/spring-*.xml</param-value>
    </context-param>

    <listener>
        <listener-class>
            com.sun.xml.ws.transport.http.servlet.WSServletContextListener
        </listener-class>
    </listener>
    <servlet>
        <servlet-name>SayHiService</servlet-name>
        <servlet-class>
            com.sun.xml.ws.transport.http.servlet.WSServlet
        </servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>SayHiService</servlet-name>
        <url-pattern>/HelloService</url-pattern>
    </servlet-mapping>

    <listener>
        <listener-class>
            org.springframework.web.context.ContextLoaderListener
        </listener-class>
    </listener>

    <servlet>
        <servlet-name>springMVC</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath*:conf/springMVC-servlet.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>springMVC</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>

注解sun-jaxws.xml中的url-pattern需要与web.xml中的servlet的url-pattern一致，如上例都为/HelloService(可任意取值)。
启动tomcat后浏览器中输入网址：http://localhost/jquery_ui/HelloService?wsdl(jquery_ui是本人的项目名)，如看到wsdl文件则表明服务发布成功

4.java客户端调用

可利用JDK自带的wsimport工具生成基础代码

一、cmd界面下切换到项目的src\main\java目录下

二、执行命令

xxx\src\main\java>wsimport -encoding utf-8 -keep -d .\ -p com.gvtv.learn.ws.client http://localhost/jquery_ui/HelloService?wsdl

wsimport用法如下：

用法: wsimport [options] <WSDL_URI>

其中 [options] 包括:
  -d <directory>            指定放置生成的输出文件的位置
  -encoding <encoding>      指定源文件所使用的字符编码
  -help                     显示帮助
  -keep                     保留生成的文件（指保留java源文件）
  -p <pkg>                  指定目标程序包名

此时,在包com.gvtv.learn.ws.client下可看见生成的源文件如下

三、利用上面生成的java源文件调用web服务。示例如下：

public class Main {

    public static void main(String[] args) {
        Hello service = new HelloService().getHelloPort();
        String result = service.sayHello("屌丝!");
        System.out.println(result);
    }
}

可看到打印出信息

Hello, 屌丝!

至此，java版的WebService服务端和客户端就完成了，过程非常简单。下次补充下其它知识点