您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 程式設計入門

J2ME Web 服務 API (JSR 172) 深度解析：遠端服務調用與 XML 解析實作

編輯：Java 程式設計入門

前言

JSR 172 為 J2ME 引入標準 Web 服務支援，包含遠端服務調用（JAX-RPC 子集）與 XML 解析兩個可選包，針對 CLDC 1.0/1.1 與 CDC 架構。開發者無需自行實作 SOAP/WSDL 處理，大幅簡化企業級整合。

一、標準相容性與架構

遵循 SOAP 1.1、WSDL 1.1、XML 1.0、XML Schema 核心規範。
不支援 UDDI 2.0（服務發現）。
符合 WS-I Basic Profile 1.0 互操作性規範。
架構與標準 Web 服務一致：J2ME 應用為服務消費者，透過 Stubs 與 Runtime 呼叫遠端端點（HTTP+SOAP），同步請求-回應模型。建議將調用派發至背景執行緒。

二、支援資料型別映射 (WSDL → Java)

XML Schema	Java 映射	備註
xsd:boolean	boolean / Boolean
xsd:byte/short/int/long	byte/short/int/long (及包裝類)
xsd:float/double	float/double (CLDC 1.0 對應 String)	CLDC 1.0 無浮點支援
xsd:string	String
xsd:base64Binary/hexBinary	byte[]
xsd:complexType	基本型別與類別序列
xsd:QName	javax.xml.namespace.QName
陣列	基本/複雜型別陣列	基於 XML 陣列模式

三、不支援功能

SOAP 附件、訊息處理器、編碼表示
服務端點（不做生產者）、UDDI 發現
裝置端未規定 XML 編碼，允許閘道器使用二進位協定優化傳輸

四、核心套件

javax.microedition.xml.rpc、javax.xml.namespace、javax.xml.rpc、java.rmi（含 RemoteException 等）。應用程式通常不直接呼叫，而是透過工具產生的 Stubs 使用。

五、開發流程：從 WSDL 到呼叫

取得描述目標 Web 服務的 WSDL 文件。
使用 J2ME Wireless Toolkit 2.1 Stubs 產生器，產生 Java Stubs 與支援類（自動處理型別映射）。
編譯、預先驗證、打包部署至支援 JSR 172 的裝置。
程式碼中實例化 Stub、設定端點 URL、Session 維持屬性，然後像呼叫本地方法一樣呼叫遠端方法。

六、程式碼範例

public void startApp() throws MIDletStateChangeException {
    EmployeeService_Stub service = new EmployeeService_Stub();
    service._setProperty(Stub.ENDPOINT_ADDRESS_PROPERTY, "www.example.com/ws");
    service._setProperty(Stub.SESSION_MAINTAIN_PROPERTY, Boolean.TRUE);
    try {
        EmployeeInfo info = service.getEmployee("123");
        // 處理回傳資料...
    } catch (RemoteException e) {
        // 錯誤處理
    }
}