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

前两篇关于使用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

  
  
    <endpoint 
        name="wsService" 
        implementation="com.web.service.impl.MyServiceImpl" 
        url-pattern="/services/wsService" />  
 

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


② 修改web.xml


<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">
       
        
            com.sun.xml.ws.transport.http.servlet.WSServletContextListener  
        
    
    
        wsService  
        
            com.sun.xml.ws.transport.http.servlet.WSServlet  
        
      
      
        wsService  
        /services/*  
    

   
      index.jsp
      index.html
    

或者web.xml如下:

    
        Apache-Axis Servlet
        AxisServlet
        org.apache.axis2.transport.http.AxisServlet
        1
    

    
        AxisServlet
        /services/*
        

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

       
       contextConfigLocation  
       classpath:applicationContext.xml  
       
       
       org.springframework.web.context.ContextLoaderListener  
       

【3】引入jar

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

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

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

      
          
          
            com.sun.xml.ws  
            jaxws-rt  
            2.2.10  
          
      

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

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

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

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

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

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

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


pom.xml如下:

            
                1.6.2
                2.2.10
            
            
            
                org.apache.axis2
                axis2
                ${axis2.version}
            
            
                org.apache.axis2
                axis2-kernel
                ${axis2.version}
            
            
                org.apache.axis2
                axis2-transport-http
                ${axis2.version}
            
            
                org.apache.axis2
                axis2-adb
                ${axis2.version}
            
            
                org.apache.axis2
                axis2-transport-local
                ${axis2.version}
            
            
                org.apache.axis2
                axis2-adb-codegen
                ${axis2.version}
            
            
                org.apache.axis2
                axis2-codegen
                ${axis2.version}
            
            
                org.apache.axis2
                axis2-java2wsdl
                ${axis2.version}
            
            
                org.apache.axis2
                axis2-json
                ${axis2.version}
            
            
                org.apache.axis2
                axis2-metadata
                ${axis2.version}
            
            
                org.apache.axis2
                axis2-spring
                ${axis2.version}
            
            
                org.apache.axis2
                axis2-xmlbeans
                ${axis2.version}
            

               
              
                com.sun.xml.ws  
                jaxws-rt  
                ${jaxws.version}  
              
            
                com.sun.xml.ws
                jaxws-tools
                ${jaxws.version}
            
            
                com.sun.xml.ws
                rt
                ${jaxws.version}
            
            
                com.sun.xml.ws
                policy
                2.3.1
            
            
                org.glassfish.gmbal
                gmbal-api-only
                3.0.0-b023
            

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

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


【4】发布Tomcat测试

正常启动如下图:

wsdl地址:

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

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


浏览器显示如下:


【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);
    }

}

客户端输出结果如下:


服务端输出结果如下:

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

② 修改sun-jaxws.xml如下:

  
  
    <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" />  
 

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

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

浏览器显示如下:


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

发表评论