WebService 入門實戰：從 WSDL 生成客戶端代碼到手機號碼歸屬地查詢完整教程

WebService 入門實戰：從 WSDL 生成客戶端代碼到手機號碼歸屬地查詢完整教程

1. 什麼是 WebService

WebService 是一個平台獨立、低耦合、自包含的、基於可編程 Web 的應用程式。它使用開放的 XML 標準來描述、發布、發現、協調和配置應用程式，用於開發分散式、互操作的應用程式。

2. WebService 的作用

使運行在不同機器上的不同應用，無需第三方軟硬體即可相互交換資料或整合。無論語言、平台或內部協定，皆可交換資料。易於部署，基於 XML、HTTP 等標準，降低應用介面成本，為企業級業務流程整合提供通用機制。

3. 實戰：手機號碼歸屬地查詢

前置條件

• 安裝 JDK 1.7+ 並配置環境變數（參考：JDK環境變量配置）
• 驗證 wsimport 命令可用：CMD 輸入 wsimport 出現參數說明即成功

獲取 WSDL 並生成客戶端代碼

1. 訪問 WebXml 官網：www.webxml.com.cn
2. 選取「國內手機號碼歸屬地查詢WEB服務」，獲取 WSDL 地址：
   https://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?WSDL
3. 執行生成命令：
   wsimport -s . https://ws.webxml.com.cn/WebServices/MobileCodeWS.asmx?WSDL

整合到專案

將生成的 Java 檔案（包結構 cn.com.webxml）複製到專案對應包目錄下。

編寫測試類調用服務

package cn.com.text;
import cn.com.webxml.MobileCodeWS;
import cn.com.webxml.MobileCodeWSSoap;

public class Text {
    public static void main(String[] args) {
        MobileCodeWS ws = new MobileCodeWS();
        MobileCodeWSSoap soap = ws.getMobileCodeWSSoap();
        // 參數：手機號前7位、商家ID(無則傳null)
        String address = soap.getMobileCodeInfo("1365128", null);
        System.out.println(address);
    }
}

執行結果

控制台輸出手機號歸屬地資訊，表示調用成功。

關鍵點總結： 使用 wsimport 從 WSDL 自動生成客戶端存根代碼，屏蔽了底層 SOAP 通訊細節，開發者僅需像呼叫本地方法一樣調用遠端服務。