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. 问题以及延伸
个问题:
第一个问题:获取配置文件中节点的配置信息,上文我们获取到的是指定的任务节点的配置信息,怎么获取所有的节点配置信息呢?很显然我们可以判断这个FlowElement类型进行转换到对应的类型获取,这个比较简单 FlowElement是一个抽象类,下面有很多实现类。对应判断转换即可。
第二个问题:我们怎么能一路到底获取到所有的配置节点信息,以及配置的路径轨迹的信息呢?这里提供的思路 如下:activiti是根据连线运转的。我们可以开始从开始节点查找出线,一直查到结束节点。可以使用递归实现。
1.1.5. 遗留问题
可能有些读者对于上面的Process不是很熟悉,Process是动态部署中非常常用的一个对象,所以我们后续章节会专门出一个章节来讲解Process对象中的各个子对象,以及子对象的特性。