要在 iOS 中呼叫既有的 SOAP WebService,手寫 XML 封裝與解析既繁瑣又易錯。wsdl2objc 這套開源工具能直接依 WSDL 產生 Objective-C 程式碼,省去大量工。
先用 ASP.NET 在 IIS 上搭一個簡單的服務,回傳一個泛型集合:
[WebMethod(Description = "TypeTest for ios")]
public List<TTT> getT()
{
List<TTT> ts = new List<TTT>();
for (int i = 1; i <= 9; i++)
{
TTT t = new TTT();
t.name = "x" + i;
t.id = i;
t.pid = 0;
ts.Add(t);
}
return ts;
}
下載工具後執行,在介面中填入 WSDL 位址與要輸出的專案路徑:

按下 Parse WSDL,等出現 Finished! 字樣,指定資料夾中就會多出一批檔案。

其中 WebService.h/.m 是把 WSDL 解析後的關鍵產物,Produce 相關檔案對應另一個服務,其餘則是每次產生都會附帶的通用類別。
為了讓呼叫邏輯集中管理,建議另外建一個 WebServiceManager 負責實際請求,並用 NSLog 觀察結果:
-(void)getTTT
{
// 1. 建立 SOAP binding 物件
WebServiceSoap12Binding *binding = [WebService WebServiceSoap12Binding];
// 2. 建立 request 物件,用來承載參數
WebService_getT *request = [[WebService_getT alloc] init];
// 3. 送出並取得回應
WebServiceSoap12BindingResponse *response = [binding getTUsingParameters:request];
// 4. 從 bodyParts 中挑出我們要的那一段
NSMutableArray *result;
for (id mine in response.bodyParts) {
if ([mine isKindOfClass:[WebService_getTResponse class]]) {
result = [mine getTResult].TTT;
}
}
// 5. 輸出
for (WebService_TTT *t in result) {
NSLog(@"name: %@ id:%d - pid:%d", t.name, [t.id_ intValue], [t.pid intValue]);
}
}
幾個細節值得說明。.NET 端回傳的是 List 集合,在 iOS 這邊要用 NSMutableArray 接收。即便服務沒有參數,request 物件仍必須建立,否則呼叫會出錯——這是 SOAP 封裝格式的要求。而回應中的 bodyParts 是一個集合,因此要用 isKindOfClass: 過濾出正確的型別,再從中取出 TTT 陣列。
呼叫 getTTT 後,console 會印出九筆資料:
name: x1 id:1 - pid:0 name: x2 id:2 - pid:0 name: x3 id:3 - pid:0 ... name: x9 id:9 - pid:0
wsdl2objc 的價值在於「把 WSDL 換成可讀的 Objective-C 類別」,讓複雜的型別對應自動化。但要提醒幾點:工具產生的是 MRC 風格程式碼,在 ARC 專案中使用時需要調整或將檔案設為不啟用 ARC;產生的類別數量往往可觀,建議只保留實際用到的部分;型別名稱中的底線(如 id_)是因為 Objective-C 保留字而自動改名,讀程式時要多留意。
更根本的問題是:SOAP WebService 屬於較早期的整合方式。若後端可配合調整,改用 RESTful 介面搭配 JSON,在 iOS 端的實作成本會低得多,不必引入額外工具,除錯也直觀。wsdl2objc 最適合的場景,是維護既有企業系統、而對端無法更動的情況。