Aixs2开发WebService接口 服务端与客户端简单调用

用AXIS2发布WebService的方法

 

Axis2+tomcat6.0 实现webService 服务端发布与客户端的调用

 

Aixs2开发webService的方法有很多，在此只介绍一种比较简单的实现方法。

第一步：首先要下载开发所需要的jar包

 

下载：axis2-1.6.1-war.zip

http://www.apache.org/dist//axis/axis2/java/core/1.6.1/

下载完后解压至tomcat安装目录下的webapps文件夹下，启动tomcat后，在webapps目录下会生成axis2文件夹。

访问http://localhost:8080/axis2/能看到以下页面表示axis2运行成功。

第二部

在Eclipse下新建Web Project，工程名：webServe。新建包com.cm.service，新建类HelloWorld，代码如下：

package com.cm.service;

 

public class HelloWorld{

 

   public String sayHello(String name){return"Hello， "+name+".";}

    public String saySorry(String name){return"Sorry,"+name+".";}

    public String getWorld(){return"Hello,World";}

   

}

 

在WEB-INF目录下修改web.xml文件，内容如下：

<?xmlversion="1.0"encoding="UTF-8"?>

<web-appversion="2.5"

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

   

<!--Axis2 configstart-->

<servlet>

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

 

<!--Axis2  end-->

  <welcome-file-list>

    <welcome-file>index.jsp</welcome-file>

  </welcome-file-list>

</web-app>

 

把tomcat安装目录下的webapps/axis2/WEB-INF下的modules、service和conf文件件拷至HelloWorld下的WEB-INF目录下。把lib下的如下jar包也拷过去。

 

然后在services下新建HelloWorld/META-INF路径，META-INF下新建services.xml，内容如下：

<servicename="HelloWorld"> 

    <description> 

        HelloWorld Service Example

    </description> 

    <parametername="ServiceClass"> 

        com.cm.service.HelloWorld

    </parameter> 

    <operationname="sayHello"> 

        <messageReceiverclass="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/> 

    </operation> 

    <operationname="saySorry"> 

        <messageReceiverclass="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/> 

    </operation> 

    <operationname="getWorld"> 

        <messageReceiverclass="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/> 

    </operation> 

</service>  

 

 

注意：

1.  方法必须都实现MessageReceiver

2.  若全部的方法暴露。可以如下形式：

<?xml version="1.0" encoding="UTF-8"?>

<serviceGroup>

<!—name是指访问的wsdl的webservice的name-->

<service name="BPSService" scope="application">

    <description>

        BPSService

    </description>

   

<!--对方法的配置

<messageReceivers>

        <messageReceiver

           mep="http://www.w3.org/2004/08/wsdl/in-only"

   class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/>

        <messageReceiver

            mep="http://www.w3.org/2004/08/wsdl/in-out"

   class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/>

 </messageReceivers>

 -->

   

 <!-- 另一种配置方式 ，对方法的配置-->  

 <messageReceivers>

   <messageReceivermep="http://www.w3.org/2004/08/wsdl/in-out"

   class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/>

</messageReceivers>

<parameter name="ServiceClass">

      com.test.HelloWorld

</parameter>

</service>

</serviceGroup>

 

启动tomcat后访问http://127.0.0.1:8888/webServe/services/HelloWorld?wsdl能看到服务信息了。

到此Axis2的WebService服务已成功发布

 

Axis2客户端调用：

下面看看利用axis2 客户端调用实例

 

新建一个客户端调用类AxisUtil

代码如下：

package com.cm.client;

 

 

import javax.xml.namespace.QName;

importorg.apache.axis2.addressing.EndpointReference;

import org.apache.axis2.client.Options;

import org.apache.axis2.rpc.client.RPCServiceClient;

 

public class AxisUtil {

    public static void main(String[] args) {

      

       String xmlStr="xiaoxu.wang";

       String url="http://127.0.0.1:8888/webServe/services/HelloWorld";

       String method="saySorry";

       AxisUtil.sendService(xmlStr,url,method);

    }

    public static String sendService(String xmlStr,Stringurl,String method){

       String xml=null;

       try {

          

           RPCServiceClient serviceClient = new RPCServiceClient();

           Options options =serviceClient.getOptions();

           EndpointReference targetEPR = new EndpointReference(url);

           options.setTo(targetEPR);

           // 在创建QName对象时，QName类的构造方法的第一个参数表示WSDL文件的命名空间名，也就是<wsdl:definitions>元素的targetNamespace属性值

            QName opAddEntry = new QName("http://service.cm.com",method);

            // 参数，如果有多个，继续往后面增加即可，不用指定参数的名称

            Object[] opAddEntryArgs = new Object[] {xmlStr};

            // 返回参数类型，这个和axis1有点区别

            // invokeBlocking方法有三个参数，其中第一个参数的类型是QName对象，表示要调用的方法名；

            // 第二个参数表示要调用的WebService方法的参数值，参数类型为Object[]；

            // 第三个参数表示WebService方法的返回值类型的Class对象，参数类型为Class[]。

            // 当方法没有参数时，invokeBlocking方法的第二个参数值不能是null，而要使用new Object[]{}

            // 如果被调用的WebService方法没有返回值，应使用RPCServiceClient类的invokeRobust方法，

            // 该方法只有两个参数，它们的含义与invokeBlocking方法的前两个参数的含义相同

            Class[] classes = new Class[] { String.class };

            xml=(String)serviceClient.invokeBlocking(opAddEntry,opAddEntryArgs,classes)[0];

            System.out.println(xml);

 

 

       } catch (Exception e) {

           e.printStackTrace();

           longend = System.currentTimeMillis();

       }

       return xml;

    }

}

 

运行结果：

Sorry,xiaoxu.wang.

 

 

运用AXIOM方式的客户端调用

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.addressing.EndpointReference;

import org.apache.axis2.client.Options;

import org.apache.axis2.client.ServiceClient;

 

 

public class Test {

   

    private static EndpointReference targetEPR=new EndpointReference("http://192.168.1.200:8080/IntegratedLS/services/HelloWorld");

    public static void main(String[] args) {

       try{

           Options options=new Options();

           options.setTo(targetEPR);

           ServiceClient sender=new ServiceClient();

           sender.setOptions(options);

           options.setAction("urn:sayHello");

          

           //创建request SOAP包。

           OMFactoryfac=OMAbstractFactory.getOMFactory(); 

           // OMNamespace指定此SOAP文档名称空间。

           OMNamespace omNs =fac.createOMNamespace("http://service.com","tc");

           //创建调用方法元素sayHello，并指定其在omNs指代的名称空间中。

           OMElement methodSH =fac.createOMElement("sayHello",omNs);

           //创建sayHello的参数元素，指定其在omNs指代的名称空间。

           OMElement valueSH =fac.createOMElement("name", omNs);

           //指定元素的文本内容。

           valueSH.addChild(fac.createOMText(valueSH,"张三"));

           methodSH.addChild(valueSH);

           //发出request SOAP，

           //同时将得到的远端由sayHello方法返回的信息保存到result。

           //通过services.xml能准确找到sayHello方法所在的文件。

           OMElementresult=sender.sendReceive(methodSH);

           System.out.println(result);

          

       }catch(Exception axisFault){

           axisFault.printStackTrace(); 

       }

    }

}

 

 

总结：以上就是Axis2 服务发布与调用的简单案例。至于其他的实现方法有兴趣的可以继续研究。