axis2开发web services实例

1.安装axis2.下载axis2发布包axis2-1.4.1-war.zip，解压后激昂axis2.war复制到tomcat下的webapps目录下。下载地址：http://ws.apache.org/axis2/。

2.验证是否发布成功。启动tomcat，打开“http://localhost:8080/axis2”，可以看到axis2的欢迎界面。点击“Services”可以查看当前已经发布的服务。

3.创建要发布的服务类SampleService.java。
 

1. package axis2;
3.  import javax.xml.stream.XMLStreamException;
4.  import org.apache.axiom.om.OMAbstractFactory;
5.  import org.apache.axiom.om.OMElement;
6.  import org.apache.axiom.om.OMFactory;
7.  import org.apache.axiom.om.OMNamespace;
9.  public class SampleService {
11.   public OMElement sayHello(OMElement element) throws XMLStreamException {
12.    element.build();
13.    element.detach();
15.    String rootName = element.getLocalName();
16.    System.out.println("Reading " + rootName + " element");
18.    OMElement childElement = element.getFirstElement();
19.    String personToGreet = childElement.getText();
21.    OMFactory fac = OMAbstractFactory.getOMFactory();
22.    OMNamespace omNs = fac.createOMNamespace("http://example1.org/example1", "example1");
23.    OMElement method = fac.createOMElement("sayHelloResponse", omNs);
24.    OMElement value = fac.createOMElement("greeting", omNs);
25.    value.addChild(fac.createOMText(value, "Hello," + personToGreet));
26.    method.addChild(value);
28.    return method;
29.   }
31.   private void ping() {
32.   }
34.  }

4.创建服务描述文件services.xml。服务描述文件定义了可用的消息接收类。

 

1.  <service name="UserGuideSampleService">
2.      <description>
3.   This is a sample service created in the Axis2 User's Guide
4.      </description>
6.      <parameter name="ServiceClass">
7.   axis2.SampleService
8.      </parameter>
10.      <operation name="sayHello">
11.   <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>
12.      </operation>
13.      <operation name="ping">
14.   <messageReceiver class="org.apache.axis2.receivers.RawXMLINOnlyMessageReceiver"/>
15.      </operation>
16.  </service>

5.生成aar文件。在根目录下新建一个名为META-INF的文件夹，此文件夹与class下的axis2目录位于同一位置。将services.xml文件复制到META-INFO目录下。此时的文件路径如下：
      根目录
        |- META-INF
        |      |-services.xml
        |
        |- axis2
        |    |-SampleService.class

 

从命令行进入根目录，执行命令： 

1. jar cvf SampleService.aar ./*

生成SampleService.aar文件。
这一步也可以直接从eclipse中导出jar文件，然后将扩展名修改为.aar。

6.发布服务。将 SampleService.aar复制到%TOMCAT_HOME%/webapps/axis2/WEB-INF/services目录下。打开该目录下的services.list文件，在末尾增加一行，“SampleService.aar”。

7.查看服务。打开“http://localhost:8080/axis2”，点击“Services”可以看到刚才发布的服务了。

8.创建客户端调用程序。执行前确保已经将axis2.war/lib目录下的jar包引入工程。

 

1. package axis2;
3.  import org.apache.axiom.om.OMAbstractFactory;
4.  import org.apache.axiom.om.OMElement;
5.  import org.apache.axiom.om.OMFactory;
6.  import org.apache.axiom.om.OMNamespace;
7.  import org.apache.axis2.Constants;
8.  import org.apache.axis2.addressing.EndpointReference;
9.  import org.apache.axis2.client.Options;
10.  import org.apache.axis2.client.ServiceClient;
12.  public class SampleClient {
14.   private static EndpointReference targetEPR = new EndpointReference("http://localhost:8080/axis2/services/UserGuideSampleService");
16.   public static OMElement greetUserPayload(String personToGreet) {
17.    OMFactory fac = OMAbstractFactory.getOMFactory();
18.    OMNamespace omNs = fac.createOMNamespace("http://example1.org/example1", "example1");
19.    OMElement method = fac.createOMElement("sayHello", omNs);
20.    OMElement value = fac.createOMElement("personToGreet", omNs);
21.    value.addChild(fac.createOMText(value, personToGreet));
22.    method.addChild(value);
23.    return method;
24.   }
26.   public static void main(String[] args) {
27.    try {
28.     OMElement payload = SampleClient.greetUserPayload("John");
29.     Options options = new Options();
30.     options.setTo(targetEPR);
32.     options.setTransportInProtocol(Constants.TRANSPORT_HTTP);
34.     ServiceClient sender = new ServiceClient();
35.     sender.setOptions(options);
36.     OMElement result = sender.sendReceive(payload);
38.     String response = result.getFirstElement().getText();
39.     System.out.println(response);
41.    } catch (Exception e) { //(XMLStreamException e) {
42.     System.out.println(e.toString());
43.    }
44.   }
46.  }

执行程序，可以看到输出“Hello,John”，调用成功。