antd中分页器如何⾃定义_SpringBoot项⽬中,如何更规范的
使⽤PageHelper分页?
SpringBoot项⽬中,如何更规范的使⽤PageHelper分页,拉勾IT课⼩编为⼤家分解
⼀. 开发准备
1. 开发⼯具
· IntelliJ IDEA 2020.2.3
2. 开发环境
· Red Hat Open JDK 8u256
· Apache Maven 3.6.3
3. 开发依赖
SpringBoot
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
MyBatis
<dependency>
<groupId&batis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.1.3</version>
</dependency>
PageHelper
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper-spring-boot-starter</artifactId>
<version>1.3.0</version>
</dependency>
⼆. 技术⽂档
1. 基于SpringBoot
· SpringBoot 官⽅⽂档 Spring Boot
· SpringBoot 中⽂社区 SpringBoot中⽂社区
2. 基于MyBatis
· MyBatis 官⽅⽂档 mybatis - MyBatis 3
3. 集成PageHelper
· PageHelper 开源仓库 pagehelper/Mybatis-PageHelper
三. 应⽤讲解
1. 基本使⽤
在实际项⽬运⽤中,PageHelper的使⽤⾮常便利快捷,仅通过PageInfo + PageHelper两个类,就⾜以完成分页功能,然⽽往往这种最简单的集成使⽤⽅式,却在很多实际应⽤场景中,没有得到充分的开发利⽤.
接下来是我们最常见的使⽤⽅式:
public PageInfo<ResponseEntityDto> page(RequestParamDto param) {
PageHelper.PageNum(), PageSize());
List<ResoinseEntityDto> list = mapper.selectManySelective(param);
PageInfo<ResponseEntityDto> pageInfo = (PageInfo<ResponseEntityDto>)list;
return pageInfo;
}
在某种程度上⽽⾔,上述写法的确是符合PageHelper的使⽤规范 :
在集合查询前使⽤PageHelper.startPage(pageNum,pageSize),并且中间不能穿插执⾏其他SQL
但是作为Developer的我们,往往只有在追求完美和极致的道路上才能够寻得突破和机遇;
以下是合理且规范的基本使⽤:
public PageInfo<ResponseEntityDto> page(RequestParamDto param) {
return PageHelper.PageNum(), PageSize())
.doSelectPageInfo(() -> list(param))
}
public List<ResponseEntityDto> list(RequestParamDto param) {
return mapper.selectManySelective(param);
}
FAQ
1. 为什么要重新声明⼀个list函数?
答: 往往在很多实际业务应⽤场景中, 分页查询是基于⼤数据量的表格展⽰需求来进⾏的.
然⽽很多时候,譬如: 内部服务的互相调⽤,OpenAPI的提供.
甚⾄在某些前后端分离联调的业务场景中,是同样需要⼀个⾮分页集合查询接⼝来提供服务的.
另外,暂时以上因素抛开不谈,我们可以根据上述写法来定义和规范某些东西
譬如: 分页和集合查询的分离和解耦(解耦详情请看进阶使⽤),
分页请求的请求和响应与实际业务参数的分离(详情请看进阶使⽤)等等…
2. doSelectPageInfo是什么?
答: doSelectPageInfo是PageHelper.startPage()函数返回的默认Page实例内置的函数,该函数可以⽤
以Lambda的形式通过额外的Function来进⾏查询⽽不需要再进⾏多余的PageInfo与List转换,⽽doSelectPageInfo的参数则是PageHelper内置的Function(ISelect)接⼝⽤以达到转换PageInfo的⽬的
3. 这种写法的代码量看起来不少反多?
答: 正如同①中所描述的,就代码量⽽⾔,确实没有更进⼀步的简化,但是再某些业务场景中,在已具有list函数接⼝的情况下,是⼀种更直观的优化(优化详情请看进阶使⽤)
2. 进阶使⽤
先看代码,再谈解析:
import com.github.pagehelper.PageHelper;
import com.github.pagehelper.PageInfo;
import java.util.List;
/**
* @param <Param> 泛型request
* @param <Result> 泛型response
*/
public interface BaseService<Param, Result> {
/**
* 分页查询
*
* @param param 请求参数DTO
* @return 分页集合
*/
default PageInfo<Result> page(PageParam<Param> param) {
return PageHelper.startPage(param).doSelectPageInfo(() -> Param()));
}
/**
* 集合查询
*
* @param param 查询参数
* @return 查询响应
*/
List<Result> list(Param param);
}
可以看到BaseService可以作为全局Service通⽤接⼝的封装和声明
⽽作为通⽤分页接⼝page函数却在此处利⽤interface特有关键字default 直接声明了page函数的⽅法体body
import com.github.pagehelper.IPage;
import lombok.Data;
perimental.Accessors;
@Data // 为省略冗余代码使⽤lombok 实际应有常规Getter/Setter Construction toString等
@Accessors(chain = true) // 此lombok注解是为了实现 Entity伪Build 譬如: entity.setX(x).setY(y)
public class PageParam<T> implements IPage {
// description = "页码", defaultValue = 1
private Integer pageNum = 1;
// description = "页数", defaultValue = 20
springboot中文private Integer pageSize = 20;
// description = "排序", example = "id desc"
private String orderBy;
// description = "参数"
private T param;
public PageParam<T> setOrderBy(String orderBy) {
return this;
}
}
在BaseService中我们看到了⼀个新的PageParam,参考了PageInfo⽤以包装/声明/分离分页参数和业务参数,且参数类型为泛型,即⽀持任何数据类型的业务参数
同时也可以看到PageParam实现了IPage接⼝,并且多了⼀个orderBy属性字段
import common.base.BaseService;
q.TemplateReqDto;
sp.TemplateRespDto;
public interface TemplateService extends BaseService<TemplateReqDto, TemplateeRespDto> {
// 同为interface接⼝, 业务Service只需要继承BaseService
// 并根据实际使⽤场景声明请求参数和响应结果的Entity实体即可
}
在实际应⽤中,只需要声明我们通⽤的业务查询请求参数和响应结果即可
q.TemplateReqDto;
sp.TemplateRespDto;
import service.TemplateService;
import persistence.mapper.TemplateMapper;
import lombok.RequiredArgsConstructor;
slf4j.Slf4j;
import org.springframework.stereotype.Service;
import java.util.List;
@Slf4j // 基于lombok⾃动⽣成logger⽇志记录实例
@Service // SpringBoot中注册Service Bean的注解
@RequiredArgsConstructor // 基于lombok根据类所有final属性⽣成构造函数 即可完成Spring构造注⼊
public class TemplateServiceImpl implements TemplateService {
private final TemplateMapper mapper;
@Override
public List<TemplateRespDto> list(TemplateReqDto param) {
return mapper.selectManySelective(param) // 可根据实际情况将实体做转换
}
}
实现类中也只需要重写list⽅法体,将实际业务场景中需要处理的业务逻辑处理和查询⽅法写⼊其中,并不需要关⼼分页功能@Slf4j // 同上
@RestController // SpringBoot中注册Controller Bean的注解
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论