2017.2.20 activiti实战--第五章--用户与组及部署管理（一）用户与组

学习资料：《Activiti实战》

第五章 用户与组及部署管理（一）用户与组

内容概览：讲解activiti中内置的一套用户、组的关系，以及如何通过API添加、删除、查询。

5.1 用户与组

5.1.1 用户

 public class IdentityServiceTest{
     @Rule
     public ActivitiRule ar = new ActivitiRule();//使用默认的acitiviti.cfg.xml作为参数，当创建activitirule时，会自动创建引擎对象processEngine。

     @Test
     public void testUser() throws Exception(){
         IdentityService is = ar.getIdentityService();

         User user = is.newUser("henryyan");
         user.setFirstName("Henry");
         user.setLastName("yan");
         user.setEmail("yanhonglei@gamil.com");

         is.saveUser(user);

         User userInDb = is.createUserQuery().userId("henryyan").singleResult();
         assertNotNull(userInDb);

         is.deleteUser("henryyan");
         userInDb = is.createUserQuery().userId("henryyan").singleResult();
         assertNull(userInDb);
     }
 }

5.1.2 组

 public class IdentityServiceTest{
     @Rule
     public ActivitiRule ar = new ActivitiRule();//使用默认的acitiviti.cfg.xml作为参数，当创建activitirule时，会自动创建引擎对象processEngine。

     @Test
     public void testGroup() throws Exception(){
         IdentityService is = ar.getIdentityService();

         Group group = is.newGroup("deptLeader");
         group .setName("部门领导");
         group .setType("assignment");

         is.saveGroup(group);

         List<Group> groupList = is.createGroupQuery().groupId("deptLeader").list();
         assertEquals(1,groupList.size());

         is.deleteGroup("deptLeader");
         groupList = is.createGroupQuery().groupId("deptLeader").list();
         assertEquals(0,groupList.size());
     }
 }

5.1.3 用户与组的关系

 public class IdentityServiceTest{
     @Rule
     public ActivitiRule ar = new ActivitiRule();//使用默认的acitiviti.cfg.xml作为参数

     @Test
     public void testUserAndGroupMembership() throws Exception(){
         IdentityService is = ar.getIdentityService();

         Group group = is.newGroup("deptLeader");
         group .setName("部门领导");
         group .setType("assignment");
         is.saveGroup(group);

         User user = is.newUser("henryyan");
         user.setFirstName("Henry");
         user.setLastName("yan");
         user.setEmail("yanhonglei@gamil.com");
         is.saveUser(user);

         is.createMembership("henryyan","deptLeader");

         //查询组deptLeader所拥有的用户
         User userInGroup = is.createUserQuery().memberOfGroup("deptLeader").singleResult();
         assertNotNull(userInGroup);
         assertEquals("henryyan",userInGroup.getId());

         //查询用户henryyan所属的组
         Group groupContainsHenryyan = is.createGroupQuery().groupMember("henryyan").singleResult();
         assertNotNull(groupContainsHenryyan);
         assertEquals("deptLeader",groupContainsHenryyan.getId());
     }
  }

5.1.4 UserTask中的用户与组

（1）测试场景及测试模板

假设一个流程图示意图为：开始--->用户任务--->结束

共用的xml文件模板如下：

 <process id="userAndGroupInUserTask" name="userAndGroupInUserTask">
     <startEvent id="startEvent1" name="Start"></startEvent>
     <userTask id="studyUserAndGroupInUserTask" name="学习用户与组在用户任务中的应用"></userTask>
     <sequenceFlow id="flow1" name="" sourceRef="startEvent1" targetRef="studyUserAndGroupInUserTask"></sequenceFlow>
     <endEvent id="endEvent1" name="End"></endEvent>
     <sequenceFlow id="flow2" name="" sourceRef="studyUserAndGroupInUserTask" targetRef="endEvent1"></sequenceFlow>
 </process>

共用的测试代码模板如下：即此时有两个用户，位于组deptLeader里。

 public class UserAndGroupInUserTaskTest{
     @Before
     public void setup() throws Exception(){
         //初始化7个Service
         super.setUp();

         Group group = identityService.newGroup("deptLeader");
         group .setName("部门领导");
         group .setType("assignment");
         identityService.saveGroup(group);
         //henryyan示例，jackchen的略
         User user = identityService.newUser("henryyan");
         user.setFirstName("Henry");
         user.setLastName("yan");
         user.setEmail("yanhonglei@gmail.com");
         identityService.saveUser(user);
         //henryyan示例，jackchen的略
         identityService.createMembership("henryyan","deptLeader");
     }   

     @After
     public void afterInvokeTestMethod() throws Exception(){
         identityService.deleteMembership("henryyan","deptLeader");
         identityService.deleteGroup("deptLeader");
         identityService.deleteUser("henryyan");
     }
     ...
  }

（2）候选组

修改上面的UserTask如下：属于这个组的用户都可以签收任务。一旦有一个人签收，其他人的用户任务里就没有这个任务了。

 <userTask id="studyUserAndGroupInUserTask"
      name="学习用户与组在用户任务中的应用"
     activiti:candidateGroups="deptLeader">
 </userTask>

（3）候选人

修改上面的UserTask如下：列出来的用户都可以签收任务。一旦有一个人签收，其他人的用户任务里就没有这个任务了。

 <userTask id="studyUserAndGroupInUserTask"
       name="学习用户与组在用户任务中的应用"
      activiti:candidateUsers="jackchen,henryyan">
 </userTask>

（4）共用测试代码

在类userAndGroupTestInUserTask添加方法如下：

 1 public class UserAndGroupInUserTaskTest{
 2     @Test
 3     @Deployment(resources={"chapter5/userAndGroupInUserTask.bpmn"})
 4     public void testUserAndGroupInUserTask() throws Exception{
 5         ProcessInstance pi = runtimeService.startProcessInstanceByKey("userAndGroupInUserTask");
 6         assertNotNull(pi);
 7
 8         //该任务属于所有位于候选组的用户/ 该任务属于所有列出来的候选人
 9         Task jackchenTask = taskService.createTaskQuery().taskCandidateUser("jackchen").singleResult();
10         assertNotNull(jackchenTask);
11         Task henryyanTask = taskService.createTaskQuery().taskCandidateUser("henryyan").singleResult();
12         assertNotNull(henryyanTask);
13
14         taskService.claim(jackchenTask.getId(),"jackchen");//jackchen签收任务
15         //taskService.complete(jackchenTask.getId());//jackchen完成任务
16
17         //被jackchen签收后，henryyan不再拥有该任务
18         henryyanTask = taskService.createTaskQuery().taskCandidateUser("henryyan").singleResult();
19         assertNull(henryyanTask);
20     }
21 }

综上，主要涉及的方法：

 主要涉及到的方法：
 //创建、保存和删除用户/组
 User user/Group group = identityService.newUser("userid")/newGroup("groupid");
 identityService.saveUser("userid")/saveGroup("groupid");
 identityService.deleteUser("userid")/deleteGroup("groupid");

 //查询User
 User user = identityService.createUserQuery().userId("userid").singleResult();
 List<User> userList = identityService.createUserQuery().userId("userid").list();
 //查询Group
 Group group = identityService.createGroupQuery().groupId("groupid").singleResult();
 List<Group> groupList = identityService.createGroupQuery().groupId("groupid").list();

 //创建、查询关系
 identityService.createMembership("userid",groupid);
 User userInGroup = identityService.createUserQuery().memberOfGroup("deptLeader").singleResult();
 Group groupContainsHenryyan = identityService.createGroupQuery().groupMember("henryyan").singleResult();

 //查询用户拥有的任务，签收及完成
 Task task = taskService.createTaskQuery().taskCandidateUser("userid").singleResult();
 List<Task> taskList = taskService.createTaskQuery().taskCandidateUser("userid").list();
 taskService.claim(task.getId(),"userid");
 taskService.complete(task.getId());