在 iOS 中串接既有 Web Service 時,若服務端以 WSDL 描述介面,wsdl2objc 這類開源工具可以協助產生 Objective-C 呼叫程式碼。本文以簡單流程說明如何從建立測試服務、解析 WSDL,到在 App 中取得回傳資料。
先以 ASP.NET 建立測試用 Web Service,並部署到 IIS。服務需提供可回傳集合資料的方法,例如回傳一組包含名稱、編號與上層編號的物件。這個方法可用來驗證 iOS 端是否能正確解析回應。
將 wsdl2objc 指向 WSDL 位址,並設定要產生程式碼的專案路徑。按下解析後,工具會在指定資料夾中產生多個檔案。
完成後,專案中的 Service 資料夾會出現工具生成的程式碼。其中最重要的是代表服務的類別檔,其他檔案多為通用支援程式。
為了讓呼叫邏輯更容易維護,可以建立一個管理器物件,負責建立 SOAP 繫結、送出請求、接收回應,並將結果轉交給介面層。常見步驟如下:
由於 .NET 服務常回傳清單型資料,在 Objective-C 端可用可變陣列承接,再以迴圈取出每筆資料。完成後即可在除錯輸出中看到服務回傳的內容。
透過 wsdl2objc,iOS 端不必自行手刻所有 SOAP 封包。只要掌握 WSDL 解析、程式碼生成與管理器封裝三個步驟,就能較快完成既有 Web Service 的整合。