Activiti 开发案例之 API 映射 SQL 查询

点击▲关注 “爪哇笔记”   给公众号标星置顶

更多精彩 第一时间直达

前言

Activiti 自身提供了一套用户管理，但是在开发中业务系统本身就有一套用户管理系统，这时候就要把业务系统中的部分用户数据同步到 Activiti 用户表管理中。那么，如果不同步呢？不少开发者一开始以为必须要有用户才可以运行，其实Task的Assigne，CandidateUsers， Candidate Groups信息已经以字符串形式保存在 act_ru_tak 和 ACT_RU_IDENTITYLINK 表中。只有少部分的查询 API 会用到 ACT_ID_*表中的数据进行关联查询。

环境

软件	版本
SpringBoot	1.5.10
activiti-spring-boot-starter-basic	6.0

查询

taskAssignee

按照指派人查询，直接查询表 ACT_RU_TASK。

API：

taskService.createTaskQuery().taskAssignee(userId);

SQL：

select distinct RES.* from ACT_RU_TASK RES WHERE RES.ASSIGNEE_ = ?

taskCandidateGroup

按照分配组查询，没有用到 ACT_ID_* 表的数据。

API：

taskService.createTaskQuery().taskCandidateGroup("部门经理");

SQL：

SELECT DISTINCT	
  RES.*	
FROM ACT_RU_TASK RES	
  INNER JOIN ACT_RU_IDENTITYLINK I	
    ON I.TASK_ID_ = RES.ID_	
WHERE RES.ASSIGNEE_ IS NULL	
    AND I.TYPE_ = 'candidate'	
    AND (I.GROUP_ID_ IN(?))

taskCandidateGroupIn

按照分配组查询，没有用到 ACT_ID_*表的数据。

API：

List<String> candidateGroups = new ArrayList<String>();	
candidateGroups.add("部门经理");	
candidateGroups.add("总裁");	
taskService.createTaskQuery().taskCandidateGroupIn (candidateGroups);

SQL：

SELECT DISTINCT	
  RES.*	
FROM ACT_RU_TASK RES	
  INNER JOIN ACT_RU_IDENTITYLINK I	
    ON I.TASK_ID_ = RES.ID_	
WHERE RES.ASSIGNEE_ IS NULL	
    AND I.TYPE_ = 'candidate'	
    AND (I.GROUP_ID_ IN(?))

taskCandidateOrAssigned

按照分配组 OR 指派人查询，用到了 ACT_ID_*表的数据，传入userId查询其所在权限组。

API:

taskService.createTaskQuery().taskCandidateOrAssigned(userId);

SQL:

首先查询用户所在组权限

SELECT	
  g.*	
FROM ACT_ID_GROUP g,	
  ACT_ID_MEMBERSHIP membership	
WHERE g.ID_ = membership.GROUP_ID_	
    AND membership.USER_ID_ = ?

然后查询指派人任务或者指派人为空并且用户所在权限组的任务

SELECT DISTINCT	
  RES.*	
FROM ACT_RU_TASK RES	
  LEFT JOIN ACT_RU_IDENTITYLINK I	
    ON I.TASK_ID_ = RES.ID_	
WHERE (RES.ASSIGNEE_ = ?	
        OR (RES.ASSIGNEE_ IS NULL	
            AND (I.USER_ID_ = ?	
                  OR I.GROUP_ID_ IN(SELECT	
                                      g.GROUP_ID_	
                                    FROM ACT_ID_MEMBERSHIP g	
                                    WHERE g.USER_ID_ = ?))))

taskCandidateUser

API：

taskService.createTaskQuery().taskCandidateUser(userId);

• 先查找用户所属的组（用户所属用户组的信息从 Activiti 的 ACT_ID_* 表获取）

SELECT	
  g.*	
FROM ACT_ID_GROUP g,	
  ACT_ID_MEMBERSHIP membership	
WHERE g.ID_ = membership.GROUP_ID_	
    AND membership.USER_ID_ = ?

• 如果找到了用户组信息

SELECT DISTINCT	
  RES.*	
FROM ACT_RU_TASK RES	
  INNER JOIN ACT_RU_IDENTITYLINK I	
    ON I.TASK_ID_ = RES.ID_	
WHERE RES.ASSIGNEE_ IS NULL	
    AND I.TYPE_ = 'candidate'	
    AND (I.USER_ID_ = ?	
          OR I.GROUP_ID_ IN(?))

• 如果找不到用户所属的组

SELECT DISTINCT	
  RES.*	
FROM ACT_RU_TASK RES	
  INNER JOIN ACT_RU_IDENTITYLINK I	
    ON I.TASK_ID_ = RES.ID_	
WHERE RES.ASSIGNEE_ IS NULL	
    AND I.TYPE_ = 'candidate'	
    AND (I.USER_ID_ = ?)

按照所属人查询 taskOwner

API：

taskService.createTaskQuery().taskOwner(userId);

SQL：

SELECT DISTINCT	
  RES.*	
FROM ACT_RU_TASK RES	
WHERE RES.OWNER_ = ?

日志

在 logback.xml 追加以下配置，就可以输出 Activiti 查询语句。

<!-- Activiti日志 -->	
<logger name="org.activiti" level="INFO" />	
<logger name="org.activiti.engine.impl.persistence.entity" level="DEBUG" />

说明

有些查询使用到 Activiti 自带的用户信息的，比如 taskCandidateOrAssigned，如果项目中使用了自己的权限系统，这些 API 是不灵光的，这里提供三种方案，仅供参考：

• 同步系统用户权限信息到 Activiti 自带用户组，不推荐。

• 修改源代码 Task.xml 中的查询SQL，把 Activiti 自带的用户表替换成业务系统用户表，不推荐。

• 用视图覆盖同名的 ACT_ID_ 系列表，创建的视图要保证数据类型，推荐。

▲一个有温度的公众号，期待与你一起进步