文章目录

前言
一、PageHelper实现分页查询
二、PageHelper的基本使用
- 1. 先编写持久层
- 2.编写业务逻辑层
- 3..编写控制层
- 4.使用JsonPage返回结果
总结

前言

分页查询的优点

所谓分页,就是查询结果数据较多时,采用按页显示的方法,而不是一次性全部显示

分页的优点:

服务器:一次性查询所有信息,服务器压力大,分页查询服务器压力小
客户端:一次性显示所有信息,需要更多流量,加载时间也会更长,分页显示没有这个问题
用户体验上:一般最有价值的信息都会在前几页显示,也方便用户记忆,多查询出来的数据使用几率很低

提示：以下是本篇文章正文内容，下面案例可供参考

一、PageHelper实现分页查询

在开发过程中实现分页查询，我们可以使用sql语句中添加limit关键字的方法实现分页查询

但是查询分页内容时,我们要自己计算相关的分页信息和参数

limit 0,10 limit 10,10

分页逻辑无论什么业务都是类似的,所以有框架帮助我们高效实现分页功能。

PageHelper框架可以实现我们提供页码和每页条数,自动实现分页效果,收集分页信息。

PageHelper的分页原理就是在程序运行时,在sql语句尾部添加limit关键字,并按照分页信息向limit后追加分页数据。

要想使用,首先还是添加依赖

我们在之前搭建的微服务项目中先编写学习,建议使用csmall-order模块

<dependency><groupId>com.github.pagehelper</groupId><artifactId>pagehelper-spring-boot-starter</artifactId>
</dependency>

在添加seata支持时已经添加了pagehepler依赖。

二、PageHelper的基本使用

1. 先编写持久层

我们使用csmall-order-webapi模块来完成分页的测试

首先编写分页的持久层mapper,持久层功能是全查所有订单信息

OrderMapper添加方法

// 分页查询全部订单
// PageHelper框架是自动在sql语句后添加limit关键字实现分页的
// 因为这个特性,我们编写的查询语句,和不分页时是一样的
@Select("select id,user_id,commodity_code,count,money from order_tbl")
List<Order> findAllOrders();

注意这个方法并不需要任何分页的参数或返回值,sql也不需要编写limit

都是在业务逻辑层中由PageHelper框架处理的

2.编写业务逻辑层

下面就转到业务逻辑层实现类,先编写一个方法使用PageHelper的功能

先不用写接口,直接在业务逻辑层中写方法

OrderServiceImpl添加方法

// 分页查询所有订单的方法
// page 是页码
// pageSize 是每页条数
public PageInfo<Order> getAllOrdersByPage(Integer page,Integer pageSize){// PageHepler框架实现分页最核心的代码就是在运行要分页的查询语句之前// 通过框架给定的方法设置要分页查询的要求(第几页,每页多少条)// 参数page和SpringData框架的设计不同,page为1就是第一页,page为2就是第二页PageHelper.startPage(page,pageSize);// 当上面设置完分页要求后,下面紧随的下一次查询,// 就会自动在sql语句末尾添加limit关键字,limit后面的值就是按page,pageSize得出的List<Order> list= orderMapper.findAllOrders();// list并不是全部的订单的集合,而是按上面分页条件查询出的分页数据// 在返回时不直接返回list对象,而是返回PageHelper框架提供的PageInfo类型对象// 这个对象可以保存list集合的同时,还能自动计算分页信息return new PageInfo<>(list);
}

PageInfo对象既包含查询数据结果,又包含分页信息

数据结构如下图

在这里插入图片描述
附:PageInfo全部分页信息属性

3…编写控制层

在OrderController类中添加调用分页方法

@GetMapping("/page")
@ApiOperation("分页查询所有订单")
@ApiImplicitParams({@ApiImplicitParam(value = "页码",name = "page" ,example = "1"),@ApiImplicitParam(value = "每页条数",name = "pageSize" ,example = "6")
})
public JsonResult<PageInfo<Order>> pageOrders(Integer page,Integer pageSize){//  执行分页查询的业务逻辑层PageInfo<Order> pageInfo=orderService.getAllOrdersByPage(page,pageSize);return JsonResult.ok("查询完成",pageInfo);}

启动Nacos\Seata

启动order

进行knife4j测试http://localhost:20002/doc.html#/home

可以观察控制台输出的运行的sql语句(会自动添加limit关键字)

4.使用JsonPage返回结果

当前我们分页查询返回的类型是PageInfo

如果用这个类型来做业务逻辑层的返回值,当当前方法作为dubbo生产者对外提供服务时

消费者调用该服务需要使用PageInfo类型对象来接收,这样要求消费者也添加PageHepler依赖,这是不合理的

所以我们设计在commons模块中,添加一个专门用于返回分页结果的类JsonPage,代替PageInfo

这样当前微服务项目中,所有分页或类似的操作,就都可以使用这个类了

例如之前SpringDataElasticsearch框架也支持分页,返回类型为Page,它也可以替换为JsonPage

因为需要在commons模块中使用PageInfo类型,所以commons模块要添加pageHelper的依赖

<!--  为了将PageHelper框架中分页查询返回值PageInfo转换为JsonPage,添加的依赖  -->
<dependency><groupId>com.github.pagehelper</groupId><artifactId>pagehelper</artifactId><version>5.2.0</version>
</dependency>

在restful包中新建一个JsonPage类

代码如下

// 通用的返回各种类型分页结果的信息类
@Data
public class JsonPage<T> implements Serializable {// 根据实际需求,定义需要的分页信息// 实际开发中可能较多,我们这里就声明4个基本的@ApiModelProperty(value = "总页数",name = "totalPages")private Integer totalPages;@ApiModelProperty(value = "总条数",name = "totalCount")private Long totalCount;@ApiModelProperty(value = "当前页码",name = "page")private Integer page;@ApiModelProperty(value = "每页条数",name = "pageSize")private Integer pageSize;// 如果需要再添加其它属性即可// 除了分页信息,还有查询出的分页数据@ApiModelProperty(value = "分页数据",name = "list")private List<T> list;// 上面定义了所有分页数据需要的属性// 下面可以编写一个将PageInfo类型转换为JsonPage类型的方法// 如果需要将其它框架的分页对象转换,例如SpringData的Page类,那么就再编写新的方法即可public static <T> JsonPage<T> restPage(PageInfo<T> pageInfo){// 开始进行转换,基本思路是将pageInfo对象中的数据赋值给JsonPage对象JsonPage<T> result=new JsonPage<>();// 赋值分页信息result.setTotalPages(pageInfo.getPages());result.setTotalCount(pageInfo.getTotal());result.setPage(pageInfo.getPageNum());result.setPageSize(pageInfo.getPageSize());//  赋值分页数据result.setList(pageInfo.getList());// 别忘了返回return result;}
}

下面去使用这个类

csmall-order-service业务逻辑层接口项目添加方法

返回值使用JsonPage

// 返回JsonPage类型的分页查询全部订单方法
JsonPage<Order> getAllOrdersByPage(Integer page,Integer pageSize);

csmall-order-webapi项目实现类中进行修改

//     ↓↓↓↓↓↓↓↓
public JsonPage<OrderTb> getAllOrdersByPage(Integer pageNum, Integer pageSize){PageHelper.startPage(pageNum,pageSize);List<OrderTb> list= orderMapper.findAllOrders();//     ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓return JsonPage.restPage(new PageInfo<>(list));
}

业务逻辑层返回值的修改影响控制器方法的调用

再去修改OrderController中方法调用的位置

@Autowired
//      ↓↓↓↓↓↓↓↓↓↓↓↓
private IOrderService orderService;//...
//                ↓↓↓↓↓↓↓↓
public JsonResult<JsonPage<Order>> pageOrders(Integer pageNum, Integer pageSize){// 分页调用//↓↓↓↓↓↓        ↓↓↓↓↓↓↓↓↓  JsonPage<Order> jsonPage=orderService.getAllOrdersByPage(pageNum,pageSize);//                            ↓↓↓↓↓↓↓↓↓↓return JsonResult.ok("查询完成",jsonPage);
}