SpringDataJPA 分页 排序与动态查询

分页

创建

Page page =PageRequest.of(“1”,”1”);

page - 从零开始的索引页

size- 要返回的页面的大小

sort - 排序

修饰符和类型 方法和描述

你也可以创建没有排序的分页
static PageRequest of(int page, int size)

static PageRequest of(int page, int size, Sort.Direction direction, String… properties)
更方便的是可以一行代码创建有排序方向和属性的分页
static PageRequest of(int page, int size, Sort sort)
比如我们想遍历整个数据表，就可以使用分页遍历，这样不至于一次把数据全部加载到内存。

修饰符和类型 方法和描述
Pageable first() 请求第一页。
Sort getSort() 返回排序参数。
Pageable next() 请求下一个页面。
PageRequest previous() 请求前一页。
注意：在使用next()方法时，不要把pageable.next()直接作为参数传入方法，如repository.findAll(page.next())这样的写法会导致死循环。查看next()方法的源码发现这个方法只是帮我们new了一个新的Pageable对象，原来的pageable还是没啥变化。一直next()下去也只是在原地踏步。

public Pageable next() {
    return new PageRequest(getPageNumber() + 1, getPageSize(), getSort());
}

正确的写法：

repository.findAll(pageable = pageable.next());

Spring Data Jpa除了会通过命名规范帮助我们扩展Sql语句外，还会帮助我们处理类型为Pageable的参数，将pageable参数转换成为sql语句中的条件，同时，还会帮助我们处理类型为Page的返回值，当发现返回值类型为Page，Spring Data Jpa将会把数据的整体信息、当前数据的信息，分页的信息都放入到返回值中。这样，我们就能够方便的进行个性化的分页查询。

总页数

int getTotalPages()
元素的总数

long getTotalElements()
返回当前页的索引（是第几页）

int getNumber()
返回作为List的页面内容

List getContent()
返回当前在这个页上的元素的数量

int getNumberOfElements()
返回用于请求当前页的Pageable

default Pageable getPageable()
返回页的大小。

int getSize()
返回页的排序参数。

Sort getSort()
页面是否有内容。

boolean hasContent()
是否有下一页。

boolean hasNext()
是否有上一页

boolean hasPrevious()
当前页是否是第一个

boolean isFirst()
当前页是否是最后一个

boolean isLast()
下一页的Pageable

Pageable nextPageable()
上一页的Pageable

Pageable previousPageable()

排序

通过一行代码就可以快速使用：

Sort sort = new Sort(Sort.Direction.DESC, “id”);
在Sort类中定义了一个枚举类型Direction，该枚举类型声明了两个常量ASC，DESC定义方向。该构造方法的第一个参数指明方向降序（DESC）或升序（ASC），第二个参数指明以id列的值为准进行排序。

你也可以创建一个多属性的Sort实例。

Sort(Sort.Direction direction, List properties)
你也可以只传入属性而不声明方向：

Sort(String… properties)
不过官方已经弃用该方法，推荐使用

public static Sort by(String… properties)
当你不声明方向时，默认方向为升序。

public static final Direction DEFAULT_DIRECTION = Direction.ASC;
Sort的一些方法

修饰符和类型 方法和描述
Sort and(Sort sort)
返回由当前排序的排序顺序与给定的排序顺序组成的新排序。
Sort ascending()
返回具有当前设置但升序方向的新排序。
static Sort by(List<Sort.Order> orders)
为给定的Sort.Order创建一个新的排序。
static Sort by(Sort.Direction direction, String… properties)
创建一个新的排序。
static Sort by(Sort.Order… orders)
Creates a new Sort for the given Sort.Orders.
static Sort by(String… properties)
Creates a new Sort for the given properties.
Sort descending()
返回具有当前设置但顺序相反的新排序。
boolean equals(Object obj)
Sort.Order getOrderFor(String property)
根据property获取Order
boolean isSorted()
boolean isUnsorted()
Iterator<Sort.Order> iterator()
static Sort unsorted()
返回一个根本没有排序设置的排序实例。
Sort.Order
Sort.Order是Sort的一个静态内部类，官方说明是：PropertyPath实现了排序的配对。方向和属性。它用于提供排序的输入 。

简单来讲，你可以定义一个Order，在需要时传入order构建Sord实例。

Order(Sort.Direction direction, String property)
更独特的使用是加入自己的空处理提示的枚举：

Order(Sort.Direction direction, String property, Sort.NullHandling nullHandlingHint)
Sort.NullHandling是可用于排序表达式的空处理提示的枚举。对使用的数据存储的一种提示，用于在非空条目之后对具有空值的条目进行排序。

在需要Sort时，可通过Order创建：

Sort(Sort.Order… orders)
Sort.Order的一些方法

修饰符和类型 方法和描述
static Sort.Order asc(String property)
创建升序的Order实例
static Sort.Order by(String property)
创建默认方向的Order实例
static Sort.Order desc(String property)
创建降序的Order实例
Sort.Direction getDirection()
Sort.NullHandling getNullHandling()
String getProperty()
Sort.Order ignoreCase()
开启不分大小写排序
boolean isAscending()
返回此属性的排序是否要升序。
boolean isDescending()
返回此属性的排序是否应该降序。
boolean isIgnoreCase()
返回该排序是否区分大小写。
Sort.Order nullsFirst()
返回 Sort.Order 使用 Sort.NullHandling.NULLS_FIRST 作为空处理提示。First：第一个
Sort.Order nullsLast()
返回 Sort.Order 使用Sort.NullHandling.NULLS_LAST 作为空处理提示。Last：最后一个
Sort.Order nullsNative()
返回 Sort.Order 使用Sort.NullHandling.NATIVE 作为空处理提示。NATIVE：原生的
Sort.Order with(Sort.Direction direction)
创建Order实例.
Sort.Order with(Sort.NullHandling nullHandling)
创建Order实例.
Sort withProperties(String… properties)
创建Order实例.
Sort.Order withProperty(String property)
创建Order实例.

动态查询

Example example = Example.of(customer);

of 支持两个参数 示例对象实例 和 对象参数匹配器 ExampleMatcher

默认的参数匹配器会忽略 null，使用的动态参数应设置在对象实例中。

Customer customer = new Customer();

customer.setParm1(“xxxxx”);

Example example = Example.of(customer);