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 

同样可以。