基于Tomcat5.0和Axis2开发WebService代码详解

1．HelloWorld做了些什么？

HelloWorld功能非常简单，在客户端输入你的姓名，本例中为ZJ。参数传递到服务器端后，经过处理将返回name+”HelloWorld!”，本例中为ZJ HelloWorld!

2．服务器端文件HelloWorld.java

HelloWorld.java

package sample;import org.apache.axiom.om.OMAbstractFacTory;import org.apache.axiom.om.OMElement;import org.apache.axiom.om.OMFacTory;import org.apache.axiom.om.OMNamespace;public class HelloWorld {　　 //读取client端getSayHelloOMElement()方法传递的参数in。　　　 public OMElement sayHello(OMElement in){　　　　 //将in转换为String。　　　　　　　 String name=in.getText();　　　　　　　 String info=name+"HelloWorld!";　　　　 //创建response SOAP包。　　　　　　　 OMFacTory fac=OMAbstractFacTory.getOMFacTory();　　　　 // OMNamespace指定此SOAP文档名称空间。　　　　　　　 OMNamespace mNs=fac.createOMNamespace("http://helloworld.com/","hw");　　　　 //创建元素sayHello，并指定其在omNs指代的名称空间中。　　　　　　　 OMElement resp=fac.createOMElement("sayHelloResponse",omNs);　　　　 //指定元素的文本内容。　　　　　　　 resp.setText(info);　　　　　　　 return resp;　　　 }}

3．services.xml部署文件

services.xml

//下面定义服务名　 This is a sample Web Service.// ServiceClass指定Java Class的位置，即实现服务的类。sample.HelloWorld// operation 与Java Class中方法名对应。// messageReceiver看下文注解。　

注解：消息交换模式。

目前Axis2支持三种模式：In-Only、Robust-In和In-Out。In-Only消息交换模式只有SOAP请求，而不需要应答；Robust-In消息交换模式发送SOAP请求，只有在出错的情况下才返回应答；In-Out消息交换模式总是存在SOAP请求和应答。本例使用In-Out模式。

4．客户端文件TestClient.java

TestClient.java

package example.client;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 TestClient {　　 // targetEPR指定打包的Service（.aar文件）在容器中的物理位置。　　　 private static EndpointReference targetEPR=new EndpointReference　　　　 ("http://localhost:8080/axis2/services/HelloWorld");　　　 public static OMElement getSayHelloOMElement(){　　　　 //创建request SOAP包。　　　　　　　 OMFacTory fac=OMAbstractFacTory.getOMFacTory();　　　　 // OMNamespace指定此SOAP文档名称空间。　　　　　　　 OMNamespace mNs=fac.createOMNamespace("http://helloworld.com/","hw");　　　　 //创建元素sayHello，并指定其在omNs指代的名称空间中。　　　　　　　 OMElement method=fac.createOMElement("sayHello",omNs);　　　　 //指定元素的文本内容。　　　　　　　 method.setText("ZJ");　　　　　　　 return method;　　　 }　　　 public static void main(String[] args){　　　　　　　 try{　　　　　　　　　　 Options ptions=new Options();　　　　　　　　　　 options.setTo(targetEPR);　　　　　　　　　　 ServiceClient sender=new ServiceClient();　　　　　　　　　　 sender.setOptions(options);　　　　　　　　　　 OMElement sayHello=TestClient.getSayHelloOMElement();　　　　　　 //发出request SOAP，//同时将得到的远端由sayHello方法返回的信息保存到result。//通过services.xml能准确找到sayHello方法所在的文件。　　　　　　　　　　 OMElement result=sender.sendReceive(sayHello);　　　　　　　 }　　　　　　　 catch(Exception axisFault){　　　　　　　　　　 axisFault.printStackTrace();　　　　　　　 }　　　 }}

5．Axis2简介

Apache Axis2 是Axis的后续版本，是新一代的SOAP引擎。Axis2的主要特点有：

< 巨龟千岁，却也平淡无奇;昙花瞬间，却能绚丽无比。