基於Tomcat5.0和Axis2開發Web Service應用實例

本文將介紹如何使用Tomcat5.0和Apache Axis2開發、部署及測試一個簡單的Web Service應用。

author: ZJ 07-3-12

Blog: [url]http://zhangjunhd.blog.51cto.com/[/url]

 

1．工做環境

Eclipse 3.1.2 +Lomboz+jdk1.5+ apache-tomcat-5.0.18+AXIS2:1.0(war版本和bin版本)

在[url]http://ws.apache.org/axis2/download/1_0/download.cgi[/url]頁面下，下載AXIS2的Binary Distribution url: [url]http://apache.justdn.org/ws/axis2/1_0/axis2-std-1.0-bin.zip[/url]和war Distribution url: [url]http://apache.justdn.org/ws/axis2/1_0/axis2-1.0-docs.zip[/url]。把這兩個文件解壓，好比解壓縮的後得目錄爲C:\axis2-std-1.0-bin和C:\axis2.war。

在Eclipse下經過菜單window—preferences…--Java—Build Path—User Libraries 新建一個user library,好比名字就叫axis2把C:\axis2-std-1.0-bin\lib下的全部jar文件包含進來。把axis2.war拷貝到%TOMCAT-HOME%/webapps下面。

 

2．檢驗安裝

在Eclipse下啓動Tomcat，在地址欄內輸入[url]http://localhost:8080/axis2/[/url]。

點擊Validate，將到達 Axis2 Happiness Page。

3．WebService中的HelloWorld

1）新建一個動態web工程，取名ZZaxis，右鍵點擊項目名，選擇Properties-Java Build Path-Add Library-User Library-axis2。

 

2）新建package sample，創建HelloWorld.java，代碼以下。

HelloWorld.java

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 {        public OMElement sayHello(OMElement in){               String name=in.getText();               String info=name+"HelloWorld!";               OMFactory fac=OMAbstractFactory.getOMFactory();               OMNamespace omNs=fac.createOMNamespace("http://helloworld.com/","hw");               OMElement resp=fac.createOMElement("sayHelloResponse",omNs);               resp.setText(info);               return resp;        } }

 

3）在WebContent\META-INF\創建services.xml，代碼以下。

services.xml

<?xml version="1.0" encoding="UTF-8"?> <service name="HelloWorld"> <description>   This is a sample Web Service. </description> <parameter name="ServiceClass" locked="false">sample.HelloWorld</parameter> <operation name="sayHello">   <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/> </operation> </service>

 

4）將目錄sample和目錄META-INF組織以下（新建目錄example）。

+-example

|-------- +-sample

    |------- HelloWorld.class

|---------+-META-INF

       |------- services.xml

 

5）打包生成aar文件。

在命令符環境下，將當前目錄轉到example。

jar cvf HelloWorld.aar . //注意最後一個點，在當前目錄下生成HelloWorld.aar。

 

6）在Eclipse中啓動Tomcat，在地址欄下鍵入[url]http://localhost:8080/axis2/[/url]。選擇Administration，輸入用戶名admin，密碼axis2。選擇左側工具欄Tools- Upload Service，上傳以前打包的HelloWorld.aar。該文件將在<CATALINA_HOME>/webapps/axis2\WEB-INF\services目錄下。

 

7）編寫客戶端檢驗代碼。新建Java Project，取名爲ZZaxisClient。右鍵點擊項目名，選擇Properties-Java Build Path-Add Library-User Library-axis2。

 

8）新建package example.client。創建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 {        private static EndpointReference targetEPR=new EndpointReference          ("http://localhost:8080/axis2/services/HelloWorld");        public static OMElement getSayHelloOMElement(){               OMFactory fac=OMAbstractFactory.getOMFactory();               OMNamespace omNs=fac.createOMNamespace("http://helloworld.com/","hw");               OMElement method=fac.createOMElement("sayHello",omNs);               method.setText("ZJ");               return method;        }        public static void main(String[] args){               try{                      Options options=new Options();                      options.setTo(targetEPR);                      ServiceClient sender=new ServiceClient();                      sender.setOptions(options);                      OMElement sayHello=TestClient.getSayHelloOMElement();                      OMElement result=sender.sendReceive(sayHello);                      System.out.println(result);               }               catch(Exception axisFault){                      axisFault.printStackTrace();               }        } }

 

9）測試，run TestClient.java as Java Application。結果：

<hw:sayHelloResponse xmlns:hw="http://helloworld.com/" xmlns:tns="http://ws.apache.org/axis2"> ZJHelloWorld! </hw:sayHelloResponse>

 

4．後續

詳細介紹client和server端代碼。《基於Tomcat5.0和Axis2開發Web Service代碼詳解 》