sql2java-pagehelper:参照Mybatis-PageHelper实现分页查询
sql2java-pagehelper:参照Mybatis-PageHelper实现分页查询
sql2java是我几年年开始写的一个sql2java是一个轻量级数据库(SQL)访问代码(java)生成器。这几年一直在根据工作需要维护升级，最近的项目中需要对数据库的记录提供分页查询功能，于是我参照Mybatis-PageHelper并借用其外部数据格式为sql2java实现的分页功能,将其封装为一个sql2java子项目sqlj2ava-pagehelper。使用方式与Mybatis-Pagehelper基本一致。
基本原理
PageHelper的基本原理是应用层通过调用PageHelper.startPage方法在一个静态全局的线程局部变量(ThreadLocal)中保存分页查询的标志及相关的数据(参见gu.sql2java.pagehelper.Page,参见gu.sql2java.pagehelper.PageHelper 的getLocalPage,setLocalPage方法),这样就激活了分页查询功能，
sql2java底层在执行SELECT查询语句时会根据保存在ThreadLocal中的Page对象为应用层提供的SELECT语句自动拼接分页查询语法。如果当前线程的ThreadLocal变量中没有Page对象或Page.enable字段为false那么就是普通的SQL查询。
引入依赖
maven下引入sql2java-pagehelper项目依赖
<dependency>
<groupId>com.gitee.com</groupId>
<artifactId>sql2java-pagehelper</artifactId>
<version>3.11.1</version>
</dependency>调用示例
调用示例如下：
import java.util.List;
import org.junit.BeforeClass;
import org.junit.Test;
import gu.sql2java.Managers;
import gu.sql2java.Managers.Module;
import gu.sql2java.pagehelper.Page;
import gu.sql2java.pagehelper.PageHelper;
import gu.sql2java.pagehelper.PageInfo;
import net.facelib.eam.devicecenter.db.DeviceBean;
import static net.facelib.eam.devicecenter.DaoManagement.DM;
import static net.gdface.utils.SimpleLog.log;
public class PageHelperTest {
@BeforeClass
public static void setUpBeforeClass() throws Exception {
// 输出调试信息
Managers.setDebug(true, Module.BASETABLEMANAGER);
}
@SuppressWarnings({ "rawtypes", "resource" })
@Test
public void test1LoadByWhere() {
try {
// 启动分页查询
PageHelper.startPage(1, 2);
// 正常执行sql2java的SQL查询
List<DeviceBean> devices = DM.daoLoadDeviceByWhere("WHERE id>0 order by id", 1, -1);
PageInfo<DeviceBean> pageInfo = PageInfo.of(devices);
log("pageInfo {}",pageInfo);
} finally {
// 删除ThreadLocal变量
PageHelper.clearPage();
}
}
}暂时禁用PageHelper
根据《基本原理》一节中的说明我们知道，PageHelper是依赖线程局部变量(ThreadLocal)来标记是否启动分页查询的。ThreadLocal变量作用于当前线程。当分页查询启动时，在当前线程中调用sql2java的任何SELECT查询都会被视为分页查询。
而在现实的场景中，我们实现一个提供分页查询的服务方法时，有可能往往不会只执行一次SELECT查询就能返回需要的需要数据，有可能在执行主要的分页查询获取数据后还要执行其他的正常查询，在多次查询的结果基础组装用户需要的数据。所以这里就存在分页查询激活的状态下，分页查询和普通查询混合调用。
如果在调用时不加以区分，sql2java会将所有我们希望执行的普通查询都以分页查询对待，那么返回的结果肯定是不对的。
为了能在分页查询激活的状态下，实现执行普通查询。从3.11.1版本起，gu.sql2java.SqlRunner接口(TableManager继承了此接口)增加了runWithNoPage(Callable),runWithNoPage(Runnable)方法，为应用层提供了在分页查询激活的状态下，临时禁用分页查询，执行普通查询的简单方式.
示例如下：
/** 暂时禁用分页查询执行 loadUsingTemplateAsList */
List<B> beans = deviceManager.runWithNoPage(()->deviceManager.loadUsingTemplateAsList(bean));@Sql2javaEnablePage注解
gu.sql2java.pagehelper.annotations.Sql2javaEnablePage 是用于服务方法上启动分页查询的注解类。
注解类字段说明如下
字段名 | 默认值 | 默认字段定义值 | 说明 |
|---|---|---|---|
value | true | 为true启用分页查询 | |
pageNumKey | "pageNum" | 1 | HTTP请求中定义pageNum(页码参数,1-based)的属性名 |
pageSizeKey | "pageSize" | 10 | HTTP请求中定义pageSize(每页数量)的属性名 |
countKey | "count" | HTTP请求中定义count(是否进行count查询,默认true)的属性名 | |
countColumnKey | “countColumn” | “0” | HTTP请求中定义count查询的字段名的属性名,如果不定义则默认字段名为"0" |