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

三、流程定义BPMN

 四、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 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。