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文件，内容如下：

<?xml
version="1.0"encoding="UTF-8"?>
<web-app
version="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，内容如下：

<service
name="HelloWorld"> 

    <description> 

        HelloWorld Service Example
    </description> 

    <parameter
name="ServiceClass"> 

        com.cm.service.HelloWorld
    </parameter> 

    <operation
name="sayHello"> 

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

    </operation> 

    <operation
name="saySorry"> 

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

    </operation> 

    <operation
name="getWorld"> 

        <messageReceiver
class="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();
           long
end = 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 服务发布与调用的简单案例。至于其他的实现方法有兴趣的可以继续研究。