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

Activiti 中的用户与组用于界定任务的候选者与办理者。组能够理解为角色，属于某个组的用户，就能够做为某个任务的候选者或者办理者。编程

咱们还能够经过 Activiti 的 API 来建立、查询或删除某个用户或者某个组。Activiti 还提供了创建关系的 API 用于绑定用户与组之间的关系。框架

1 用户

（1）建立用户ide

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) 持久化该用户。3d

（2）查询用户code

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

这里把 userId 做为查询条件，查询出刚刚建立的用户。UserQuery 类中的方法（好比这里的 userId 方法）大都支持链式操做。链式操做指的是这些方法都会返回类对象自己，这样咱们就能够像一根链条同样调用这些类方法。对象

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

（3）删除用户ip

identityService.deleteUser(userId);

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

2 组

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

//新建组对象
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);

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