BPEL 對映器提供直觀的圖形介面,用於編輯 XPath 運算式。當選取可包含 XPath 的 BPEL 圖元素時,即可開啟對映器視窗。它主要用於 Assign、If、If 的 ElseIf、ForEach、RepeatUntil、While 與 Wait 等流程元素。
不同元素支援不同運算式:If、ElseIf、While、RepeatUntil 使用條件運算式;Assign 使用複製運算式;Wait 使用持續時間運算式;ForEach 則使用帶參數的條件運算式。
在 BPEL 設計器的設計檢視中,可從情境選單選擇「顯示 BPEL 對映器」。若視窗已關閉,也可從主選單選擇「視窗」>「BPEL 對映器」重新開啟。
即使直接編輯 BPEL 原始碼,對映器也會同步顯示修改結果。
BPEL 對映器支援 XPath 1.0。XPath 運算式的結果可為節點集、布林值、數字或字串。
| 運算子 | 描述 | 範例 | 結果 |
|---|---|---|---|
| + | 加法 | 2 + 3 | 5 |
| - | 減法 | 5 - 2 | 3 |
| * | 乘法 | 2 * 5 | 10 |
| div | 除法 | 10 div 2 | 5 |
| mod | 餘數 | 11 mod 3 | 2 |
| - | 一元負號 | -2 | -2 |
XPath 中的數字採浮點表示,可接受 IEEE 754 的常見數值,包括非數字、正負無窮與正負零。
以下範例假設 length = 5.50。
| 運算子 | 描述 | 範例 | 結果 |
|---|---|---|---|
| = | 相等 | length=5.50 | true |
| != | 不相等 | length!=5.50 | false |
| 運算子 | 描述 | 範例 | 結果 |
|---|---|---|---|
| < | 小於 | length<5.50 | false |
| <= | 小於或等於 | length<=5.50 | true |
| > | 大於 | length>5.50 | false |
| >= | 大於或等於 | length>=5.50 | true |
若比較的物件不是節點集,且使用小於、小於等於、大於或大於等於運算子,會先轉換為數字再比較。
以下範例假設 answer = true。
| 運算子 | 描述 | 範例 | 結果 |
|---|---|---|---|
| or | 任一為 true 即 true | false() or answer | true |
| and | 兩者皆 true 才 true | true() and answer | true |
以下範例假設 answer = true,且 XML:lang="en"。
| 名稱 | 描述 | 範例 | 結果 |
|---|---|---|---|
| boolean | 將參數轉換為布林類型 | boolean(2) | true |
| false | 永遠傳回 false | false() | false |
| true | 永遠傳回 true | true() | true |
| not | 傳回布林值的相反結果 | not(false()) | true |
| lang | 判斷語言是否相符 | lang('en') | true |
| 名稱 | 描述 | 範例 | 結果 |
|---|---|---|---|
| round | 取最接近的整數 | round(3.14) | 3 |
| ceiling | 大於或等於參數的最小整數 | ceiling(3.14) | 4 |
| floor | 小於或等於參數的最大整數 | floor(3.14) | 3 |
| number | 將參數轉換為數字 | number(length) | length 的數字值 |
| sum | 將節點集中的數字加總 | sum(/apple/count) | 所有 count 節點總和 |
| Number Literal | 數字常數 | 1.2 | 1.2 |
| 名稱 | 描述 | 範例 | 結果 |
|---|---|---|---|
| string | 將參數轉換為字串 | string(3.14) | '3.14' |
| string-length | 傳回字串長度 | string-length('MyString') | 8 |
| substring | 擷取字串中的一段內容 | substring('1234',2,3) | '234' |
| substring-after | 傳回指定字串第一次出現之後的內容 | substring-after('20-30','-') | '30' |
| substring-before | 傳回指定字串第一次出現之前的內容 | substring-before('14-30','-') | '14' |
| contains | 判斷是否包含指定字串 | contains('XPath','X') | true |
| starts-with | 判斷是否以指定字串開頭 | starts-with('XPath','X') | true |
| concat | 連接兩個字串 | concat('String1 ','String2') | 'String1 String2' |
| normalize-space | 正規化空白字元 | normalize-space(' 1 2 ') | '1 2' |
| translate | 依對應關係替換字元 | translate('black','kcalb','etihw') | 'white' |
| String Literal | 字串常數 | 'String' | 'String' |
以下 SOAP 訊息範例可作為節點集函式的操作對象:
<soapenv:Envelope
xmlns:soapenv="https://schemas.xmlsoap.org/soap/envelope/"
xmlns:syn="https://XML.Netbeans.org/schema/SynchronousSample">
<soapenv:Body>
<syn:typeA>
<syn:paramA>String1</syn:paramA>
<syn:paramA>String2</syn:paramA>
<syn:paramA>String3</syn:paramA>
</syn:typeA>
</soapenv:Body>
</soapenv:Envelope>
| 名稱 | 描述 | 範例 | 結果 |
|---|---|---|---|
| count | 傳回節點集中的節點數量 | count($inputVar.inputType/xs:paramA) | 3 |
| last | 傳回集合中最後一個節點 | $inputVar.inputType/paramA[last()] | String3 |
| position | 傳回節點在集合中的位置 | position() | 目前位置 |
| local-name | 傳回節點的本地名稱 | local-name($inputVar.inputType/xs:paramA) | paramA |
| name | 傳回節點的完整名稱 | name($inputVar.inputType/xs:paramA) | syn:paramA |
| namespace-uri | 傳回命名空間 URI | namespace-uri($inputVar.inputType/xs:paramA) | https://XML.Netbeans.org/schema/SynchronousSample |
| 名稱 | 描述 |
|---|---|
| current-time | 傳回目前時間 |
| current-date | 傳回目前日期 |
| current-dateTime | 傳回目前日期與時間 |
| Duration Literal | 可設定時間間隔,例如 P1Y2M3DT4H5M6S |
圖形化表示方式讓 XPath 運算式更容易分析與檢視。BPEL 對映器允許在視覺模式下建立與編輯運算式,並可設定常數、使用時間函數、處理謂詞,以及對本地或全域變數、XSD 元素與屬性進行計算。