统计总数
Page<?> page = PageHelper.startPage(1,-1); long count = page.getTotal();
分页
pageNum - 第N页, pageSize - 每页M条数
- 只分页不统计(每次只执行分页语句)
PageHelper.startPage(N,M); List<?> pagelist = queryForList( xxx.class, "queryAll" , param);//pagelist就是分页之后的结果
- 分页并统计(每次执行2条语句,一条select count语句,一条分页语句)
适用于查询分页时数据发生变动,需要将实时的变动信息反映到分页结果上
Page<?> page = PageHelper.startPage(N,M,true); List<?> pagelist = queryForList( xxx.class , "queryAll" , param); long count = page.getTotal();
//也可以 List<?> pagelist = page.getList(); 获取分页后的结果集
查全部(不分页)
PageHelper.startPage(1,0); List<?> alllist = queryForList( xxx.class , "queryAll" , param);
其他API
String orderBy = PageHelper.getOrderBy(); //获取orderBy语句 Page<?> page = PageHelper.startPage(Object params); Page<?> page = PageHelper.startPage(pageNum, pageSize, orderBy); Page<?> page = PageHelper.startPage(pageNum, pageSize, isCount, isReasonable); //isReasonable分页合理化,null时用默认配置 Page<?> page = PageHelper.startPage(pageNum, pageSize, isCount, isReasonable, isPageSizeZero); //isPageSizeZero是否支持PageSize为0,true且pageSize=0时返回全部结果,false时分页,null时用默认配置
默认值
//RowBounds参数offset作为PageNum使用 - 默认不使用 private boolean offsetAsPageNum = false; //RowBounds是否进行count查询 - 默认不查询 private boolean rowBoundsWithCount = false; //当设置为true的时候,如果pagesize设置为0(或RowBounds的limit=0),就不执行分页,返回全部结果 private boolean pageSizeZero = false; //分页合理化 private boolean reasonable = false; //是否支持接口参数来传递分页参数,默认false private boolean supportMethodsArguments = false;
补充
pageHelper什么时候会导致不安全的分页?
PageHelper 方法使用了静态的 ThreadLocal 参数,分页参数和线程是绑定的。
只要你可以保证在 PageHelper 方法调用后紧跟 MyBatis 查询方法,这就是安全的。因为 PageHelper 在 finally 代码段中自动清除了 ThreadLocal 存储的对象。
如果代码在进入 Executor 前发生异常,就会导致线程不可用,这属于人为的 Bug(例如接口方法和 XML 中的不匹配,导致找不到 MappedStatement 时), 这种情况由于线程不可用,也不会导致 ThreadLocal 参数被错误的使用。
应该写成下面这个样子:
List<Country> list; if(param1 != null){ PageHelper.startPage(1, 10); list = countryMapper.selectIf(param1); } else { list = new ArrayList<Country>(); }
这种写法就能保证安全