Windows 環境下 Axis2/C Web 服務部署完整指南

簡介

Apache Axis2/C 是基於 Axis2 架構的 C 語言 Web 服務引擎，支持 SOAP 1.1/1.2 與 REST 風格。本文記錄在 Windows 7 + Visual Studio 環境下的部署步驟。

環境準備

1. 下載 Axis2/C 二進制包，解壓至目錄（如 D:\axis2c）。
2. 設置環境變量：
   • AXIS2C_HOME = D:\axis2c
   • Path 追加 %AXIS2C_HOME%\lib、%AXIS2C_HOME%\include
3. 將 include 下所有頭文件複製到 VS 包含目錄；lib 下所有 .lib 複製到 VS 庫目錄。

服務端開發與部署

1. 編寫服務實現 hello_svc.c

// 實現服務邏輯，導出 Axis2 要求的入口函數

2. 編譯生成動態庫

// 編譯
cl.exe /D "WIN32" /D "_WINDOWS" /D "_MBCS" /D "AXIS2_DECLARE_EXPORT" /D "AXIS2_SVR_MULTI_THREADED" /w /nologo /I %AXIS2C_HOME%\include /c hello_svc.c

// 鏈接生成 hello.dll
link.exe /nolog /LIBPATH:%AXIS2C_HOME%\lib axutil.lib axiom.lib axis2_parser.lib axis2_engine.lib /DLL /OUT:hello.dll hello_svc.obj

3. 部署服務

• 在 %AXIS2C_HOME%\services 下建立 hello 文件夾，將 hello.dll 放入。
• 在同級目錄建立 services.xml 描述服務元數據（服務名、操作、參數等）。

客戶端開發與測試

1. 編寫客戶端 hello.c，調用 Axis2/C Client API 呼叫服務。
2. 編譯鏈接生成 hello.exe。
3. 啟動服務端：運行 %AXIS2C_HOME%\bin\axis2_http_server.exe。
4. 運行 hello.exe 發起調用，觀察輸出。

常見坑點

• 依賴庫缺失：確保所有 .lib 正確鏈接，運行時 .dll 在 PATH 中。
• 服務描述錯誤：services.xml 格式需符合 Axis2 Schema，否則服務不會被加載。
• 端口衝突：默認 HTTP 監聽 8080，如被佔用需修改 axis2.xml。
• 線程模型：定義 AXIS2_SVR_MULTI_THREADED 宏啟用多線程模式。

結語

Axis2/C 在 Windows 下部署相對繁瑣，需手動處理頭文件、庫文件、環境變量與服務描述。生產環境建議使用 Linux 容器化部署，或改用 gRPC/REST 等現代輕量級 RPC 框架。