Axis開發Web Service 小例子

這裡整理了一些通過Axis開發Web Service的一些要點，希望能讓不熟悉Web Service的開發人員能夠迅速掌握Web Service。

　　一、Axis環境的安裝

　　1、安裝環境 J2SE SDK 1.4，Tomcat 5.0，eclipse 3.2。

　　2、到 http://xml.apache.org 網站下載Axis安裝包。

　　3、將Axis相關包檔案放在WEB-INF/lib目錄下。

　　4、Axis可選的包：activation.jar； mail.jar； xmlsec-1.4.Beta1.jar拷貝到WEB-INF目錄下，產生用戶端時候需要使用。

　　Axis支援三種web service的部署和開發，分別為：

　　1、Dynamic Invocation Interface （DII）

　　2、Dynamic Proxy方式

　　3、Stubs方式

　　前兩種方式我就不介紹了，同事告訴我他們自己都不使用前兩種方式，他們建議我們使用Stubs方式，因此我就主要就介紹一下第三種方式。注意，我自己的Java原始碼是放在D：/workspace/test/目錄下，Axis相關包檔案放在D：/workspace/test/WEB-INF目錄下。

　　二、編寫wsdd發布web服務，編寫stub client訪問web服務

　　1、編寫服務端程式server，SayHello.java，編譯server.SayHello.java

package server;
public class SayHello
{
    public String getName(String name)
    {
        return "hello "+name;
    }
}

　　2、編寫wsdd檔案

　　deploy.wsdd檔案內容如下：

<deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
 <service name="SayHello" provider="java:RPC">
  <parameter name="className" value="server.SayHello.getName"/>
  <parameter name="allowedMethods" value="*"/>
 </service>
</deployment>

　　3、發布服務：

　　編輯一個deploy.bat，Axis_Lib為axis.jar路徑。內容如下：

set Axis_Lib=D:/workspace/test/WEB-INF/lib
set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%
set Axis_Servlet=http://localhost:8080/test/servlet/AxisServlet
%Java_Cmd% org.apache.axis.client.AdminClient -l%Axis_Servlet% deploy.wsdd

　　執行這個批次檔，這時候，如果提示成功的話，訪問http://localhost:8080/test/services 就會顯示服務列表。

　　4、產生用戶端client stub檔案

　　在瀏覽器上訪問伺服器端的服務，可以下載到WSDL檔案，通過Axis的相關工具，可以自動從WSDL檔案中產生Web Service的用戶端代碼。

　　編寫一個WSDL2Java.bat檔案，其內容如下：

set Axis_Lib=D:/workspace/test/WEB-INF/lib
set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%
set Output_Path=D:/workspace/test/src
set Package=server.SayHello
%Java_Cmd% org.apache.axis.wsdl.WSDL2Java -o%Output_Path% -p%Package% SayHello.wsdl

　　執行這個批次檔就可以產生client stub.

　　產生的stub client檔案清單為：SayHello.java，SayHelloService.java，SayHelloServiceLocator.java，SayHelloSoapBindingStub.java .

　　5、編寫用戶端程式，編譯並執行

　　下面是一段junit測試用戶端代碼。

import java.net.URL;
import junit.framework.Test;
import junit.framework.TestCase;
import junit.framework.TestSuite;

public class TestWSClient extends TestCase {

    public TestWSClient(String string) {
        super(string);
    }

    public void SayHelloClient() throws Exception {

        SayHelloService service = new SayHelloServiceLocator();
        SayHello_PortType client = service.getSayHello() ;
        String retValue = client.getName("clientname");
        System.out.println(retValue);

    }

    public static Test suite() {
        TestSuite suite = new TestSuite();
        suite.addTest(new TestWSClient("SayHelloClient"));
        return suite;
    }
}