深入解析 J2ME Web 服務 API (JSR 172) 架構與應用

J2ME Web 服務 API 概述

Java 2 Platform, Micro Edition (J2ME) 平台上的 Web 服務是由 Java Specification Request 172 (JSR 172) 定義的。它遵循與標準 Web 服務相同的規範、結構及調用模型，為資源受限的行動裝置帶來企業級的服務整合能力。

核心架構與規範相容性

符合的核心 Web 服務標準

JSR 172 Web 服務 API (WSA) 完整支援以下核心規範：

• SOAP 1.1：定義訊息傳輸與資料編碼格式
• WSDL 1.1：描述遠端服務介面契約
• XML 1.0 與 XML Schema：提供資料標記與型別定義基礎

值得注意的是，JSR 172 不支援 UDDI 2.0（統一描述、發現與整合），因此服務發現機制需由應用層自行實作。此外，JSR 172 遵循 WS-I Basic Profile 1.0，確保與主流 Web 服務堆疊的互通性。

用戶端導向的架構設計

JSR 172 WSA 專為服務消費端設計，架構包含三大角色：

• 客戶端：J2ME 應用程式（MIDP/CDC）、JSR 172 Stubs 與支援類別、JSR 172 Runtime
• 網路層：無線/有線網路與通訊協定；允許執行環境使用二進制編碼（如 WBXML）在裝置與閘道間傳輸，以降低頻寬消耗
• 伺服器端：標準 Web 服務生產者，通常部署於防火牆/Proxy 後方

調用模型採用同步 Request-Response 模式。Stubs 與 Runtime 封裝了 SOAP 封裝/解封、網路通訊等複雜細節，開發者呼叫遠端方法如同呼叫本地方法般直觀。

JAX-RPC 子集 API 與資料型別對應

JSR 172 基於 J2SE JAX-RPC 1.1 子集實作，支援的 XML Schema 到 Java 型別映射如下：

支援以 SOAP 陣列編碼的基本型別與複雜型別陣列。不支援：SOAP with Attachments、SOAP Message Handlers、編碼式 SOAP 訊息、伺服器端端點、UDDI 服務發現。

開發流程：從 WSDL 到呼叫遠端服務

1. 取得 WSDL：服務提供者發布的 WSDL 文件
2. 產生 Stubs：使用 J2ME Wireless Toolkit 2.1 Stub Generator 或同類工具，由 WSDL 產生 Java Stubs 與支援類別
3. 編譯與部署：將產生的程式碼納入專案，編譯後部署至支援 JSR 172 的裝置
4. 呼叫服務：實例化 Stub、完成最少初始化，直接呼叫 Stub 方法

程式碼範例：呼叫遠端服務

import javax.xml.rpc.Stub;
import javax.microedition.xml.rpc.Operation;
import java.rmi.RemoteException;

public class WeatherClient {
    public String getForecast(String city) throws RemoteException {
        // 1. 實例化產生的 Stub
        WeatherService_Stub stub = new WeatherService_Stub();
        
        // 2. 設定端點位址 (可選，若 WSDL 已包含)
        stub._setProperty(Stub.ENDPOINT_ADDRESS_PROPERTY,
            "https://example.com/weather");
        
        // 3. 呼叫遠端方法
        return stub.getForecast(city);
    }
}

關鍵套件結構

JSR 172 遠端調用 API 主要包含以下套件，供 Stubs 與 Runtime 內部使用：

• javax.microedition.xml.rpc
• javax.xml.namespace
• javax.xml.rpc
• java.rmi (含 RemoteException 等 JAX-RPC 相關型別)

應用程式極少直接呼叫這些 API，主要透過產生的 Stubs 進行操作。

最佳實踐與注意事項

• 執行緒處理：遠端調用為阻塞式，務必在背景執行緒中執行，避免封鎖 UI
• 錯誤處理：捕捉 RemoteException 及其子類別，提供重試或離線快取機制
• 資料量控制：行動網路頻寬有限，設計服務介面時應精簡回傳資料結構
• 安全性：生產環境建議搭配 HTTPS 與 WS-Security (需額外實作)

透過 JSR 172，J2ME 應用程式能以標準化、輕量化的方式整合企業後端服務，是行動企業應用開發的關鍵基礎設施。