使用 Eclipse BPEL 插件開發與執行 WS-BPEL 2.0 業務流程：從安裝到部署完整實戰

WS-BPEL 簡介

WS-BPEL（Web Services Business Process Execution Language）由 OASIS 制定，廠商中立規範，將業務流程定義為 Web 服務間互動集合。兩種描述方式：

• 可執行業務流程：建模參與者實際行為。
• 抽象業務流程：部分指定、隱藏具體操作，作為可觀測行為描述或流程模板。

Apache ODE (Orchestration Director Engine) 為 WS-BPEL 2.0 實現，執行流程、與 Web 服務通訊。Eclipse BPEL 專案提供可視化開發插件。本文基於 ODE 1.1 與 Eclipse BPEL M3 示範完整流程。

環境準備與安裝

• OS：Windows/Linux/Mac OS X
• Java 5.0+、Tomcat 5.5+
• Eclipse 3.3.x + 插件：EMF 2.3.x、GEF 3.3.x、DTP STK 1.5.x、WTP 2.0.x

Apache ODE 安裝：下載 ODE，啟動 Tomcat，用 Tomcat Manager (https://localhost:8080/manager/html) 部署 ode.war。驗證：https://localhost:8080/ode/ 顯示狀態。

Eclipse BPEL 安裝：Help > Software Updates > Find and Install > New Remote Site，添加 https://download.eclipse.org/technology/bpel/update-site/，選擇 BPEL Designer for Eclipse 安裝，重啟 Eclipse。

建立簡單 BPEL 流程：HelloWorld

1. File > New > Other > BPEL 2.0 > BPEL Project，建立 HelloWorld 專案。
2. New > Other > BPEL 2.0 > New BPEL Process File，建立同步流程 HelloWorld。
3. 產生輸入/輸出變數 input/output，序列含 receiveInput、replyOutput。
4. 自動生成 WSDL 定義輸入輸出型別（單一字串欄位）與連接埠型別。

添加資料處理：Assign 活動

在 receiveInput 與 replyOutput 間拖放 Assign，設定兩步賦值：

1. 初始化輸出變數：From 選 Fixed Value，輸入 XML 結構 <tns:HelloWorldResponse xmlns:tns="..."><tns:result/></tns:HelloWorldResponse>，To 選 output/payload。
2. 字串串接：From 選 Expression，輸入 XPath 1.0 運算式 concat("Hello ", $input.payload/tns:input)，To 選 output/payload/tns:result。Eclipse BPEL 提供 XPath 高亮與自動完成。

WSDL 完善：綁定與服務

嚮導生成的 WSDL 僅含連接埠型別，需手動添加：

1. 開啟 WSDL 圖形編輯器，右鍵 > Add Binding，命名 HelloWorldBinding，選連接埠型別 HelloWorld，Generate Binding Content > 選 SOAP 協議、document-literal 樣式。
2. 右鍵 > Add Service，命名 HelloWorldService，連接埠 HelloWorldPort，地址 https://localhost:8080/ode/processes/HelloWorld，綁定選 HelloWorldBinding。

部署描述符：deploy.xml

在 BPEL/WSDL 目錄建立 deploy.xml：

<?xml version="1.0" encoding="UTF-8"?>
<deploy xmlns="https://ode.fivesight.com/schemas/2006/06/27/dd"
  xmlns:pns="https://www.ibm.com/wd2/ode/HelloWorld"
  xmlns:wns="https://www.ibm.com/wd2/ode/HelloWorld">
  <process name="pns:HelloWorld">
    <active>true</active>
    <provide partnerLink="client">
      <service name="wns:HelloWorldService" port="HelloWorldPort"/>
    </provide>
  </process>
</deploy>

部署與測試

熱部署：將流程資料夾複製至 Tomcat webapps/ode/WEB-INF/processes，監控 logs/catalina.out。測試：右鍵 WSDL > Web Services > Test with Web Services Explorer，輸入文字呼叫 process 操作，獲取問候語回應。

整合至用戶端應用

用 Eclipse WTP 產生 Axis 基礎用戶端：

1. File > New > Other > Server 添加 Tomcat 伺服器。
2. 右鍵 WSDL > Web Services > Generate Client，產生用戶端專案。
3. 代碼調用：

HelloWorldServiceLocator locator = new HelloWorldServiceLocator();
HelloWorldRequest hwRequest = new HelloWorldRequest();
hwRequest.setInput("developerWorks!");
HelloWorldResponse hwResponse = locator.getHelloWorldPort().process(hwRequest);
String output = hwResponse.getResult();

進階：ODE 管理 API 與事件監聽器

• 管理 API：透過 Web 服務控制流程部署與實例，定義於 pmapi.wsdl（RPC 風格，難用 Web Services Explorer）。建議用 Axis2 ServiceClientUtil（ode-axis2 庫）調用，範例展示列出所有流程實例狀態。
• 事件監聽器：實作 org.apache.ode.bpel.iapi.BpelEventListener，覆寫 onEvent、startup、shutdown。JAR 放入 webapps/ode/WEB-INF/lib，在 ode-axis2.properties 註冊 ode-axis2.event.listeners=全類名。

結語

BPEL 2.0 以圖形化方式建模長期運行工作流，結合 Eclipse BPEL（開發）與 Apache ODE（執行）開源組合，可構建複雜應用。簡單流程驗證成功，但實際業務應用前建議深入評估優缺點。