说说 Activiti 中的用户与组的概念

Activiti 中的用户与组用于界定任务的候选者与办理者。组可以理解为角色，属于某个组的用户，就可以作为某个任务的候选者或者办理者。

我们还可以通过 Activiti 的 API 来创建、查询或删除某个用户或者某个组。Activiti 还提供了建立关系的 API 用于绑定用户与组之间的关系。

1 用户

（1）创建用户

User user = identityService.newUser(userId);
user.setFirstName("Deniro");
user.setLastName("Lee");
user.setEmail("xxx@163.com");
identityService.saveUser(user);

首先使用 identityService 的 newUser(String userId)，创建一个 User 对象；然后设置其相关属性，最后调用saveUser(User user) 持久化该用户。

（2）查询用户

identityService.createUserQuery().userId(userId).singleResult()

这里把 userId 作为查询条件，查询出刚刚创建的用户。UserQuery 类中的方法（比如这里的 userId 方法）大都支持链式操作。链式操作指的是这些方法都会返回类对象本身，这样我们就可以像一根链条一样调用这些类方法。

链式编程的表现形式为多个方法以 “.” 分割。在调用并执行完一个方法之后，该方法返回当前方法的对象实例，这样可以继续调用返回对象实例的其他方法。链式编程可以减少临时变量，而且可以让代码更加优雅，所以在各种框架或组件中经常出现。 Activiti 中所有以 Query 为结尾的类都支持链式编程。

（3）删除用户

identityService.deleteUser(userId);

userId 作为入参，调用 deleteUser 方法，就会删除该用户。

2 组

在 Activiti 中，组的类型分为 assignment 和 security-role ，前者是普通角色，用于分配业务功能权限；后者是管理角色，用于管理组织结构与流程。

//新建组对象
Group group = identityService.newGroup(groupId);
group.setName("部门领导");
group.setType("assignment");

//保存
identityService.saveGroup(group);

IdentityService 类中也有对应的新建、保存、查询与删除组的方法。

3 关系

用户与组之间的关系是多对多。一个用户可以归属于多个组；而一个组也可以包含多个用户。

//把用户加到指定组
identityService.createMembership(userId, groupId);

//查询指定组下的用户
User userInGroup = identityService.createUserQuery().memberOfGroup(groupId).singleResult();

//查询指定用户下的组
Group groupContainUser = identityService.createGroupQuery().groupMember(userId).singleResult();

利用 reateMembership(String userId, String groupId) 方法，就可以建立用户与组之间的关系。

如果要查询指定组下的所有用户，那么需要先创建 UserQuery 对象，然后调用 memberOfGroup(String groupId) 方法，就会生成查询所有隶属于该组下的用户 SQL。

而要查询指定用户下的组，则需要创建 GroupQuery 对象，然后调用 groupMember(String groupMemberUserId) 方法。

4 任务中的用户与组

这里的任务指的是 userTask，即需要人办理的任务。我们可以把任务先指定给一个或多个候选人或候选组。这样，只有这个任务被某个人签收后，它才能被办理。

4.1 候选组

可以在 bpmn 文件中的 userTask 标签内，通过 activiti:candidateGroups 来指定候选组，形如：

<userTask id="usertask1" name="User Task" activiti:candidateGroups="deptLeader"></userTask>

userTask 定义好候选组之后，属于该候选组的用户就可以签收然后办理该任务。

Task task = taskService.createTaskQuery().taskCandidateUser(userId).singleResult();
taskService.claim(task.getId(), userId);
taskService.complete(task.getId());

如果候选组中存在多个用户，那么只有其中的某个用户签收了任务，那么其它用户就看不到该任务咯：

//属于候选组的用户，都可以查询到该任务
TaskService taskService = getTaskService();
Task task = taskService.createTaskQuery().taskCandidateUser(userId).singleResult();
Assert.assertNotNull(task);
Task task2 =
        taskService.createTaskQuery().taskCandidateUser(otherUserId).singleResult();
Assert.assertNotNull(task2);

//deniro 签收任务
taskService.claim(task.getId(), userId);

//签收后，原候选组中的用户就看不到刚才的任务
task2 =
        taskService.createTaskQuery().taskCandidateUser(otherUserId).singleResult();
Assert.assertNull(task2);

只要任务还未被签收，候选组内的任意用户都可以签收该任务；一旦任务被签收，候选组内的其他用户就无法查看与签收该任务咯。

4.2 候选人

也可以跳过候选组，直接把用户分配给多个候选人。

首先在 bpmn 文件的 userTask 标签中，定义 activiti:candidateUsers，多个候选人以逗号分隔，这里一般使用 userId。

 <userTask id="usertask1" name="User Task"
                  activiti:candidateUsers="deniro, jack"></userTask>

定义好后，就可以在 API 中，让指定候选人查看并签收该任务：

//根据用户ID查询任务
TaskService taskService = getTaskService();
Task task = taskService.createTaskQuery().taskCandidateUser(userId1).singleResult();
assertNotNull(task);
Task task2 = taskService.createTaskQuery().taskCandidateUser(userId2).singleResult();
assertNotNull(task2);

//某个候选人签收
taskService.claim(task.getId(), userId1);

//其他候选人看不到该任务
task2 = taskService.createTaskQuery().taskCandidateUser(userId2).singleResult();
assertNull(task2);

某个候选人签收后，其他候选人就看不到该任务咯。