workflow engine Ruote初体验之三（条件与美元符号）

• 条件

      我们可以用:if和:unless公共属性来进行条件判断，或者使用if,given,once或者equals（已经过时）关键字。

     使用:if属性：      

1 cursor do

2   participant 'customer'

3   rewind :if => '${not_enough_info} == true'

4   participant 'logistics'

5 end

    当使用given表达式的时候：

 1 given do

 2   that "${location} == paris" do

 3     subprocess "notify_and_wait_for_pickup"

 4   end

 5   that "${state} == ready" do

 6     subprocess "deliver"

 7   end

 8   # else...

 9   subprocess "do_something_else"

10 end

看起来就是和which case的语法是一样的。given类似于which关键字，that类似于case关键字。当然在:if和:unless可以接收判断条件可以涉及到<,>,<= ,>=等。这个大家很熟悉了。只要能够返回true或者false就可以了。

• 美元符号 

    在我们以前所举的例子当中，把每个参与者或者每个子流程都写成固定的，就是这个样子：

1 sequence do

2   participant 'alfred'

3   participant 'bob'

4 end

但是在真正项目中使用的时候，参与者大都是一个动态的变量。应该是这样的：

1 sequence do

2   participant '${f:student}'

3   participant '${f:teacher}'

4 end

   根据这个小例子的定义，我们可以看出这个工作流是从学生到老师，学生的真实姓名是存在这个工作流中的student字段，老师的具体名字是存放在工作条目中teacher字段中。

   美元符号获取process的定义的${...}变量,或者在参与者中设置的process的变量。看下面的例子：

 1 require 'ruote'

 2 

 3 # 定义一个引擎

 4 

 5 engine = Ruote::Dashboard.new(

 6     Ruote::Worker.new(

 7         Ruote::HashStorage.new()))

 8 

 9 # 注册参与者

10 

11 engine.register_participant :alpha do |workitem|

12   workitem.fields['message'] =  'Dollar notation Test'

13 end

14 

15 engine.register_participant :bravo do |workitem|

16   puts "I received a message from #{workitem.fields['message']}"

17 end

18 

19 # 定义一个程序

20 

21 pdef = Ruote.define :name => 'test' do

22   sequence do

23     set 'f:a' => 'Steven'

24     echo '${a}'

25     participant :alpha

26     echo '${message}'

27     participant :bravo

28   end

29 end

30 

31 # 创建一个进程实例

32 

33 wfid = engine.launch(pdef)

34 

35 engine.wait_for(wfid)

查看输出结果：

1 Steven

2 Dollar notation Test

3 I received a message from Dollar notation Test

其中sequence表达式是指注册的参与者按照顺序依次执行。

   变量和工作流中的字段：

   workitem字段对于process实例最为常见，每一个workitem都有一个字段的集合，workitem和字段对于参与者可见。Process变量对于engine以外不可见，只是给route用来在process实例中做逻辑处理用。

 1 Ruote.process_definition :name => 'loan_approval', :revision => '1' do

 2   cursor do

 3     participant 'planning team'

 4     concurrence do

 5       participant 'ceo', :if => '${f:total} > 100000'

 6       participant 'cfo'

 7     end

 8     rewind :unless => '${f:approved}'

 9     participant 'execution team'

10   end

11 end

      这个例子的process定义中，有两个字段可见，分别是total和approved。total由'planning team'设置，approved由'ceo'或者'cfo'设置。如果total大于100000，ceo和cfo都收到一个workitem。这两个参与者是并行执行的。

    一直都在说workitem的fields,下面来开一下程序变量的使用方法，只是process定义部分的代码其他同上：

pdef = Ruote.define :name => 'test' do

    set 'v:test' => 'process var'

    echo '${v:test}'

 end

输出结果：

1 process var

 

  程序变量使用的情况不多，所以在我们写${xx}其实默认表达的是${f:xx}

       还有一些稍微复杂一点的用法比如交叉或者带有复杂的key值，但是用法没有什么不一样。下面看一下workitem字段和process 变量的初始化的问题： 

 1 require 'ruote'

 2 

 3 # preparing the engine

 4 

 5 engine = Ruote::Dashboard.new(

 6     Ruote::Worker.new(

 7         Ruote::HashStorage.new()))

 8 

 9 # registering participants

10 

11 engine.register_participant :alpha do |workitem|

12   workitem.fields['message'] += ' via alpha '

13 end

14 

15 engine.register_participant :bravo do |workitem|

16   puts "I received a message  #{workitem.fields['message']}"

17 end

18 

19 # defining a process

20 

21 pdef = Ruote.define :name => 'test' do

22     set 'field:message' => 'Helllo'

23     sequence do

24       participant :alpha

25       participant :bravo

26     end

27 end

28 

29 # launching, creating a process instance

30 

31 wfid = engine.launch(pdef)

32 

33 engine.wait_for(wfid)

输出结果：

1 I received a message  Helllo via alpha 

在这个例子中，我们初始化了一个workitemfiled，还有没有其他办法呢？我们看一下Dashboar的lauch方法定义

1 launch(process_definition, fields={}, variables={}, root_stash=nil)

好吧我们可以这程序运行的时候生成workitem fileds和程序变量，将上面的程序做一点修改：

 1 require 'ruote'

 2 

 3 # preparing the engine

 4 

 5 engine = Ruote::Dashboard.new(

 6     Ruote::Worker.new(

 7         Ruote::HashStorage.new()))

 8 

 9 # registering participants

10 

11 engine.register_participant :alpha do |workitem|

12   workitem.fields['message'] += ' via alpha '

13 end

14 

15 engine.register_participant :bravo do |workitem|

16   puts "I received a message  #{workitem.fields['message']}"

17 end

18 

19 # defining a process

20 

21 pdef = Ruote.define :name => 'test' do

22     sequence do

23       participant :alpha

24       participant :bravo

25     end

26 end

27 

28 # launching, creating a process instance

29 

30 wfid = engine.launch(pdef,'message'=>'Hello')

31 

32 engine.wait_for(wfid)

输出结果：

1 I received a message  Hello via alpha 

同样可以。