优雅的实现Activiti动态调整流程（自由跳转、前进、后退、分裂、前加签、后加签等），含范例代码！

最近对Activiti做了一些深入的研究，对Activiti的流程机制有了些理解，对动态调整流程也有了一些实践方法。

现在好好总结一下，一来是对这段时间自己辛苦探索的一个记录，二来也是为后来者指指路~~~

如下内容准备采用QA的方式写，很多问题都是当初自己极疑惑的问题，希望能为大家解惑！

Q：可以动态调整流程吗？

A：可以！可以动态更改流程指向，或者创建新的节点，等等。。。

Q: 更改流程还需要注意什么？

A: 必须要实现持久化！否则一旦应用重启，你的流程就犯糊涂了！譬如，你创建了一个新节点，但由于没有持久化，重启之后流程引擎找不到那个新节点了。。。

Q: 如何做到优雅？

A: 除了持久化之外，还记住尽量不要因为临时调整直接更改现有活动（没准这个活动后面还要照常使用呢！），这种情况可以考虑克隆。第三，不要直接操作数据库，或者SqlSession，记住自己写Command！参见我前面的另外一篇文章。如下代码示出执行某个activity后续流程的Cmd：

[java]  view plain  copy

 print ?

1. public class CreateAndTakeTransitionCmd implements Command<java.lang.Void>  
2. {  
3.     private ActivityImpl _activity;  
4.   
5.     private String _executionId;  
6.   
7.     public CreateAndTakeTransitionCmd(String executionId, ActivityImpl activity)  
8.     {  
9.         _executionId = executionId;  
10.         _activity = activity;  
11.     }  
12.   
13.     @Override  
14.     public Void execute(CommandContext commandContext)  
15.     {  
16.         Logger.getLogger(TaskFlowControlService.class)  
17.                 .debug(String.format("executing activity: %s", _activity.getId()));  
18.   
19.         ExecutionEntity execution = commandContext.getExecutionEntityManager().findExecutionById(_executionId);  
20.         execution.setActivity(_activity);  
21.         execution.performOperation(AtomicOperation.TRANSITION_CREATE_SCOPE);  
22.   
23.         return null;  
24.     }  
25. }  

Q: 如何新建一个活动？

A: 新建活动可以调用processDefinition.createActivity(newActivityId)，我们往往可以以某个活动对象为模板来克隆一个新的活动，克隆的方法是分别拷贝各个字段的值：

[java]  view plain  copy

 print ?

1. protected ActivityImpl cloneActivity(ProcessDefinitionEntity processDefinition, ActivityImpl prototypeActivity,  
2.         String newActivityId, String... fieldNames)  
3. {  
4.     ActivityImpl clone = processDefinition.createActivity(newActivityId);  
5.     CloneUtils.copyFields(prototypeActivity, clone, fieldNames);  
6.   
7.     return clone;  
8. }  

拷贝字段的代码如下：

[java]  view plain  copy

 print ?

1. import org.apache.commons.lang.reflect.FieldUtils;  
2. import org.apache.log4j.Logger;  
3. import org.junit.Assert;  
4.   
5. public abstract class CloneUtils  
6. {  
7.     public static void copyFields(Object source, Object target, String... fieldNames)  
8.     {  
9.         Assert.assertNotNull(source);  
10.         Assert.assertNotNull(target);  
11.         Assert.assertSame(source.getClass(), target.getClass());  
12.   
13.         for (String fieldName : fieldNames)  
14.         {  
15.             try  
16.             {  
17.                 Field field = FieldUtils.getField(source.getClass(), fieldName, true);  
18.                 field.setAccessible(true);  
19.                 field.set(target, field.get(source));  
20.             }  
21.             catch (Exception e)  
22.             {  
23.                 Logger.getLogger(CloneUtils.class).warn(e.getMessage());  
24.             }  
25.         }  
26.     }  
27. }  

一个示例的用法是：

[java]  view plain  copy

 print ?

1. ActivityImpl clone = cloneActivity(processDefinition, prototypeActivity, cloneActivityId, "executionListeners",  
2.     "properties");  

这个语句的意思是克隆prototypeActivity对象的executionListeners和properties字段。

Q: 如何实现新建活动的持久化？

A: 一个办法是将新建活动的类型、活动ID（activityId）、incomingTransitions、outgoingTransitions等信息保存起来，然后在ProcessEngine启动的时候，在ProcessDefinition中注册这些活动。

但还有一种更好的办法，即只持久化“活动工厂”的信息。譬如，我们根据step2活动创建一个step21活动，所有的信息都一样，这个时候只要持久化工厂类型（活动克隆）、模板活动ID（step2）、新活动ID（step21），这种方法是极其节省空间的，而且简化了代码。比较复杂的例子，是将某个活动分裂成N个串行的会签活动，这种情况只需要记录模板活动ID、新活动ID数组就可以了，不需要记录更多的信息。如下示出一个创建N个用户任务活动的例子：

[java]  view plain  copy

 print ?

1. public class ChainedActivitiesCreator extends RuntimeActivityCreatorSupport implements RuntimeActivityCreator  
2. {  
3.     @Override  
4.     public ActivityImpl[] createActivities(ProcessEngine processEngine, ProcessDefinitionEntity processDefinition,  
5.             RuntimeActivityDefinition info)  
6.     {  
7.         info.setFactoryName(ChainedActivitiesCreator.class.getName());  
8.   
9.         if (info.getCloneActivityIds() == null)  
10.         {  
11.             info.setCloneActivityIds(CollectionUtils.arrayToList(new String[info.getAssignees().size()]));  
12.         }  
13.   
14.         return createActivities(processEngine, processDefinition, info.getProcessInstanceId(),  
15.             info.getPrototypeActivityId(), info.getNextActivityId(), info.getAssignees(), info.getCloneActivityIds());  
16.     }  
17.   
18.     private ActivityImpl[] createActivities(ProcessEngine processEngine, ProcessDefinitionEntity processDefinition,  
19.             String processInstanceId, String prototypeActivityId, String nextActivityId, List<String> assignees,  
20.             List<String> activityIds)  
21.     {  
22.         ActivityImpl prototypeActivity = ProcessDefinitionUtils.getActivity(processEngine, processDefinition.getId(),  
23.             prototypeActivityId);  
24.   
25.         List<ActivityImpl> activities = new ArrayList<ActivityImpl>();  
26.         for (int i = 0; i < assignees.size(); i++)  
27.         {  
28.             if (activityIds.get(i) == null)  
29.             {  
30.                 String activityId = createUniqueActivityId(processInstanceId, prototypeActivityId);  
31.                 activityIds.set(i, activityId);  
32.             }  
33.   
34.             ActivityImpl clone = createActivity(processEngine, processDefinition, prototypeActivity,  
35.                 activityIds.get(i), assignees.get(i));  
36.             activities.add(clone);  
37.         }  
38.   
39.         ActivityImpl nextActivity = ProcessDefinitionUtils.getActivity(processEngine, processDefinition.getId(),  
40.             nextActivityId);  
41.         createActivityChain(activities, nextActivity);  
42.   
43.         return activities.toArray(new ActivityImpl[0]);  
44.     }  
45. }  

这里，RuntimeActivityDefinition代表一个工厂信息，为了方便，不同工厂的个性化信息存成了一个JSON字符串，并会在加载的时候解析成一个Map：

[java]  view plain  copy

 print ?

1. public class RuntimeActivityDefinition  
2. {  
3.     String _factoryName;  
4.   
5.     String _processDefinitionId;  
6.   
7.     String _processInstanceId;  
8.   
9.     Map<String, Object> _properties = new HashMap<String, Object>();  
10.   
11.     String _propertiesText;  
12.   
13.     public void deserializeProperties() throws IOException  
14.     {  
15.         ObjectMapper objectMapper = new ObjectMapper();  
16.         _properties = objectMapper.readValue(_propertiesText, Map.class);  
17.     }  
18.   
19.     public List<String> getAssignees()  
20.     {  
21.         return getProperty("assignees");  
22.     }  
23.   
24.     public String getCloneActivityId()  
25.     {  
26.         return getProperty("cloneActivityId");  
27.     }  
28.     //...  
29. }  

一个节点分裂的工厂属性：

[java]  view plain  copy

 print ?

1. {"sequential":true,"assignees":["bluejoe","alex"],"cloneActivityId":"2520001:step2:1419823449424-8","prototypeActivityId":"step2"}