您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

使用 Apache Axis 開發 Web Service 完整指南：Stubs 方式實戰

編輯：Java 相關知識

Axis 環境搭建

所需軟體版本

J2SE SDK 1.4+
Tomcat 5.0+
Eclipse 3.2+ (或其他 IDE)

安裝步驟

從 Apache Axis 官網下載安裝包
將 Axis 核心 JAR 檔放入 WEB-INF/lib 目錄
可選依賴 (activation.jar, mail.jar, xmlsec-1.4.Beta1.jar) 同樣放入 WEB-INF/lib，客戶端生成時需要

Axis 三種開發模式對比

模式	特點	推薦度
Dynamic Invocation Interface (DII)	無需生成 Stub，運行時動態構建 SOAP 請求	低：效能差、除錯難
Dynamic Proxy	JDK 動態代理，介面導向	中：較靈活但類型安全較弱
Stubs (靜態代理)	預生成具體 Stub 類別，強類型、效能最佳、IDE 友善	高：生產環境首選

本文採用 Stubs 方式，業界主流推薦做法。

伺服器端開發流程

1. 編寫服務實作類別

package server;

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

編譯：javac server/SayHello.java

2. 編寫 WSDD 部署描述檔

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

儲存為 deploy.wsdd。

3. 部署服務

建立 deploy.bat：

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

執行後訪問 https://localhost:8080/test/services 驗證服務列表。

客戶端開發流程

1. 獲取 WSDL 並生成 Stub

瀏覽器訪問服務端點 (如 https://localhost:8080/test/services/SayHello?wsdl) 下載 WSDL，儲存為 SayHello.wsdl。

建立 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
%Java_Cmd% org.apache.axis.wsdl.WSDL2Java -o%Output_Path% -p%Package% SayHello.wsdl

生成 4 個核心檔案：

SayHello.java - 服務介面 (PortType)
SayHelloService.java - 服務工廠介面
SayHelloServiceLocator.java - 服務定位器實作
SayHelloSoapBindingStub.java - SOAP 綁定 Stub 實作

2. 編寫客戶端測試代碼

import junit.framework.TestCase;

public class TestWSClient extends TestCase {
    public void testSayHello() throws Exception {
        SayHelloService service = new SayHelloServiceLocator();
        SayHello_PortType client = service.getSayHello();
        String retValue = client.getName("clientName");
        System.out.println(retValue); // 輸出: hello clientName
        assertEquals("hello clientName", retValue);
    }
}