camunda之——錯(cuò)誤事件(Error Events)

錯(cuò)誤事件(Error Events):

  • 錯(cuò)誤事件是一個(gè)被定義好的錯(cuò)誤觸發(fā)的事件
業(yè)務(wù)錯(cuò)誤VS技術(shù)錯(cuò)誤(Business Errors vs. Technical Errors):

???? BPMN的錯(cuò)誤是業(yè)務(wù)錯(cuò)誤,這與技術(shù)錯(cuò)誤是不一樣的漂坏,所以它與Java的異常是不一樣的

一景埃、定義一個(gè)錯(cuò)誤(Defining an Error):

???? 錯(cuò)誤事件定義會(huì)引用一個(gè)error元素,下面就是一個(gè)error end事件的例子顶别,引用了一個(gè)error申明:

<definitions>
  <error id="myError" errorCode="ERROR-OCCURED" name="ERROR-OCCURED"/>
  <!-- ... -->
  <process>
    <!-- ... -->
    <endEvent id="myErrorEndEvent">
      <errorEventDefinition errorRef="myError" />
    </endEvent>
  </process>
</definitions>

???? 你可以通過拋出一個(gè)在流程中定義的錯(cuò)誤事件來觸發(fā)這個(gè)錯(cuò)誤事件谷徙,或者通過委派給代碼實(shí)現(xiàn),詳情見用戶指南
???? 另一種定義錯(cuò)誤的方式是設(shè)置Java異常的類名驯绎,如下例:

<definitions>
  <error id="myException" errorCode="com.company.MyBusinessException" name="myBusinessException"/>
  <!-- ... -->
  <process>
    <!-- ... -->
    <endEvent id="myErrorEndEvent">
      <errorEventDefinition errorRef="myException" />
    </endEvent>
  </process>
</definitions>
  • 這個(gè)異常應(yīng)該只被用作業(yè)務(wù)異常完慧,而不應(yīng)該被用作技術(shù)異常
  • 錯(cuò)誤事件handler引用了相同的錯(cuò)誤元素,以表明它是來捕獲處理這個(gè)錯(cuò)誤的

???? 錯(cuò)誤事件也可以通過camunda:errorMessage屬性定義一個(gè)錯(cuò)誤消息剩失,來擴(kuò)展錯(cuò)誤元素屈尼,以提供有關(guān)錯(cuò)誤的進(jìn)一步信息。這個(gè)引用錯(cuò)誤事件的定義必須指明camunda:errorMessageVariable去接收錯(cuò)誤消息拴孤,這個(gè)錯(cuò)誤消息也可以包含表達(dá)式脾歧。

<definitions>
  <error id="myError" errorCode="ERROR-OCCURED" name="ERROR-OCCURED"  camunda:errorMessage="Something went wrong: ${errorCause}" />
  <!-- ... -->
  <process>
    <!-- ... -->
    <endEvent id="myErrorEndEvent">
      <errorEventDefinition errorRef="myError" camunda:errorMessageVariable="err"/>
    </endEvent>
  </process>
</definitions>

???? 當(dāng)錯(cuò)誤事件拋出的錯(cuò)誤被捕獲到,會(huì)創(chuàng)建一個(gè)名叫err的流程變量(process variable)演熟,用以保存解析出來的消息鞭执。

二、錯(cuò)誤開始事件(Error Start Event):

  • 錯(cuò)誤開始事件只能被用作觸發(fā)一個(gè)事件子流程绽媒,它不能被用作發(fā)起一個(gè)流程實(shí)例蚕冬,錯(cuò)誤開始事件是可中斷的
圖1:錯(cuò)誤開始事件

???? 錯(cuò)誤開始事件有三個(gè)可選屬性:errorRef、camunda:errorCodeVariable和camunda:errorMessageVariable

<definitions>
  <error id="myException" errorCode="com.company.MyBusinessException" name="myBusinessException"/>
  ...
  <process>
    ...
    <subProcess id="SubProcess_1" triggeredByEvent="true">>
      <startEvent id="myErrorStartEvent">
        <errorEventDefinition errorRef="myException" camunda:errorCodeVariable="myErrorVariable" camunda:errorMessageVariable="myErrorMessageVariable" />
      </startEvent>
    ...
    </subProcess>
  ...
  </process>
</definitions>

1.如果errorRef屬性被省略掉是辕,那么任何一個(gè)錯(cuò)誤事件發(fā)生,都會(huì)導(dǎo)致一個(gè)錯(cuò)誤子流程被發(fā)起
2.camunda:errorCodeVariable可以包含一個(gè)由錯(cuò)誤指定的錯(cuò)誤碼
3.camunda:errorMessageVariable可以包含一個(gè)由錯(cuò)誤指定的錯(cuò)誤消息

???? 如果流程中設(shè)置了camunda:errorCodeVariable和camunda:errorMessageVariable屬性猎提,那么在流程中可以像獲取其他變量一樣獲取這兩個(gè)屬性

三获三、錯(cuò)誤結(jié)束事件(Error End Event):

???? 當(dāng)流程執(zhí)行到錯(cuò)誤結(jié)束事件時(shí)蜻底,當(dāng)前路徑執(zhí)行結(jié)束侈询,并且向外拋出換一個(gè)錯(cuò)誤,這個(gè)錯(cuò)誤可以被匹配的中間錯(cuò)誤邊界事件(intermediate error boundary event)捕獲,如果沒有匹配的錯(cuò)誤邊界事件谦趣,這個(gè)執(zhí)行的語義跟默認(rèn)跟空結(jié)束事件的語義類似(啥也不干)

四、錯(cuò)誤邊界事件(Error Boundary Event):

???? 依附于一個(gè)活動(dòng)的邊界上的中間捕獲錯(cuò)誤事件或者簡(jiǎn)稱為錯(cuò)誤邊界事件铲汪,用于捕獲定義于這個(gè)活動(dòng)作用域內(nèi)的錯(cuò)誤叛溢。
???? 大多數(shù)場(chǎng)景下定義一個(gè)錯(cuò)誤邊界事件是為了包含一個(gè)子流程或者調(diào)用一個(gè)活動(dòng),作為一個(gè)子流程裸弦,會(huì)為所有包含在子流程內(nèi)的活動(dòng)創(chuàng)建一個(gè)作用域祟同。錯(cuò)誤會(huì)被錯(cuò)誤結(jié)束事件拋出,這個(gè)錯(cuò)誤會(huì)傳播到它的父作用域理疙,直到有一個(gè)匹配的錯(cuò)誤邊界事件晕城。
???? 當(dāng)錯(cuò)誤事件被捕獲,錯(cuò)誤邊界事件就會(huì)被銷毀窖贤,也會(huì)銷毀所有當(dāng)前包含在子流程里的活動(dòng)砖顷,流程會(huì)沿著錯(cuò)誤邊界事件所在的路徑進(jìn)行

圖2:錯(cuò)誤邊界事件

???? 錯(cuò)誤邊界事件時(shí)一個(gè)典型的邊界事件,和其他錯(cuò)誤事件一樣赃梧,errorRef引用一個(gè)定義在process元素之外的error

<definitions>
  <error id="myError" errorCode="ERROR-OCCURED" name="name of error"/>
  <!-- ... -->
  <process>
    <!-- ... -->
    <subProcess id="mySubProcess">
      <!-- ... -->
    </subProcess>
    <boundaryEvent id="catchError" attachedToRef="mySubProcess">
      <errorEventDefinition errorRef="myError" camunda:errorCodeVariable="myErrorVariable"
        camunda:errorMessageVariable="myErrorMessageVariable" />
    </boundaryEvent>
  </process>
</definitions>

errorCode被用作匹配其他被捕獲到的錯(cuò)誤:
???? 1.如果errorRef被忽略掉滤蝠,錯(cuò)誤邊界事件會(huì)捕獲所有的錯(cuò)誤事件,不管是什么錯(cuò)誤的errorCode
???? 2.如果errorRef有授嘀,并且它引用一個(gè)存在的錯(cuò)誤物咳,邊界事件將只會(huì)捕獲定義過error code的錯(cuò)誤
???? 3.如果errorCodeVariable被設(shè)置過,error code可以被提取出來用作變量
???? 4.如果errorMessageVariable被設(shè)置粤攒,error message可以被提取出來用作變量

五所森、沒有處理的BPMN錯(cuò)誤(Unhandled BPMN Error):

???? 如果發(fā)生的錯(cuò)誤事件沒有被定義錯(cuò)誤邊界事件,在這種情況下夯接,默認(rèn)行為是打印log日志并結(jié)束當(dāng)前任務(wù)焕济,這個(gè)行為可以通過設(shè)置enableExceptionsAfterUnhandledBpmnError屬性為true來改變,如果沒有處理的BPMN錯(cuò)誤發(fā)生盔几,一個(gè)流程引擎錯(cuò)誤將會(huì)被拋出

六晴弃、捕獲并再次拋出模式(Catch and Re-Throw Pattern):

???? 錯(cuò)誤事件可以在錯(cuò)誤開始事件中被handle,子流程可以拋出跟它handle的相同的錯(cuò)誤到更高級(jí)的作用域里
圖3:捕獲并再次拋出相同的錯(cuò)誤
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末逊拍,一起剝皮案震驚了整個(gè)濱河市上鞠,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌芯丧,老刑警劉巖芍阎,帶你破解...
    沈念sama閱讀 222,627評(píng)論 6 517
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異缨恒,居然都是意外死亡谴咸,警方通過查閱死者的電腦和手機(jī)轮听,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 95,180評(píng)論 3 399
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來岭佳,“玉大人血巍,你說我怎么就攤上這事∩核妫” “怎么了述寡?”我有些...
    開封第一講書人閱讀 169,346評(píng)論 0 362
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)叶洞。 經(jīng)常有香客問我鲫凶,道長(zhǎng),這世上最難降的妖魔是什么京办? 我笑而不...
    開封第一講書人閱讀 60,097評(píng)論 1 300
  • 正文 為了忘掉前任掀序,我火速辦了婚禮,結(jié)果婚禮上惭婿,老公的妹妹穿的比我還像新娘不恭。我一直安慰自己,他們只是感情好财饥,可當(dāng)我...
    茶點(diǎn)故事閱讀 69,100評(píng)論 6 398
  • 文/花漫 我一把揭開白布换吧。 她就那樣靜靜地躺著,像睡著了一般钥星。 火紅的嫁衣襯著肌膚如雪沾瓦。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 52,696評(píng)論 1 312
  • 那天谦炒,我揣著相機(jī)與錄音贯莺,去河邊找鬼。 笑死宁改,一個(gè)胖子當(dāng)著我的面吹牛缕探,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播还蹲,決...
    沈念sama閱讀 41,165評(píng)論 3 422
  • 文/蒼蘭香墨 我猛地睜開眼爹耗,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來了谜喊?” 一聲冷哼從身側(cè)響起潭兽,我...
    開封第一講書人閱讀 40,108評(píng)論 0 277
  • 序言:老撾萬榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎斗遏,沒想到半個(gè)月后山卦,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 46,646評(píng)論 1 319
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡诵次,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,709評(píng)論 3 342
  • 正文 我和宋清朗相戀三年怒坯,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了炫狱。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片藻懒。...
    茶點(diǎn)故事閱讀 40,861評(píng)論 1 353
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡剔猿,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出嬉荆,到底是詐尸還是另有隱情归敬,我是刑警寧澤,帶...
    沈念sama閱讀 36,527評(píng)論 5 351
  • 正文 年R本政府宣布鄙早,位于F島的核電站汪茧,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏限番。R本人自食惡果不足惜舱污,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 42,196評(píng)論 3 336
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望弥虐。 院中可真熱鬧扩灯,春花似錦、人聲如沸霜瘪。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,698評(píng)論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽颖对。三九已至捻撑,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間缤底,已是汗流浹背顾患。 一陣腳步聲響...
    開封第一講書人閱讀 33,804評(píng)論 1 274
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留个唧,地道東北人江解。 一個(gè)月前我還...
    沈念sama閱讀 49,287評(píng)論 3 379
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像坑鱼,于是被迫代替她去往敵國和親膘流。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,860評(píng)論 2 361