前两篇关于使用Axis2开发WebService,都是使用了services.xml文件,而且还要拷贝axis2.war下面的文件到项目中,实际开发中是很麻烦的。

本篇简要讲述如何基于JAX-WS开发WebService的服务端,客户端如何调用请参考前几篇文章。


【1】编写接口与实现类

接口类如下:

package com.web.service;

import javax.jws.WebMethod;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;

@WebService
@SOAPBinding(style = SOAPBinding.Style.RPC)
public interface MyService {

@WebMethod
public String sayHello(String name);
}

实现类如下:

package com.web.service.impl;

import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;

import com.web.service.MyService;

@WebService
@SOAPBinding(style = SOAPBinding.Style.RPC)
public class MyServiceImpl implements MyService{

@Override
public String sayHello(String name) {
System.out.println("this is wsservice "+name);
return "hello "+name;
}

}

【2】xml配置

因为没有与Spring耦合,所以不需要对Spring进行配置。

需要的xml配置如下:

① 在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="wsService"
implementation="com.web.service.impl.MyServiceImpl"
url-pattern="/services/wsService" />
</endpoints>

该xml中只有一个endpoints元素,该元素下可以有多个endpoint ,每个endpoint 对应一个WebService,也就是说,可以发布多个WebService。


② 修改web.xml

<?xml version="1.0" encoding="ISO-8859-1"?>
<web-app xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
version="2.5">
<listener>
<listener-class>
com.sun.xml.ws.transport.http.servlet.WSServletContextListener
</listener-class>
</listener>
<servlet>
<servlet-name>wsService</servlet-name>
<servlet-class>
com.sun.xml.ws.transport.http.servlet.WSServlet
</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>wsService</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>

<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
<welcome-file>index.html</welcome-file>
</welcome-file-list>
</web-app>

或者web.xml如下:

<servlet>
<display-name>Apache-Axis Servlet</display-name>
<servlet-name>AxisServlet</servlet-name>
<servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>

<servlet-mapping>
<servlet-name>AxisServlet</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>

如果说与Spring整合,那么只需要加入spring配置即可:

<context-param>  
<param-name>contextConfigLocation</param-name>
<param-value>classpath:applicationContext.xml</param-value>
</context-param>
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

【3】引入jar

没错,这个超级重要。不是说,没有jar不行,这里强调的是,你可能会遇到这种奇葩的找不到类的问题。

比如,这个类​​org/glassfish/gmbal/ManagedObjectManager​​,是不是没见过?

然后去找,有的说,你只需要引入以下依赖就行了。

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

扯,扯,扯,可能对他真有用,但可能对你无济于事。

继续百度,有的说,需要management-api.jar。

怎么说呢,这个jar真心不好找,你可以试试。

即使,幸运,找到了,你以为就完了?

然而,并没有,还会有其他的类找不到。。。

幸运的是,遇到了我,下面是需要的jar与pom文件

这是服务端的jar截图,有些你可能不需要。

WebService - Axis2基于JAX-WS开发WebService并发布多个WebService_web service


pom.xml如下:

<properties>
<axis2.version>1.6.2</axis2.version>
<jaxws.version>2.2.10</jaxws.version>
</properties>
<!-- axis2 包 -->
<dependency>
<groupId>org.apache.axis2</groupId>
<artifactId>axis2</artifactId>
<version>${axis2.version}</version>
</dependency>
<dependency>
<groupId>org.apache.axis2</groupId>
<artifactId>axis2-kernel</artifactId>
<version>${axis2.version}</version>
</dependency>
<dependency>
<groupId>org.apache.axis2</groupId>
<artifactId>axis2-transport-http</artifactId>
<version>${axis2.version}</version>
</dependency>
<dependency>
<groupId>org.apache.axis2</groupId>
<artifactId>axis2-adb</artifactId>
<version>${axis2.version}</version>
</dependency>
<dependency>
<groupId>org.apache.axis2</groupId>
<artifactId>axis2-transport-local</artifactId>
<version>${axis2.version}</version>
</dependency>
<dependency>
<groupId>org.apache.axis2</groupId>
<artifactId>axis2-adb-codegen</artifactId>
<version>${axis2.version}</version>
</dependency>
<dependency>
<groupId>org.apache.axis2</groupId>
<artifactId>axis2-codegen</artifactId>
<version>${axis2.version}</version>
</dependency>
<dependency>
<groupId>org.apache.axis2</groupId>
<artifactId>axis2-java2wsdl</artifactId>
<version>${axis2.version}</version>
</dependency>
<dependency>
<groupId>org.apache.axis2</groupId>
<artifactId>axis2-json</artifactId>
<version>${axis2.version}</version>
</dependency>
<dependency>
<groupId>org.apache.axis2</groupId>
<artifactId>axis2-metadata</artifactId>
<version>${axis2.version}</version>
</dependency>
<dependency>
<groupId>org.apache.axis2</groupId>
<artifactId>axis2-spring</artifactId>
<version>${axis2.version}</version>
</dependency>
<dependency>
<groupId>org.apache.axis2</groupId>
<artifactId>axis2-xmlbeans</artifactId>
<version>${axis2.version}</version>
</dependency>

<!-- JAXWS 包 -->
<dependency>
<groupId>com.sun.xml.ws</groupId>
<artifactId>jaxws-rt</artifactId>
<version>${jaxws.version}</version>
</dependency>
<dependency>
<groupId>com.sun.xml.ws</groupId>
<artifactId>jaxws-tools</artifactId>
<version>${jaxws.version}</version>
</dependency>
<dependency>
<groupId>com.sun.xml.ws</groupId>
<artifactId>rt</artifactId>
<version>${jaxws.version}</version>
</dependency>
<dependency>
<groupId>com.sun.xml.ws</groupId>
<artifactId>policy</artifactId>
<version>2.3.1</version>
</dependency>
<dependency>
<groupId>org.glassfish.gmbal</groupId>
<artifactId>gmbal-api-only</artifactId>
<version>3.0.0-b023</version>
</dependency>

还有一点,请使用中央仓库下载,因为最后面几个阿里云仓库根本没有,坑死我了!

温馨提示 : 上面的jar可能对你项目不完整,不过几个难缠的已经包括在内,其他的按需自行添加!


【4】发布Tomcat测试

正常启动如下图:

WebService - Axis2基于JAX-WS开发WebService并发布多个WebService_apache_02


wsdl地址:

http://localhost:8080/Axis2WS/services/wsService?wsdl

就是你的正常项目访问路径+xml中配置的address+?wsdl

WebService - Axis2基于JAX-WS开发WebService并发布多个WebService_web service_03


浏览器显示如下:

WebService - Axis2基于JAX-WS开发WebService并发布多个WebService_xml_04


【5】客户端测试

① 根据wsdl,生成Stub到项目下。

② 编写客户端代码如下:

package com.web.client2;

import com.web.client2.MyServiceImplServiceStub.SayHello;
import com.web.client2.MyServiceImplServiceStub.SayHelloResponse;

public class Client {

public static void main(String[] args) throws Exception {
MyServiceImplServiceStub factory = new MyServiceImplServiceStub();
SayHello sayHello = new SayHello();
sayHello.setArg0("Tom");
SayHelloResponse response = factory.sayHello(sayHello );
String result = response.get_return();
System.out.println("Client "+result);
}

}

客户端输出结果如下:

WebService - Axis2基于JAX-WS开发WebService并发布多个WebService_apache_05


服务端输出结果如下:

WebService - Axis2基于JAX-WS开发WebService并发布多个WebService_web service_06


Client使用RPC方式如下:

package com.web.client;

import javax.xml.namespace.QName;

import org.apache.axis2.AxisFault;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.rpc.client.RPCServiceClient;

public class Client {

public static void main(String[] args) {
String url="http://localhost:8080/Axis2WS/services/wsService?wsdl";
String method="sayHello";
RPCServiceClient serviceClient;
try {
serviceClient = new RPCServiceClient();
Options options = serviceClient.getOptions();
EndpointReference targetEPR = new EndpointReference(url);
options.setTo(targetEPR);
QName opAddEntry = new QName("http://impl.service.web.com/","sayHello");

Object[] opAddEntryArgs = new Object[] {"Tom"};
Class[] classes = new Class[] {String.class };
Object[] result=serviceClient.invokeBlocking(opAddEntry,opAddEntryArgs, classes);
System.out.println(result[0].toString());

} catch (AxisFault e) {
// TODO Auto-generated catch block
e.printStackTrace();
}

}
}

【6】多个WebService

就像上面说的一样,在sun-jaxws.xml中进行配置。

演示如下:

① 拷贝MyServiceImpl并重命名为MyServiceImpl2

WebService - Axis2基于JAX-WS开发WebService并发布多个WebService_axis2_07


② 修改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="wsService"
implementation="com.web.service.impl.MyServiceImpl"
url-pattern="/services/wsService" />
<endpoint
name="wsService2"
implementation="com.web.service.impl.MyServiceImpl2"
url-pattern="/services/wsService2" />
</endpoints>

此时,第二个WebService对应wsdl地址为:

http://localhost:8080/Axis2WS/services/wsService2?wsdl

浏览器显示如下:

WebService - Axis2基于JAX-WS开发WebService并发布多个WebService_jax-ws_08


不用拷贝文件,不用配置services.xml是不是很爽?!