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

小鱼儿 2023-03-04 03:29 5阅读 0赞

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 定义好候选组之后，属于该候选组的用户就可以签收然后办理该任务。

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);

![format_png][]

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

### 4.2 候选人 ###

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

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

定义好后，就可以在 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);

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

[format_png]: /images/20230208/de6a587127ac455abc13f4a7bab1df54.png