workflow engine Ruote初体验之二(通用属性)
罗列一下表达式所支持的属性:
- :timeout
- :if/ unless
- :forget
- :lose
- :flank
- :on_error
- :on_cancel
- :on_timeout
- :tag
- :filter
- :take
- :discard
- :timers
- :scope
- :await
:time
下面举个例子,如果两个参与者过两天之后还没有做他们的工作,这个工作流程会提交给editor:
sequence do
participant :ref => 'author'
sequence :timeout => '2d' do
participant :ref => 'reviewer1'
participant :ref => 'reviewer2'
end
participant :ref => 'editor'
end
:time不仅能够处理h,m,d,s(依次表示hour,minute,day,second)模式的时间定义,而且能够处理y,M,w(分别表示year,Month,week)的模式。
就算是你给timeout传递一个绝对时间也没有问题,完全能够处理:
participant :ref => 'author', :timeout => 'Sun Jan 24 17:28:28 +0900 2010'
在真实的项目中,timeout的参数一般都是取自工作流程中的变量或者传递进来的参数。
participant :ref => 'author', :timeout => '${f:time_limit}'
:if/ :unless
这两个属性接收一个字符串的条件,如果这个字符串的值是true(或者:unless的参数的值是false),表达式就会执行,看下面的列子:
concurrence do
participant 'ceo', :if => '${f:budget} > 23000'
participant 'cfo'
participant '${f:bu_head}'
end
这个意思就是:如果这个工作流程中的预算配置大于23000,那么CEO就会收到一个工作流程的任务。:if :unless条件能够处理!=、==、=~、"is set"、"is empty"、&&、||等操作符。
:forget
当一个表达式用:forget=>true 或者:forget=>'true',获取将要被“遗忘”的操作。被“遗忘”操作的返回值将被忽略:
concurrence do
participant 'alfred'
participant 'bob'
participant 'charly', :forget => true
end
charly将会收到一个工作流程,同时concurrence立即收到一个回复。就是说在Alfred和Bob回复了以后,concurrence就会恢复。
:lose
从来不向他的父表达式回复,
Ruote.process_definition do
concurrence :count => 1 do
alfred
lose do
sequence do
wait '2d'
send_reminder_to_alfred
wait '2h'
send_alarm_to_boss
end
end
end
end
像这个列子中,reminding从来不向concurrence 回复。concurrence在alfred回复以后就结束了。
:flank
前面的lost中的列子可以用下面这段代码重写:
Ruote.process_definition do
sequence do
sequence :flank => true do
wait '2d'
send_reminder_to_alfred
wait '2h'
send_alarm_to_boss
end
alfred
end
end
Flanking表达式会立刻向他的父表达式返回,但是仍然可以取消,因为Flanking表达式可以取消,所以他们的生命周期肯定不会比他的父表达式长。
Ruote.process_definition do
sequence do
bob :task => 'support work', :flank => true
alfred :task => 'main effort'
end
end
所以在这个例子中,在alfred完成他的'main effort'任务,bob的'support work'即将终止,因为他的父表达式已经结束了。
下面概括一下forget, lose and flank的区别:
:on_error
默认情况下,在一个工作流程中发生的任何的任何错误都能获取日志和发生错误的地方。在过程定义的时候直接指定“on error”的行为:
Ruote.define :name => 'x' do sequence :on_error => 'handle_issue' do
participant 'alpha'
cursor do
# ...
end
end define 'handle_issue' do
participant 'supervisor', :msg => 'process ${wfid} has gone ballistic'
end
end
如果在sequence 中发生错误,那么sequence 整个分支就会取消,:on_error必须指定一个子过程或者一个参与者或者像“redo”, “undo”, “cancel”这些命令。
:on_cancel
on_cancel是用来指定一个子过程或者参与者,当当前过程取消的时候,设置的子过程会被调用,或者参与者收到一个工作条目。
pdef = Ruote.process_definition :name => 'aircraft carrier' do
cursor :on_cancel => 'decommission' do
concurrence do
participant 'naval team', :task => 'operate ship'
participant 'air team', :task => 'operate planes'
end
end
define 'decommission' do
concurrence do
participant 'naval team', :task => 'decom weapons'
participant 'air team', :task => 'decom aircrafts'
end
end
end
上面这个过程中, “the aircraft”是一个操作,当操作取消的时候,子过程‘decommission’被触发,里面的naval team和air team获取对应的任务。
和:on_error有点不一样的是,当一个表达式在:on_cancel表达式中被取消掉的话,将不会触发:on_cancel.例如上面的列子中“operate planes”这个活动的取消不会激活‘decommission’。只有cursor或者整个过程实例被取消的时候才能触发‘decommission’。
:on_timeout
上面描述的了:timeout属性。:on_time属性是一个补充,它表示在timeout触发的时候调用什么子过程,或者通知某个参与者。除了子过程和参与者者,:on_timeout还可以使用‘redo’,‘error’作为值。
sequence do
participant 'author'
participant 'reviewer', :timeout => '3d', :on_timeout => 'redo'
participant 'editor'
end
在这个列子中,reviewer每3天收到一个新的工作条目,直到他回复了这个工作流程。回复了之后将回复到editor参与者。
:tag
tag属性用来标记一个工作过程的一个阶段。
Ruote.process_definition do
sequence do
sequence :tag => 'phase 1' do
alice
bob
end
sequence :tag => 'phase 2' do
charly
david
end
end
end
例子中的tags将出现在工作流程的变量中:
p engine.process(wfid).tags.keys
# => [ "phase 1" ]
:filter
Ruote2.2.0引进了一个:filter属性。
Ruote.process_definition do set 'v:f' => {
:in => [
{ :fields => '/^private_/', :remove => true }
],
:out => [
{ :fields => '/^private_/', :restore => true },
{ :fields => '/^protected_/', :restore => true },
]
} alpha
sequence :filter => 'f' do
bravo
charly
end
delta
end
在这个例子中,filter被保存在变量f中,当过程经过alpha进去sequence的时候,调用filter的in端,这个工作条目中以”private_“开始的内容被移除,接下来的bravo,charly不能够访问。当charly执行完成以后,调用dilter的out端的流程。
:take and :discard
:timers
这个比较好理解,下面看一个列子:
Ruote.define do
# ...
alice :timers => '5d: reminder, 12d: final_reminder, 15d: timeout'
# ...
end
这个例子表示为,alice收到一个任务,她有15天来完成她,在5天以后她会收到一个提醒,在12天以后会收到一个最后一次提醒。模式为"时间段1:action1,时间段2:action2,....,时间段3:action3"。actionx可以是一个参与者的名字,也可以是一个子过程,或者一组定义好的关键字。
timeout:
alice :timers => '1h: timeout'
# is equivalent to
alice :timeout => '1h'
error:过来给定的时间,表达式强制转换成error
alice :timers => '1h: reminder, 12h: error'
在从error结束开始,到字符串的末尾或者附近的一个逗号中的字符串是错误信息。
undo, pass
alice :timers => '1h: reminder, 12h: error it went wrong'
在指定的12个小时内没有完成工作,那么就忽略alice了,转交给bravo.
redo,retry
alice :timers => '12h: redo'
# which is equivalent to
alice :timeout => '12h', :on_timeout => 'redo'
skip,back,jump.rewind,continue,break,stop,over,reset这些命令都可以执行。
:scope
默认情况下,一个工作流程中的变量在相同的范围,通过:scope属性,来创建新的访问范围
define 'flow' do
set 'v:v' => 'alice'
sequence :scope => true do
set 'v:v' => 'bob'
participant '${v:x}' # will deliver to bob
end
participant '${v:x}' # will deliver to alice
end
例子中就是创建一个”局部“范围来定义了set 'v:v' => 'bob'。
:await
await的引进是为了帮助模块的有向图。就是等待依赖的工作完成,自己在执行。
concurrence do
sequence :tag => 'ab' do
a
b :tag => 'b'
end
sequence do
await :left_tag => 'ab'
c
end
sequence do
await :left_tag => 'b'
d
end
end
这个例子就是c要执行需要得ab执行结束之后才能执行,b执行完之后d才能执行。
最新文章
- Unity3D 脚本手册
- Arduino利用TimerOne库产生固定频率和占空比的方波
- 11.21 if条件语句 年月日执行判断
- ecshop订单-》待付款,待发货,待收货,收货确认
- 【PHP基础】位运算与原码,反码,补码
- ASP.NET文件上传的三种基本方法
- Android进程间通信
- [POJ1741]树上的点对 树分治
- Django运算表达式与Q对象/F对象
- QMainWindow class
- reduce函数
- python2x 和 python 3x的区别
- Linux基础命令---查找进程id
- 【ASP.Net】publish asp.net to local IIS
- UVA 10821 Constructing BST
- IEEEXtreme Practice Community Xtreme9.0 - Dictionary Strings
- 推荐20款JavaScript框架给前端开发者
- 源码解读 zsetAdd
- ElasticStack系列之十四 &; ElasticSearch5.x bulk update 中重复 id 性能骤降
- BFS+优先队列+状态压缩DP+TSP
热门文章
- Python-S9-Day88——stark组件之设计urls
- 【转】Twitter-Snowflake,64位自增ID算法详解
- [LOJ#2327]「清华集训 2017」福若格斯
- ionic2如何调用百度地图
- 简析JVM GC的根搜索算法
- 【CF1073C】Vasya and Robot(二分,构造)
- 子Repeater获取父级Repeater绑定项的值
- [LeetCode] Find Minimum in Rotated Sorted Array 二分搜索
- hdu 5950 Recursive sequence 递推式 矩阵快速幂
- linux device tree源代码解析【转】