Activiti入门教程六（详解Activiti中的查询API）

 

     这篇博客呢，主要通过用户组为例，在把Activiti中的查询的API跟学习一下。任何知识，都能发现共同点，所以以后我们在学习的道路上面，一定要多多发现知识的共同点，建立知识之间的联系，这回让自己事半功倍的，并且学习效率会越来越高，废话不多说了，马上进入正题。

     先来张宏观图来看看吧！



     如果看不懂的话，不用担心，下面小编来一点一点的讲解一下，保证你能够清醒。

     Query接口

 

<span style="font-family:Comic Sans MS;font-size:18px;">public interface Query<T extends Query< ? , ? >, U extends Object> {
T asc();
T desc();
long count();
U singleResult();
List<U> list();
List<U> listPage(int firstResult, int maxResults);
}</span>

     这里面是什么东东呢，最底层的封装操作，通过上面的源码，我们可以看出，是一些排序、查询list，或者listPage分页查询之类的操作。那么这些方法的实现放置到了哪里呢，在上图中我们发现了一个抽象类AbstractQuery，Query接口中的这些方法，被AbstractQuery所实现。

     GroupQuery接口

     该接口继承自Query接口，并且扩展了一些属于自己的方法。

<span style="font-family:Comic Sans MS;font-size:18px;">public interface GroupQuery extends Query<GroupQuery, Group> {
GroupQuery groupId(String groupId);
GroupQuery groupName(String groupName);
GroupQuery groupNameLike(String groupNameLike);
GroupQuery groupType(String groupType);
GroupQuery groupMember(String groupMemberUserId);
GroupQuery potentialStarter(String procDefId);
GroupQuery orderByGroupId();
GroupQuery orderByGroupName();
GroupQuery orderByGroupType();

}</span>

   
 仔细一看上面的源码，又是一些关于自身的查询类的操作，比如通过用户组名称、用户组类型、根据用户组ID或者名称排序之类的操作。

     GroupQueryImpl类

   
 该类既继承AbstractQuery抽喜类，又实现了GroupQuery接口，一举两得，同时拥有了Query接口和GroupQuery接口的所有方法。

     IdentityService接口

<span style="font-family:Comic Sans MS;font-size:18px;">public interface IdentityService {
User newUser(String userId);
void saveUser(User user);
UserQuery createUserQuery();
NativeUserQuery createNativeUserQuery();
void deleteUser(String userId);
Group newGroup(String groupId);
GroupQuery createGroupQuery();
NativeGroupQuery createNativeGroupQuery();
void saveGroup(Group group);
void deleteGroup(String groupId);
void createMembership(String userId, String groupId);
void deleteMembership(String userId, String groupId);
boolean checkPassword(String userId, String password);
void setAuthenticatedUserId(String authenticatedUserId);
void setUserPicture(String userId, Picture picture);
Picture getUserPicture(String userId);
void setUserInfo(String userId, String key, String value);
String getUserInfo(String userId, String key);
List<String> getUserInfoKeys(String userId);
void deleteUserInfo(String userId, String key);
}</span>

     通过上述源码，我们可以看出，该接口主要用来管理用户组和用户的增删改查，其中关于查询的部分，又简介的依赖于UserQuery接口，这样就可以方便的进行查询操作了。

     以上就是Activiti底层有关查询的API的封装。说了这么多我们来通过一个实例来看一下。

<span style="font-family:Comic Sans MS;font-size:18px;">package org.crazyit.activiti;

import java.util.List;

import org.activiti.engine.IdentityService;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngineConfiguration;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.identity.Group;

public class ListPage {

/**
* @param args
*/
public static void main(String[] args) {
// 创建流程引擎
ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
// 得到身份服务组件实例
IdentityService identityService = engine.getIdentityService();
// 写入5条用户组数据
createGroup(identityService, "1", "userA", "typeA");
createGroup(identityService, "2", "userB", "typeB");
createGroup(identityService, "3", "userC", "typeC");
createGroup(identityService, "4", "userD", "typeD");
createGroup(identityService, "5", "userE", "typeE");
// 调用listPage方法，从索引为2的记录开始，查询3条记录
List<Group> datas = identityService.createGroupQuery().listPage(2, 3);
for (Group data : datas) {
System.out.println(data.getId() + "---" + data.getName() + " ");
}

List<Group> datas0 = identityService.createGroupQuery().list();
for (Group data : datas0) {
System.out.println(data.getId() + "---" + data.getName() + " ");
}

// 查询名称为userB的记录
Group groupB = identityService.createGroupQuery().groupName("userB")
.singleResult();
System.out.println(groupB.getId() + "---" + groupB.getName());

System.out.println("asc排序结果");
List<Group> datas2 = identityService.createGroupQuery()
.orderByGroupId().asc().list();
for (Group data : datas2) {
System.out.print(data.getId() + "---" + data.getName() + " ");
}
}

// 将用户组数据保存到数据库中
static void createGroup(IdentityService identityService, String id,
String name, String type) {
// 调用newGroup方法创建Group实例
Group group = identityService.newGroup(id);
group.setName(name);
group.setType(type);
identityService.saveGroup(group);
}

}
</span>

     上面讲解了这么多，通过学习Activit底层的封装操作，我们也可以按照这种思想，来封装属于我们底层的操作，尤其是对于一些ERP一类的系统，这种封装值得借鉴和学习。