Activiti工作流HelloWorld入门 博客分类: Activiti工作流 AcitivitiActiviti工作流工作流HelloWorld
一、Activiti数据表支持
Activiti的后台是有数据库的支持,所有的表都以ACT_开头。 第二部分是表示表的用途的两个字母标识。 用途也和服务的API对应。
ACT_RE_*: 'RE'表示repository。 这个前缀的表包含了流程定义和流程静态资源 (图片,规则,等等)。
ACT_RU_*: 'RU'表示runtime。 这些运行时的表,包含流程实例,任务,变量,异步任务,等运行中的数据。 Activiti只在流程实例执行过程中保存这些数据, 在流程结束时就会删除这些记录。 这样运行时表可以一直很小速度很快。
ACT_ID_*: 'ID'表示identity。 这些表包含身份信息,比如用户,组等等。
ACT_HI_*: 'HI'表示history。 这些表包含历史数据,比如历史流程实例, 变量,任务等等。
ACT_GE_*: 通用数据, 用于不同场景下,如存放资源文件。
表结构操作:
1:资源库流程规则表
1)act_re_deployment 部署信息表
2)act_re_model 流程设计模型部署表
3)act_re_procdef 流程定义数据表
2:运行时数据库表
1)act_ru_execution 运行时流程执行实例表
2)act_ru_identitylink 运行时流程人员表,主要存储任务节点与参与者的相关信息
3)act_ru_task 运行时任务节点表
4)act_ru_variable 运行时流程变量数据表
3:历史数据库表
1)act_hi_actinst 历史节点表
2)act_hi_attachment 历史附件表
3)act_hi_comment 历史意见表
4)act_hi_identitylink 历史流程人员表
5)act_hi_detail 历史详情表,提供历史变量的查询
6)act_hi_procinst 历史流程实例表
7)act_hi_taskinst 历史任务实例表
8)act_hi_varinst 历史变量表
4:组织机构表
1)act_id_group 用户组信息表
2)act_id_info 用户扩展信息表
3)act_id_membership 用户与用户组对应信息表
4)act_id_user 用户信息表
这四张表很常见,基本的组织机构管理,关于用户认证方面建议还是自己开发一套,组件自带的功能太简单,使用中有很多需求难以满足
5:通用数据表
1)act_ge_bytearray 二进制数据表
2)act_ge_property 属性数据表存储整个流程引擎级别的数据,初始化表结构时,会默认插入三条记录
二、helloworld流程图:
三、流程定义BPMN
<?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: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="http://www.activiti.org/test"> <!-- 流程定义 --> <process id="helloworld" name="helloworldProcess" isExecutable="true"> <!-- 开始节点 --> <startEvent id="startevent1" name="Start"></startEvent> <!-- 结束节点 --> <endEvent id="endevent1" name="End"></endEvent> <!-- 任务定义--> <userTask id="usertask1" name="提交申请" activiti:assignee="张三"></userTask> <userTask id="usertask2" name="审批【部门经理】" activiti:assignee="李四"></userTask> <userTask id="usertask3" name="审批【总经理】" activiti:assignee="王五"></userTask> <!-- 任务连线 --> <sequenceFlow id="flow1" sourceRef="startevent1" targetRef="usertask1"></sequenceFlow> <sequenceFlow id="flow2" sourceRef="usertask1" targetRef="usertask2"></sequenceFlow> <sequenceFlow id="flow3" sourceRef="usertask2" targetRef="usertask3"></sequenceFlow> <sequenceFlow id="flow4" sourceRef="usertask3" targetRef="endevent1"></sequenceFlow> </process> <!-- 流程定义相关坐标定义 --> <bpmndi:BPMNDiagram id="BPMNDiagram_helloworld"> <bpmndi:BPMNPlane bpmnElement="helloworld" id="BPMNPlane_helloworld"> <bpmndi:BPMNShape bpmnElement="startevent1" id="BPMNShape_startevent1"> <omgdc:Bounds height="35.0" width="35.0" x="330.0" y="20.0"></omgdc:Bounds> </bpmndi:BPMNShape> <bpmndi:BPMNShape bpmnElement="endevent1" id="BPMNShape_endevent1"> <omgdc:Bounds height="35.0" width="35.0" x="330.0" y="380.0"></omgdc:Bounds> </bpmndi:BPMNShape> <bpmndi:BPMNShape bpmnElement="usertask1" id="BPMNShape_usertask1"> <omgdc:Bounds height="55.0" width="105.0" x="295.0" y="100.0"></omgdc:Bounds> </bpmndi:BPMNShape> <bpmndi:BPMNShape bpmnElement="usertask2" id="BPMNShape_usertask2"> <omgdc:Bounds height="55.0" width="105.0" x="295.0" y="200.0"></omgdc:Bounds> </bpmndi:BPMNShape> <bpmndi:BPMNShape bpmnElement="usertask3" id="BPMNShape_usertask3"> <omgdc:Bounds height="55.0" width="105.0" x="295.0" y="290.0"></omgdc:Bounds> </bpmndi:BPMNShape> <bpmndi:BPMNEdge bpmnElement="flow1" id="BPMNEdge_flow1"> <omgdi:waypoint x="347.0" y="55.0"></omgdi:waypoint> <omgdi:waypoint x="347.0" y="100.0"></omgdi:waypoint> </bpmndi:BPMNEdge> <bpmndi:BPMNEdge bpmnElement="flow2" id="BPMNEdge_flow2"> <omgdi:waypoint x="347.0" y="155.0"></omgdi:waypoint> <omgdi:waypoint x="347.0" y="200.0"></omgdi:waypoint> </bpmndi:BPMNEdge> <bpmndi:BPMNEdge bpmnElement="flow3" id="BPMNEdge_flow3"> <omgdi:waypoint x="347.0" y="255.0"></omgdi:waypoint> <omgdi:waypoint x="347.0" y="290.0"></omgdi:waypoint> </bpmndi:BPMNEdge> <bpmndi:BPMNEdge bpmnElement="flow4" id="BPMNEdge_flow4"> <omgdi:waypoint x="347.0" y="345.0"></omgdi:waypoint> <omgdi:waypoint x="347.0" y="380.0"></omgdi:waypoint> </bpmndi:BPMNEdge> </bpmndi:BPMNPlane> </bpmndi:BPMNDiagram> </definitions>
四、Activiti工作流HelloWorld流程代码
public class HelloWorld { /** * 获取流程引擎 * ProcessEngine:在Activiti中最核心的类,其他的类都是由他而来 */ ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine(); /**部署流程定义:信息写入act_re_deployment表(部署信息表),act_re_procdef表(流程定义数据表) */ @Test public void deployeementProcessDefinition() { /**这里使用RepositoryService部署流程定义 */ Deployment deployement = processEngine.getRepositoryService() /** 创建一个部署对象*/ .createDeployment() /**添加部署的名称*/ .name("helloworld入门程序") /**从classpath的资源中加载,一次只能加载一个文件*/ .addClasspathResource("diagrams/helloworld.bpmn") .addClasspathResource("diagrams/helloworld.png") /**完成部署*/ .deploy(); /** * 部署ID:1 * 部署名称:helloworld入门程序 */ System.out.println("部署ID:" + deployement.getId()); System.out.println("部署名称:" + deployement.getName()); } /**启动流程实例: * 插入信息:向act_ru_execution表(运行时流程执行实例表),流程开始执行写入信息 * 插入信息:向act_ru_identitylink表(运行时流程人员表,主要存储任务节点与参与者的相关信息)插入提交申请人任务信息, * 插入信息:向act_ru_task表(运行时任务节点表)插入信息*/ @Test public void startProessInstance(){ String processDefinitionKey = "helloworld"; /**这里使用RuntimeService启动流程实例*/ ProcessInstance pi=processEngine.getRuntimeService() /**使用流程定义的key进行启动流程实例,key对应的helloworld.bpmn文件中id属性 * 使用key值启动,默认是按照最新版本的流程定义启动 */ .startProcessInstanceByKey(processDefinitionKey); /** * 流程实例ID:101 * 流程定义ID:helloworld:1:4 */ System.out.println("流程实例ID:" + pi.getId()); System.out.println("流程定义ID:" + pi.getProcessDefinitionId()); } /**查看任务 * 查询act_ru_task表(运行时任务节点表)的信息 * */ @Test public void queryMyTask()throws Exception{ //String assignee="张三"; //String assignee="李四"; String assignee="王五"; /**这里使用TaskService完成任务的查询*/ List<Task> tasks=processEngine.getTaskService() /**创建任务查询对象*/ .createTaskQuery() /**指定人个任务办理人*/ .taskAssignee(assignee) /**查询任务的列表*/ .list(); for(Task task:tasks){ System.out.println("任务ID:" + task.getId()); System.out.println("任务名称:" + task.getName()); System.out.println("任务的创建时间:" + task.getCreateTime()); System.out.println("任务的办理人:" + task.getAssignee()); System.out.println("流程实例ID:" + task.getProcessInstanceId()); System.out.println("执行对象ID:" + task.getExecutionId()); System.out.println("流程定义ID:" + task.getProcessDefinitionId()); System.out.println("########################################################"); } } /** * 完成任务 * 插入:向act_ru_identitylink表(运行时流程人员表,主要存储任务节点与参与者的相关信息)写入参与者(完成任务人)信息 * 更新:act_ru_task表(运行时任务节点表) */ @Test public void completeTask()throws Exception{ /**任务ID*/ //String taskId="104"; //String taskId="202"; String taskId="302"; /**这里使用TaskService完成任务的办理*/ processEngine.getTaskService() /**根据任务ID,完成任务*/ .complete(taskId); System.out.println("完成任务:任务ID:" + taskId); } /** * 备注: * 当一个流程完成所有任务节点后会写入数据到下面表 * act_hi_actinst表(历史节点表) * act_hi_identitylink表(历史流程人员表) * act_hi_procinst表(历史流程实例表) * act_hi_taskinst表(历史任务实例表) * 但会删除这个流程的运行时的数据(根据流程key及版本号等) * 删除act_ru_execution表中与这个流程相关的信息 * 删除act_ru_identitylink表与这个流程相关的信息 * 删除act_ru_task表与这个流程相关的信息 */ }
5:核心API
1:ProcessEngine
说明:
1)在Activiti中最核心的类,其他的类都是由他而来。
2)产生方式:
在前面看到了两种创建ProcessEngine(流程引擎)的方式,而这里要简化很多,调用ProcessEngines的getDefaultProceeEngine方法时会自动加载classpath下名为activiti.cfg.xml文件。
3)可以产生RepositoryService
4)可以产生RuntimeService
5)可以产生TaskService
各个Service的作用:
RepositoryService 管理流程定义
RuntimeService 执行管理,包括启动、推进、删除流程实例等操作
TaskService 任务管理
HistoryService 历史管理(执行完的数据的管理)
IdentityService 组织机构管理
FormService 一个可选服务,任务表单管理
ManagerService
2:RepositoryService
是Activiti的仓库服务类。所谓的仓库指流程定义文档的两个文件:bpmn文件和流程图片。
1)产生方式
2)可以产生DeploymentBuilder,用来定义流程部署的相关参数
3)删除流程定义
3:RuntimeService
是activiti的流程执行服务类。可以从这个服务类中获取很多关于流程执行相关的信息。
4:TaskService
是activiti的任务服务类。可以从这个类中获取任务的信息。
5:HistoryService
是activiti的查询历史信息的类。在一个流程执行完成后,这个对象为我们提供查询历史信息。
6:ProcessDefinition
流程定义类。可以从这里获得资源文件等。
7:ProcessInstance
代表流程定义的执行实例。如范冰冰请了一天的假,她就必须发出一个流程实例的申请。一个流程实例包括了所有的运行节点。我们可以利用这个对象来了解当前流程实例的进度等信息。流程实例就表示一个流程从开始到结束的最大的流程分支,即一个流程中流程实例只有一个。
8:Execution
Activiti用这个对象去描述流程执行的每一个节点。在没有并发的情况下,Execution就是同ProcessInstance。流程按照流程定义的规则执行一次的过程,就可以表示执行对象Execution。