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


前言

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

环境

软件版本
SpringBoot1.5.10
activiti-spring-boot-starter-basic6.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_系列表,创建的视图要保证数据类型,推荐。
爪哇笔记
爪哇笔记

作者: 小柒

出处: https://blog.52itstyle.vip

分享是快乐的,也见证了个人成长历程,文章大多都是工作经验总结以及平时学习积累,基于自身认知不足之处在所难免,也请大家指正,共同进步。

本文版权归作者所有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出, 如有问题, 可邮件(345849402@qq.com)咨询。