activity结合项目应用和表结构
/**更新请假状态，启动流程实例，让启动的流程实例关联业务*/
@Override
public void saveStartProcess(WorkflowBean workflowBean) {
//1：获取请假单ID，使用请假单ID，查询请假单的对象LeaveBill
Long id = workflowBean.getId();
LeaveBill leaveBill = leaveBillDao.findLeaveBillById(id);
//2：更新请假单的请假状态从0变成1（初始录入-->审核中）
leaveBill.setState(1);
//3：使用当前对象获取到流程定义的key（对象的名称就是流程定义的key）
String key = leaveBill.getClass().getSimpleName();
/**
* 4：从Session中获取当前任务的办理人，使用流程变量设置下一个任务的办理人
* inputUser是流程变量的名称，
* 获取的办理人是流程变量的值
*/
Map variables = new HashMap();
variables.put("inputUser", SessionContext.get().getName());//表示惟一用户
/**
* 5： (1)使用流程变量设置字符串（格式：LeaveBill.id的形式），通过设置，让启动的流程（流程实例）关联业务
(2)使用正在执行对象表中的一个字段BUSINESS_KEY（Activiti提供的一个字段），让启动的流程（流程实例）关联业务
*/
//格式：LeaveBill.id的形式（使用流程变量）
String objId = key+"."+id;
variables.put("objId", objId);
//6：使用流程定义的key，启动流程实例，同时设置流程变量，同时向正在执行的执行对象表中的字段BUSINESS_KEY添加业务数据，同时让流程关联业务
runtimeService.startProcessInstanceByKey(key,objId,variables);
}
/**2：使用当前用户名查询正在执行的任务表，获取当前任务的集合List*/
@Override
public List findTaskListByName(String name) {
List list = taskService.createTaskQuery()//
.taskAssignee(name)//指定个人任务查询
.orderByTaskCreateTime().asc()//
.list();
return list;
}
/**使用任务ID，获取当前任务节点中对应的Form key中的连接的值*/
@Override
public String findTaskFormKeyByTaskId(String taskId) {
TaskFormData formData = formService.getTaskFormData(taskId);
//获取Form key的值
String url = formData.getFormKey();
return url;
}
/**一：使用任务ID，查找请假单ID，从而获取请假单信息*/
@Override
public LeaveBill findLeaveBillByTaskId(String taskId) {
//1：使用任务ID，查询任务对象Task
Task task = taskService.createTaskQuery()//
.taskId(taskId)//使用任务ID查询
.singleResult();
//2：使用任务对象Task获取流程实例ID
String processInstanceId = task.getProcessInstanceId();
//3：使用流程实例ID，查询正在执行的执行对象表，返回流程实例对象
ProcessInstance pi = runtimeService.createProcessInstanceQuery()//
.processInstanceId(processInstanceId)//使用流程实例ID查询
.singleResult();
//4：使用流程实例对象获取BUSINESS_KEY
String buniness_key = pi.getBusinessKey();
//5：获取BUSINESS_KEY对应的主键ID，使用主键ID，查询请假单对象（LeaveBill.1）
String id = "";
if(StringUtils.isNotBlank(buniness_key)){
//截取字符串，取buniness_key小数点的第2个值
id = buniness_key.split("\\.")[1];
}
//查询请假单对象
//使用hql语句：from LeaveBill o where o.id=1
LeaveBill leaveBill = leaveBillDao.findLeaveBillById(Long.parseLong(id));
return leaveBill;
}
/**二：已知任务ID，查询ProcessDefinitionEntiy对象，从而获取当前任务完成之后的连线名称，并放置到List集合中*/
@Override
public List findOutComeListByTaskId(String taskId) {
//返回存放连线的名称集合
List list = new ArrayList();
//1:使用任务ID，查询任务对象
Task task = taskService.createTaskQuery()//
.taskId(taskId)//使用任务ID查询
.singleResult();
//2：获取流程定义ID
String processDefinitionId = task.getProcessDefinitionId();
//3：查询ProcessDefinitionEntiy对象
ProcessDefinitionEntity processDefinitionEntity = (ProcessDefinitionEntity) repositoryService.getProcessDefinition(processDefinitionId);
//使用任务对象Task获取流程实例ID
String processInstanceId = task.getProcessInstanceId();
//使用流程实例ID，查询正在执行的执行对象表，返回流程实例对象
ProcessInstance pi = runtimeService.createProcessInstanceQuery()//
.processInstanceId(processInstanceId)//使用流程实例ID查询
.singleResult();
//获取当前活动的id
String activityId = pi.getActivityId();
//4：获取当前的活动
ActivityImpl activityImpl = processDefinitionEntity.findActivity(activityId);
//5：获取当前活动完成之后连线的名称
List pvmList = activityImpl.getOutgoingTransitions();
if(pvmList!=null && pvmList.size()>0){
for(PvmTransition pvm:pvmList){
String name = (String) pvm.getProperty("name");
if(StringUtils.isNotBlank(name)){
list.add(name);
}
else{
list.add("默认提交");
}
}
}
return list;
}
/**指定连线的名称完成任务*/
@Override
public void saveSubmitTask(WorkflowBean workflowBean) {
//获取任务ID
String taskId = workflowBean.getTaskId();
//获取连线的名称
String outcome = workflowBean.getOutcome();
//批注信息
String message = workflowBean.getComment();
//获取请假单ID
Long id = workflowBean.getId();
/**
* 1：在完成之前，添加一个批注信息，向act_hi_comment表中添加数据，用于记录对当前申请人的一些审核信息
*/
//使用任务ID，查询任务对象，获取流程流程实例ID
Task task = taskService.createTaskQuery()//
.taskId(taskId)//使用任务ID查询
.singleResult();
//获取流程实例ID
String processInstanceId = task.getProcessInstanceId();
/**
* 注意：添加批注的时候，由于Activiti底层代码是使用：
* String userId = Authentication.getAuthenticatedUserId();
CommentEntity comment = new CommentEntity();
comment.setUserId(userId);
所有需要从Session中获取当前登录人，作为该任务的办理人（审核人），对应act_hi_comment表中的User_ID的字段，不过不添加审核人，该字段为null
所以要求，添加配置执行使用Authentication.setAuthenticatedUserId();添加当前任务的审核人
* */
Authentication.setAuthenticatedUserId(SessionContext.get().getName());
taskService.addComment(taskId, processInstanceId, message);
/**
* 2：如果连线的名称是“默认提交”，那么就不需要设置，如果不是，就需要设置流程变量
* 在完成任务之前，设置流程变量，按照连线的名称，去完成任务
流程变量的名称：outcome
流程变量的值：连线的名称
*/
Map variables = new HashMap();
if(outcome!=null && !outcome.equals("默认提交")){
variables.put("outcome", outcome);
}
//3：使用任务ID，完成当前人的个人任务，同时流程变量
taskService.complete(taskId, variables);
//4：当任务完成之后，需要指定下一个任务的办理人（使用类）-----已经开发完成
/**
* 5：在完成任务之后，判断流程是否结束
如果流程结束了，更新请假单表的状态从1变成2（审核中-->审核完成）
*/
ProcessInstance pi = runtimeService.createProcessInstanceQuery()//
.processInstanceId(processInstanceId)//使用流程实例ID查询
.singleResult();
//流程结束了
if(pi==null){
//更新请假单表的状态从1变成2（审核中-->审核完成）
LeaveBill bill = leaveBillDao.findLeaveBillById(id);
bill.setState(2);
}
}
/**获取批注信息，传递的是当前任务ID，获取历史任务ID对应的批注*/
@Override
public List findCommentByTaskId(String taskId) {
List list = new ArrayList();
//使用当前的任务ID，查询当前流程对应的历史任务ID
//使用当前任务ID，获取当前任务对象
Task task = taskService.createTaskQuery()//
.taskId(taskId)//使用任务ID查询
.singleResult();
//获取流程实例ID
String processInstanceId = task.getProcessInstanceId();
// //使用流程实例ID，查询历史任务，获取历史任务对应的每个任务ID
// List htiList = historyService.createHistoricTaskInstanceQuery()//历史任务表查询
// .processInstanceId(processInstanceId)//使用流程实例ID查询
// .list();
// //遍历集合，获取每个任务ID
// if(htiList!=null && htiList.size()>0){
// for(HistoricTaskInstance hti:htiList){
// //任务ID
// String htaskId = hti.getId();
// //获取批注信息
// List taskList = taskService.getTaskComments(htaskId);//对用历史完成后的任务ID
// list.addAll(taskList);
// }
// }
list = taskService.getProcessInstanceComments(processInstanceId);
return list;
}
/**使用请假单ID，查询历史批注信息*/
@Override
public List findCommentByLeaveBillId(Long id) {
//使用请假单ID，查询请假单对象
LeaveBill leaveBill = leaveBillDao.findLeaveBillById(id);
//获取对象的名称
String objectName = leaveBill.getClass().getSimpleName();
//组织流程表中的字段中的值
String objId = objectName+"."+id;
/**1:使用历史的流程实例查询，返回历史的流程实例对象，获取流程实例ID*/
// HistoricProcessInstance hpi = historyService.createHistoricProcessInstanceQuery()//对应历史的流程实例表
// .processInstanceBusinessKey(objId)//使用BusinessKey字段查询
// .singleResult();
// //流程实例ID
// String processInstanceId = hpi.getId();
/**2:使用历史的流程变量查询，返回历史的流程变量的对象，获取流程实例ID*/
HistoricVariableInstance hvi = historyService.createHistoricVariableInstanceQuery()//对应历史的流程变量表
.variableValueEquals("objId", objId)//使用流程变量的名称和流程变量的值查询
.singleResult();
//流程实例ID
String processInstanceId = hvi.getProcessInstanceId();
List list = taskService.getProcessInstanceComments(processInstanceId);
return list;
}
/**1：获取任务ID，获取任务对象，使用任务对象获取流程定义ID，查询流程定义对象*/
@Override
public ProcessDefinition findProcessDefinitionByTaskId(String taskId) {
//使用任务ID，查询任务对象
Task task = taskService.createTaskQuery()//
.taskId(taskId)//使用任务ID查询
.singleResult();
//获取流程定义ID
String processDefinitionId = task.getProcessDefinitionId();
//查询流程定义的对象
ProcessDefinition pd = repositoryService.createProcessDefinitionQuery()//创建流程定义查询对象，对应表act_re_procdef
.processDefinitionId(processDefinitionId)//使用流程定义ID查询
.singleResult();
return pd;
}
/**
* 二：查看当前活动，获取当期活动对应的坐标x,y,width,height，将4个值存放到Map中
map集合的key：表示坐标x,y,width,height
map集合的value：表示坐标对应的值
*/
@Override
public Map findCoordingByTask(String taskId) {
//存放坐标
Map map = new HashMap();
//使用任务ID，查询任务对象
Task task = taskService.createTaskQuery()//
.taskId(taskId)//使用任务ID查询
.singleResult();
//获取流程定义的ID
String processDefinitionId = task.getProcessDefinitionId();
//获取流程定义的实体对象（对应.bpmn文件中的数据）
ProcessDefinitionEntity processDefinitionEntity = (ProcessDefinitionEntity)repositoryService.getProcessDefinition(processDefinitionId);
//流程实例ID
String processInstanceId = task.getProcessInstanceId();
//使用流程实例ID，查询正在执行的执行对象表，获取当前活动对应的流程实例对象
ProcessInstance pi = runtimeService.createProcessInstanceQuery()//创建流程实例查询
.processInstanceId(processInstanceId)//使用流程实例ID查询
.singleResult();
//获取当前活动的ID
String activityId = pi.getActivityId();
//获取当前活动对象
ActivityImpl activityImpl = processDefinitionEntity.findActivity(activityId);//活动ID
//获取坐标
map.put("x", activityImpl.getX());
map.put("y", activityImpl.getY());
map.put("width", activityImpl.getWidth());
map.put("height", activityImpl.getHeight());
return map;
}
} Activiti工作流引擎数据库表结构
数据库表的命名
Acitiviti数据库中表的命名都是以ACT_开头的。第二部分是一个两个字符用例表的标识。此用例大体与服务API是匹配的。
- ACT_RE_*:’RE’表示repository。带此前缀的表包含的是静态信息，如，流程定义，流程的资源（图片，规则等）。
- ACT_RU_*:’RU’表示runtime。这是运行时的表存储着流程变量，用户任务，变量，职责（job）等运行时的数据。Activiti只存储实例执行期间的运行时数据，当流程实例结束时，将删除这些记录。这就保证了这些运行时的表小且快。
- ACT_ID_*:’ID’表示identity。这些表包含标识的信息，如用户，用户组，等等。
- ACT_HI_*:’HI’表示history。就是这些表包含着历史的相关数据，如结束的流程实例，变量，任务，等等。
- ACT_GE_*:普通数据，各种情况都使用的数据。
数据库表结构图
数据库表结构说明
- ACT_GE_PROPERTY:属性数据表。存储这个流程引擎级别的数据。
- NAME_:属性名称
- VALUE_:属性值
- REV_INT:版本号
- ACT_GE_BYTEARRAY:用来保存部署文件的大文本数据
- ID_:资源文件编号，自增长
- REV_INT:版本号
- NAME_:资源文件名称
- DEPLOYMENT_ID_:来自于父表ACT_RE_DEPLOYMENT的主键
- BYTES_:大文本类型，存储文本字节流
- ACT_RE_DEPLOYMENT:用来存储部署时需要持久化保存下来的信息
- ID_:部署编号，自增长
- NAME_:部署包的名称
- DEPLOY_TIME_:部署时间
- ACT_RE_PROCDEF:业务流程定义数据表
- ID_:流程ID，由“流程编号：流程版本号：自增长ID”组成
- CATEGORY_:流程命名空间（该编号就是流程文件targetNamespace的属性值）
- NAME_:流程名称（该编号就是流程文件process元素的name属性值）
- KEY_:流程编号（该编号就是流程文件process元素的id属性值）
- VERSION_:流程版本号（由程序控制，新增即为1，修改后依次加1来完成的）
- DEPLOYMENT_ID_:部署编号
- RESOURCE_NAME_:资源文件名称
- DGRM_RESOURCE_NAME_:图片资源文件名称
- HAS_START_FROM_KEY_:是否有Start From Key
注：此表和ACT_RE_DEPLOYMENT是多对一的关系，即，一个部署的bar包里可能包含多个流程定义文件，每个流程定义文件都会有一条记录在ACT_REPROCDEF表内，每个流程定义的数据，都会对于ACT_GE_BYTEARRAY表内的一个资源文件和PNG图片文件。和ACT_GE_BYTEARRAY的关联是通过程序用ACT_GE_BYTEARRAY.NAME与ACT_RE_PROCDEF.NAME_完成的，在数据库表结构中没有体现。
- ACT_ID_GROUP:用来存储用户组信息。
- ID_：用户组名*
- REV_INT:版本号
- NAME_:用户组描述信息*
- TYPE_:用户组类型
- ACT_ID_MEMBERSHIP:用来保存用户的分组信息
- USER_ID_:用户名
- GROUP_ID_:用户组名
- ACT_ID_USER:
- ID_:用户名
- REV_INT:版本号
- FIRST_:用户名称
- LAST_:用户姓氏
- EMAIL_:邮箱
- PWD_:密码
- ACT_RU_EXECUTION：
- ID_：
- REV_：版本号
- PROC_INST_ID_：流程实例编号
- BUSINESS_KEY_：业务编号
- PARENT_ID_：找到该执行实例的父级，最终会找到整个流程的执行实例
- PROC_DEF_ID_：流程ID
- SUPER_EXEC_： 引用的执行模板
- ACT_ID_： 节点id
- IS_ACTIVE_： 是否访问
- IS_CONCURRENT_：
- IS_SCOPE_：
- ACT_RU_TASK：运行时任务数据表。
- ID_：
- REV_：
- EXECUTION_ID_： 执行实例的id
- PROC_INST_ID_： 流程实例的id
- PROC_DEF_ID_： 流程定义的id,对应act_re_procdef 的id_
- NAME_： 任务名称，对应 ***task 的name
- PARENT_TASK_ID_ : 对应父任务
- DESCRIPTION_：
- TASK_DEF_KEY_： ***task 的id
- OWNER_ : 发起人
- ASSIGNEE_： 分配到任务的人
- DELEGATION_ : 委托人
- PRIORITY_： 紧急程度
- CREATE_TIME_： 发起时间
- DUE_TIME_：审批时长
- ACT_RU_IDENTITYLINK：任务参与者数据表。主要存储当前节点参与者的信息。
- ID_： 标识
- REV_： 版本
- GROUP_ID_： 组织id
- TYPE_： 类型
- USER_ID_： 用户id
- TASK_ID_： 任务id
- ACT_RU_VARIABLE：运行时流程变量数据表。
- ID_：标识
- REV_：版本号
- TYPE_：数据类型
- NAME_：变量名
- EXECUTION_ID_： 执行实例id
- PROC_INST_ID_： 流程实例id
- TASK_ID_： 任务id
- BYTEARRAY_ID_：
- DOUBLE_：若数据类型为double ,保存数据在此列
- LONG_： 若数据类型为Long保存数据到此列
- TEXT_： string 保存到此列
- TEXT2_：
- ACT_HI_PROCINST：
- ID_ : 唯一标识
- PROC_INST_ID_ : 流程ＩＤ
- BUSINESS_KEY_ : 业务编号
- PROC_DEF_ID_ ： 流程定义id
- START_TIME_ : 流程开始时间
- ENT__TIME : 结束时间
- DURATION_ : 流程经过时间
- START_USER_ID_ : 开启流程用户id
- START_ACT_ID_ : 开始节点
- END_ACT_ID_： 结束节点
- SUPER_PROCESS_INSTANCE_ID_ : 父流程流程id
- DELETE_REASON_ : 从运行中任务表中删除原因
- ACT_HI_ACTINST：
- ID_ : 标识
- PROC_DEF_ID_ :流程定义id
- PROC_INST_ID_ : 流程实例id
- EXECUTION_ID_ : 执行实例
- ACT_ID_ : 节点id
- ACT_NAME_ : 节点名称
- ACT_TYPE_ : 节点类型
- ASSIGNEE_ : 节点任务分配人
- START_TIME_ : 开始时间
- END_TIME_ : 结束时间
- DURATION : 经过时长
- ACT_HI_TASKINST：
- ID_ ： 标识
- PROC_DEF_ID_ ： 流程定义id
- TASK_DEF_KEY_ : 任务定义id
- PROC_INST_ID_ : 流程实例ｉｄ
- EXECUTION_ID_ : 执行实例id
- PARENT_TASK_ID_ : 父任务id
- NAME_ : 任务名称
- DESCRIPTION_ : 说明
- OWNER_ : 拥有人（发起人）
- ASSIGNEE_ : 分配到任务的人
- START__TIME_ : 开始任务时间
- END_TIME_ : 结束任务时间
- DURATION_ : 时长
- DELETE_REASON_ :从运行时任务表中删除的原因
- PRIORITY_ : 紧急程度
- DUE_DATE_ :
- ACT_HI_DETAIL：启动流程或者在任务complete之后,记录历史流程变量
- ID_ : 标识
- TYPE_ : variableUpdate 和 formProperty 两种值
- PROC_INST_ID_ : 对应流程实例id
- EXECUTION_ID_ : 对应执行实例id
- TASK_ID_ : 对应任务id
- ACT_INST_ID : 对应节点id
- NAME_ : 历史流程变量名称，或者表单属性的名称
- VAR_TYPE_ : 定义类型
- REV_ : 版本
- TIME_ : 导入时间
- BYTEARRAY_ID_
- DOUBLE_ : 如果定义的变量或者表单属性的类型为double，他的值存在这里
- LONG_ : 如果定义的变量或者表单属性的类型为LONG ,他的值存在这里
- TEXT_ : 如果定义的变量或者表单属性的类型为string，值存在这里
- TEXT2_:
- ACT_HI_COMMENT 意见表
- ID_ :标识
- TYPE_ : 意见记录类型 为comment 时 为处理意见
- TIME_ : 记录时间
- USER_ID_ :
- TASK_ID_ ： 对应任务的id
- PROC_INST_ID_ : 对应的流程实例的id
- ACTION_ ： 为AddComment 时为处理意见
- MESSAGE_ : 处理意见
- FULL_MSG_ :
结论及总结
- 流程文件部署主要涉及到3个表，分别是：ACT_GE_BYTEARRAY、ACT_RE_DEPLOYMENT、ACT_RE_PROCDEF。主要完成“部署包”-->“流程定义文件”-->“所有包内文件”的解析部署关系。从表结构中可以看出，流程定义的元素需要每次从数据库加载并解析，因为流程定义的元素没有转化成数据库表来完成，当然流程元素解析后是放在缓存中的，具体的还需要后面详细研究。
- 流程定义中的java类文件不保存在数据库里 。
- 组织机构的管理相对较弱，如果要纳入单点登录体系内还需要改造完成，具体改造方法有待研究。
- 运行时对象的执行与数据库记录之间的关系需要继续研究
- 历史数据的保存及作用需要继续研究。
Activiti使用Mybatis3做持久化工作，可以在配置中设置流程引擎启动时创建表。
Activiti使用到的表都是ACT_开头的。
ACT_RE_*:流程定义存储。
ACT_RU_*:流程执行记录，记录流程启动到结束的所有动作，流程结束后会清除相关记录。
ACT_ID_*:用户记录，流程中使用到的用户和组。
ACT_HI_*:流程执行的历史记录。
ACT_GE_*:通用数据及设置。
使用到的表：
ACT_GE_BYTEARRAY：流程部署的数据。
ACT_GE_PROPERTY：通用设置。
ACT_HI_ACTINST：流程活动的实例。
ACT_HI_ATTACHMENT：
ACT_HI_COMMENT：
ACT_HI_DETAIL：
ACT_HI_PROCINST：流程实例。
ACT_HI_TASKINST：任务实例。
ACT_ID_GROUP：用户组。
ACT_ID_INFO：
ACT_ID_MEMBERSHIP：
ACT_ID_USER：用户。
ACT_RE_DEPLOYMENT：部署记录。
ACT_RE_PROCDEF：流程定义。
ACT_RU_EXECUTION：流程执行记录。
ACT_RU_IDENTITYLINK：
ACT_RU_JOB：
ACT_RU_TASK：执行的任务记录。
ACT_RU_VARIABLE：执行中的变量记录。