IBM Lotus Expeditor 中構建與部署 WS-Resource：從建模到客戶端整合完整指南

Web 服務資源框架 (WSRF) 定義了有狀態資源的 Web 服務存取標準。IBM Lotus Expeditor 整合 WSRF，允許將 OSGi 服務作為資源發布。本文完整演示從領域建模、資源 Bundle 開發、提供者端組件生成、適配器綁定、客戶端生成到部署測試的全流程。

WS-Resource 四大組件架構

• 資源 Bundle：封裝有狀態 OSGi 服務對象（如 Address 實體）。
• Web 服務 Bundle：暴露 WSRF 標準與自訂 PortType 的 SOAP 端點。
• 適配器 Bundle：橋接 Web 服務與資源，路由訊息至特定資源實例。
• 客戶端存根：將 Java API 轉換為 SOAP 訊息的 Jar 包。

領域建模：Address 資源

屬性：eMailID、preference、personDetails、contactInfo。工廠介面 AddressFactoryInterface 支援建立、刪除、查詢實例。

資源 Bundle 實現要點

• 介面 AddressInterface 以 Bean 風格定義屬性存取與服務方法。
• Activator 註冊 AddressFactoryImpl 而非單個 Address，便於多實例管理。

Mobile Web Services 生成器向導：提供者端組件

1. 指定 AddressFactoryInterface 為資源類，自動推導 Bean 屬性為資源屬性。
2. 勾選「WS-Resource Lifetime」與「Expose Service Methods」。
3. 選擇所有資源屬性與設計模型中的服務方法。
4. 生成 AddressAdapter 與 AddressWebservice 兩個專案。

適配器綁定：四大管理器實現

LifeTimeManager：資源生命週期

• createResource：解析 ConfigInfo XML 取得 eMailID，調用工廠建立實例，返回 ResourceConfiguration（含 EndPointReference 參考參數）。
• getResource：從 ResourceConfiguration 取得 eMailID，調用工廠查找實例。
• destroyResource：同樣解析標識符，調用工廠刪除。

PropertyManager：資源屬性同步

為每個屬性實現 get/update/insert/delete。範例中 preference 的 update/insert 映射至 setPreference，get 映射至 getPreference，delete 拋異常（強制屬性）。

ServiceManager：服務方法直通

生成代碼已自動綁定至資源實例方法，無需修改。

客戶端組件生成與測試

1. 部署提供者端組件啟動 Client Services Server。
2. 驗證 https://localhost/ws/pid/Address?wsdl 可訪問。
3. 使用 WS-Resource Client 向導生成存根，無需修改代碼。

測試客戶端關鍵邏輯

// 建立資源
EndpointReference resEPR = tc.createResource("wsrf_support@ibm.com");

// 設定 OperationContext 建立通道
OperationContext opContext = new OperationContext();
opContext.setToEPR(resEPR);
AddressSoap_Stub stub = new AddressSoap_Stub();
stub.setCurrentOperationContext(opContext);

// 測試 WSRF 標準操作：更新資源屬性
tc.testUpdateResourceProperty();

// 測試自訂服務方法：新增依賴項
tc.testAddDependants();

ConfigInfo XML 結構需與適配器解析邏輯一致：

<ConfigInfo>
  <AddressResource/>
  <eMailID>wsrf_support@ibm.com</eMailID>
</ConfigInfo>

部署至 Lotus Expeditor Client

1. 建立 Feature 專案，包含 AddressResource、AddressAdapter、AddressWebservice。
2. 匯出為可部署 Feature。
3. Client 中「File > Applications > Install」安裝 Feature，重啟生效。
4. 驗證 WSDL 發布與控制台插件狀態。

圖形化測試客戶端

基於 SWT 的測試程式提供選單操作 WSRF 標準操作（資源屬性、生命週期）與自訂操作（工廠、服務方法），直觀驗證功能。

總結

Lotus Expeditor 的 WSRF 實現將 OSGi 服務標準化為有狀態 Web 服務資源，工具鏈覆蓋建模、生成、綁定、部署、測試全生命週期。掌握適配器綁定邏輯是核心關鍵，實現 SOAP 訊息與領域模型的無縫轉換。