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

Tomcat 5.0 與 Axis2 開發 Web Service 深度解析：從 HelloWorld 到核心架構

編輯：Java 相關知識

Axis2 Web Service 開發完整指南

Apache Axis2 是 Axis 的重寫版本，採用全新 AXIOM (AXIs Object Model) 核心，提供更靈活的 XML 處理與多種訊息交換模式。本文透過 HelloWorld 範例深入解析伺服器端實作、部署描述檔、客戶端呼叫與核心架構特性。

範例功能說明

客戶端傳入姓名參數（如 "ZJ"），伺服器端處理後回傳 "ZJHelloWorld!" 字串。

伺服器端實作 (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 {
    // 接收客戶端傳入的 OMElement 參數
    public OMElement sayHello(OMElement in) {
        // 解析輸入參數
        String name = in.getText();
        String info = name + "HelloWorld!";
        
        // 建立回應 SOAP 訊息
        OMFactory fac = OMAbstractFactory.getOMFactory();
        OMNamespace omNs = fac.createOMNamespace("https://helloworld.com/", "hw");
        OMElement resp = fac.createOMElement("sayHelloResponse", omNs);
        resp.setText(info);
        
        return resp;
    }
}

服務部署描述檔 (services.xml)

<?xml version="1.0" encoding="UTF-8"?>
<service name="HelloWorld">
    <description>This is a sample Web Service.</description>
    
    <!-- 指定實作服務的 Java 類別 -->
    <parameter name="ServiceClass" locked="false">sample.HelloWorld</parameter>
    
    <operation name="sayHello">
        <!-- 使用 Raw XML In-Out 訊息接收器 -->
        <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>
    </operation>
</service>

訊息交換模式 (MEP) 解析

Axis2 支援三種訊息交換模式：

模式	說明	適用場景
In-Only	單向請求，無回應	通知、事件發送
Robust-In	請求僅在錯誤時回應	單向但需錯誤處理
In-Out	請求-回應雙向通訊	一般 RPC 風格服務（本範例使用）

客戶端實作 (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(
        "https://localhost:8080/axis2/services/HelloWorld");
    
    public static OMElement getSayHelloOMElement() {
        OMFactory fac = OMAbstractFactory.getOMFactory();
        OMNamespace omNs = fac.createOMNamespace("https://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 = getSayHelloOMElement();
            // 同步呼叫並取得回應
            OMElement result = sender.sendReceive(sayHello);
            System.out.println("回應結果: " + result);
        } catch (Exception axisFault) {
            axisFault.printStackTrace();
        }
    }
}