Activiti工作流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流程图:


Activiti工作流HelloWorld入门_第1张图片

三、流程定义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。


 

你可能感兴趣的:(工作流,helloworld,Activiti工作流,acitiviti)