activiti 配置节点 连线信息获取

1.1.1. 前言

当使用eclipse插件进行流程设计的时候，部署流程之后，我们如何获取我们定义的所有的节点、连线、关口等配置信息呢？有的人看到这个需求，不免窃喜，这不很简单嘛，重新打来bmpn中定义的xml信息，查看不就完了，确实这种方式是可取的，但是当我们的项目流程在启动的时候，我们想要获取定义的信息的时候，换言之就是 我们能动态的读取里面的信息反馈给系统用户的时候，我们该如何获取呢？总不能告诉用户你去打开xml文件自己去查看，用户未必能看懂里面的xml定义信息吧。这种方式不是增加了用户操作难度，还要找个人培训用户吧。那所以我们该如何提供一个接口，让用户需要看的时候，点击一个按钮，就能一目了然的看到配置的信息呢，这是其一，第二：我们如何可以获取到一个任务的出线信息，动态的渲染到页面，让用户操作呢？举一个简单的例子，a任务节点有三根出线、出线1 出线2、出线3、当用户查询代办信息的时候，我们怎么把当前a任务节点的3个出线渲染到页面，让用户决定下一个流程的去向。第三：还是上面的例子，a用户选择不同的出线信息就决定了流程的不同运转轨迹，因为activiti 工作流就是靠线上的表达式运转的，那怎么能在用户选择的时把线上配置的表达式获取到呢？还是上面的问题，总不能告诉用户你选择a出线输入a=1表达式，选择2出线输入a=2表达式。这种方式操作不方便，也是不可取的。所以下面我们将详细的讲解如何获取配置文件的节点信息。

1.1.2. 流程的定义

定义一个流程流程的详细定义如下：

Xml的配置信息如下所示：

<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:activiti="http://activiti.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath" targetNamespace="daling">
  <process id="daling" name="name_daling" isExecutable="true" activiti:candidateStarterUsers="a,b,c,d">
    <startEvent id="startevent1" name="Start"></startEvent>
    <userTask id="usertask1" name="usertask1审批" activiti:candidateGroups="1,2">
      <documentation>usertask1审批</documentation>
    </userTask>
    <userTask id="usertask2" name="usertask2审批" activiti:candidateUsers="b,c"></userTask>
    <endEvent id="endevent1" name="End"></endEvent>
    <sequenceFlow id="flow1" name="flow1" sourceRef="startevent1" targetRef="usertask1">
      <documentation>flow1连线</documentation>
      <conditionExpression xsi:type="tFormalExpression"><![CDATA[${a==2}]]></conditionExpression>
    </sequenceFlow>
    <sequenceFlow id="flow2" name="flow2" sourceRef="usertask1" targetRef="usertask2">
      <documentation>usertask1审批出线</documentation>
      <conditionExpression xsi:type="tFormalExpression"><![CDATA[${a==1}]]></conditionExpression>
    </sequenceFlow>
    <sequenceFlow id="flow3" sourceRef="usertask2" targetRef="endevent1"></sequenceFlow>
  </process>
  <bpmndi:BPMNDiagram id="BPMNDiagram_daling">
    <bpmndi:BPMNPlane bpmnElement="daling" id="BPMNPlane_daling">
      <bpmndi:BPMNShape bpmnElement="startevent1" id="BPMNShape_startevent1">
        <omgdc:Bounds height="35.0" width="35.0" x="230.0" y="10.0"></omgdc:Bounds>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNShape bpmnElement="usertask1" id="BPMNShape_usertask1">
        <omgdc:Bounds height="55.0" width="105.0" x="300.0" y="110.0"></omgdc:Bounds>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNShape bpmnElement="usertask2" id="BPMNShape_usertask2">
        <omgdc:Bounds height="55.0" width="105.0" x="280.0" y="192.0"></omgdc:Bounds>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNShape bpmnElement="endevent1" id="BPMNShape_endevent1">
        <omgdc:Bounds height="35.0" width="35.0" x="230.0" y="340.0"></omgdc:Bounds>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNEdge bpmnElement="flow1" id="BPMNEdge_flow1">
        <omgdi:waypoint x="247.0" y="45.0"></omgdi:waypoint>
        <omgdi:waypoint x="352.0" y="110.0"></omgdi:waypoint>
        <bpmndi:BPMNLabel>
          <omgdc:Bounds height="14.0" width="100.0" x="247.0" y="45.0"></omgdc:Bounds>
        </bpmndi:BPMNLabel>
      </bpmndi:BPMNEdge>
      <bpmndi:BPMNEdge bpmnElement="flow2" id="BPMNEdge_flow2">
        <omgdi:waypoint x="352.0" y="165.0"></omgdi:waypoint>
        <omgdi:waypoint x="332.0" y="192.0"></omgdi:waypoint>
        <bpmndi:BPMNLabel>
          <omgdc:Bounds height="14.0" width="100.0" x="352.0" y="165.0"></omgdc:Bounds>
        </bpmndi:BPMNLabel>
      </bpmndi:BPMNEdge>
      <bpmndi:BPMNEdge bpmnElement="flow3" id="BPMNEdge_flow3">
        <omgdi:waypoint x="332.0" y="247.0"></omgdi:waypoint>
        <omgdi:waypoint x="247.0" y="340.0"></omgdi:waypoint>
      </bpmndi:BPMNEdge>
    </bpmndi:BPMNPlane>
  </bpmndi:BPMNDiagram>
</definitions>

流程定义完了就开始部署测试如何获取节点的信息：

当一个流程xml部署的时候，看看数据库表的变化后面可能用到，比较熟悉表结构的同志们就忽略继续向下看吧。

部署的时候ACT_GE_BYTEARRAY表会变化，具体如下图所示：

ACT_GE_PROPERTY表会变化吧。生成next.dbid。

ACT_RE_PROCDEF会变化，因为定义的部署流程信息。

好了表的关系大致了解下，看下面我们如何获取节点配置信息demo吧。

1.1.3. 代码获取

ProcessEnginesDemo demo = new ProcessEnginesDemo();
RepositoryService repositoryService2 = demo.getRepositoryService();
//processDefinitionId 对应表ACT_RE_PROCDEF主键信息
String processDefinitionId="daling:5:30004";
//获取bpmnModel对象
BpmnModel bpmnModel = repositoryService2.getBpmnModel(processDefinitionId);
//因为我们这里只定义了一个Process 所以获取集合中的第一个即可
Process process = bpmnModel.getProcesses().get(0);
//获取所有的FlowElement信息
Collection<FlowElement> flowElements = process.getFlowElements();
for (FlowElement flowElement : flowElements) {
//如果是任务节点
if (flowElement instanceof UserTask) {
UserTask userTask=(UserTask) flowElement;
//获取入线信息
List<SequenceFlow> incomingFlows = userTask.getIncomingFlows();
for (SequenceFlow sequenceFlow : incomingFlows) {
System.out.println(sequenceFlow.getId() +"-"+sequenceFlow.getConditionExpression()+"--"+sequenceFlow.getDocumentation()+"-"
+sequenceFlow.getSourceRef()+"--"+sequenceFlow.getTargetRef()+"-");
}
}
}

程序的输出如下所示：

flow1-${a==2}--flow1连线-startevent1--usertask1-

flow2-${a==1}--usertask1审批出线-usertask1--usertask2

上面的代码，我们也能看出来主要是获取BpmnModel中的Process对象，Process对象封装了所有的节点、连线、以及关口等信息。所以这个Process对象还是很重要的，拿到这个对象就可以为所欲为了。

这个BpmnModel对象可以参考：http://blog.csdn.net/qq_30739519/article/details/51166993这篇文章，

1.1.4. 问题以及延伸

上面的代码基本上已经满足我们的需求，但是也存在2个问题：

第一个问题：获取配置文件中节点的配置信息，上文我们获取到的是指定的任务节点的配置信息，怎么获取所有的节点配置信息呢？很显然我们可以判断这个FlowElement类型进行转换到对应的类型获取，这个比较简单 FlowElement是一个抽象类，下面有很多实现类。对应判断转换即可。

第二个问题：我们怎么能一路到底获取到所有的配置节点信息，以及配置的路径轨迹的信息呢？这里提供的思路 如下：activiti是根据连线运转的。我们可以开始从开始节点查找出线，一直查到结束节点。可以使用递归实现。

1.1.5. 遗留问题

可能有些读者对于上面的Process不是很熟悉，Process是动态部署中非常常用的一个对象，所以我们后续章节会专门出一个章节来讲解Process对象中的各个子对象，以及子对象的特性。