Java 使用Axis实现WebService实例

在上一篇WebService实例中，基于jdk1.6以上的javax.jws 发布webservice接口。这篇博文则主要用eclipse/myeclipse 使用axis插件进行发布和调用WebService。

1. 下载axis，并解压到tomcat/webapps目录下

官网地址:http://axis.apache.org/axis2/java/core/download.cgi
下载 axis2-xx-war.zip，并解压到tomcat/webapps

2. 在tomcat部署axis2

启动tomcat, 可以看到多了个axis2文件
在浏览器输入:http://localhost:8080/axis2/
看到axis界面，则成功发布

3. 在eclipse/myeclipse 安装axis插件

将下载下来的axis2-eclipse-codegen-plugin-x.x.x.zip和axis2-eclipse-service-plugin-x.x.x.zip 解压，解压之后的jar文件复制到eclipse/myeclipse 的dropins目录下，重启eclipse/myeclipse，右键File->New->Other 可以看到axis插件已经安装成功。

4. 发布WebService

将下载下来的axis2-x.x.x-bin 解压，将其中的lib架包添加置项目中。
新建class类，用于发布。
编译该类之后，用axis2发布该类。
右键New -> File -> Other -> Axis2 wizards -> Axis2 Services Archiver 。
选择该class类生成的路径，注意只到classes目录下， 然后next，勾上Skip WSDL，点击next，点击next，service填写发布的名称, class name填写路径，包名加上类名，然后选择发布的方法。继续next，选择tomcat/webapps目录下的axis/web-inf/service。
发布成功后，启动tomcat，在浏览器输入:http://localhost:8080/axis2/services/listServices 。可以看到要发布的webservice ，点击该项目，进入wsdl界面。

/**
 * 
* Title: AxisServiceHello
* Description: Axis2 发布
* Version:1.0.0  
* @author panchengming
 */
public class AxisServiceHello {

    /** 供客户端调用方法  
     * @param name  传入参数
     * @return String 返回结果
     * */
    public String getValue(String name){
        return "Axis 欢迎你！ "+name;
    }
}

5. 调用WebService

新建一个class类，用于调用发布的webservice。
可以使用rpc或document两种方法调用，运行main方法，看到打印消息，调用成功。
注:调用需要将tomcat服务启动，在浏览器输入wsdl地址能够查看。

import java.io.IOException;

import javax.xml.namespace.QName;

import org.apache.axiom.om.OMAbstractFactory;
import org.apache.axiom.om.OMElement;
import org.apache.axiom.om.OMFactory;
import org.apache.axiom.om.OMNamespace;
import org.apache.axis2.AxisFault;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.client.ServiceClient;
import org.apache.axis2.rpc.client.RPCServiceClient;


/**
 * 
* Title: AxisClientHello
* Description: webService 客户端调用
* Version:1.0.0  
* @author panchengming
 */
public class AxisClientHello {
    private final static String url="http://192.168.1.105:8080/axis2/services/AxisServiceHello?wsdl"; //wsdl地址 
    private final static String data="PanChengMing";                                                   //参数
    private final static String tns = "http://service.pcm.com";                                        //命名空间
    private final static String method="getValue";                                                //调用的方法

     //调用webservice
    public static void main(String[] args) throws  IOException{
            getRPC();           //调用方法一
            getDocument();      //调用方法二
    }



    /**  
     * 方法一：  
     * 应用rpc的方式调用 这种方式就等于远程调用，  
     * 即通过url定位告诉远程服务器，告知方法名称，参数等， 调用远程服务，得到结果。  
     * 使用 org.apache.axis2.rpc.client.RPCServiceClient类调用WebService  
     *  
        【注】：  

            如果被调用的WebService方法有返回值 应使用 invokeBlocking 方法 该方法有三个参数  
              第一个参数的类型是QName对象，表示要调用的方法名；  
              第二个参数表示要调用的WebService方法的参数值，参数类型为Object[]；  
                当方法没有参数时，invokeBlocking方法的第二个参数值不能是null，而要使用new Object[]{}。  
              第三个参数表示WebService方法的 返回值类型的Class对象，参数类型为Class[]。  
            如果被调用的WebService方法没有返回值 应使用 invokeRobust 方法  
              该方法只有两个参数，它们的含义与invokeBlocking方法的前两个参数的含义相同。  

            在创建QName对象时，QName类的构造方法的第一个参数表示WSDL文件的命名空间名，  
            也就是 <wsdl:definitions>元素的targetNamespace属性值。  
     *  
     */  
     @SuppressWarnings("rawtypes")
    public static void getRPC() throws AxisFault{ 
        RPCServiceClient serviceClient = new RPCServiceClient();
        Options options = serviceClient.getOptions();
        // 指定调用WebService的URL
        EndpointReference targetEPR = new EndpointReference(url);
        options.setTo(targetEPR);

        // 指定要调用的WSDL文件的命名空间及getValue方法
        QName qn = new QName(tns, method);
        // 指定getValue方法的参数值
        Object[] ob = new Object[] { data };
        // 指定getValue方法返回值的数据类型的Class对象
        Class[] classes = new Class[] { String.class };
        // 调用getValue方法并输出该方法的返回值
        System.out.println(serviceClient.invokeBlocking(qn, ob, classes)[0]);
    }

     /**  
      * 方法二： 应用document方式调用  
      * 用ducument方式应用现对繁琐而灵活。现在用的比较多。因为真正摆脱了我们不想要的耦合  
      */  
     public static void getDocument() throws AxisFault{ 
          OMElement result = null;  
          try {  
              Options options = new Options();  
              // 指定调用WebService的URL    
              EndpointReference targetEPR = new EndpointReference(url);  
              options.setTo(targetEPR);         
              ServiceClient sender = new ServiceClient();  
              sender.setOptions(options);  

              OMFactory fac = OMAbstractFactory.getOMFactory();  
              // 命名空间
              OMNamespace omNs = fac.createOMNamespace(tns, "");  

              OMElement ot = fac.createOMElement(method, omNs);  
              OMElement symbol = fac.createOMElement("name", omNs);  
              symbol.addChild(fac.createOMText(symbol, data));  
              ot.addChild(symbol);  
              result=sender.sendReceive(ot);
              System.out.println(result);  
          } catch (AxisFault axisFault) {  
              axisFault.printStackTrace();  
          }  
     }

}

结语:使用axis实现webservice 暂时告一段落了，这次的demo和上篇的webservice的demo 我整合成了一个项目，发布到我的github上了 ,https://github.com/xuwujing/webservice_project 。 有兴趣的可以看看。