两行代码玩转Spring Data排序和分页

一：唠嗑

在实际项目中对Spring Data的各类使用至关多，简单的增删改查Spring Data提供了现成的方法，一些复杂的，咱们能够在接口方法写And,Not等关键字来搞定，想写原生SQL，CQL（Neo4j），Query DSL （Elasticsearch）的，直接使用@Query(“......”)注解搞定，真的是方便到不行！

本篇博客不打算讲Spring Data如何使用，不一样的模块（JPA，Neo4j....）使用也略不相同，但Spring Data的排序Sort和分页Pageable接口都是差很少的，因此带你们搞明白搞明白Spring Data的排序和分页是如何使用的。

二：介绍

Spring Data的任务是为数据访问提供一个熟悉的、一致的、基于Spring的编程模型，同时仍然保留底层数据存储的特殊特性。

Spring Data 项目的目的是为了简化构建基于 Spring 框架应用的数据访问计数，包括非关系数据库、Map-Reduce 框架、云数据服务等等；另外也包含对关系数据库的访问支持。

SpringData让数据访问变得更加方便。

三：模块

Spring Data

• Spring Data for Apache Cassandra
• Spring Data Commons
• Spring Data Couchbase
• Spring Data Elasticsearch
• Spring Data Envers
• Spring Data for Pivotal GemFire
• Spring Data Graph
• Spring Data JDBC
• Spring Data JDBC Extensions
• Spring Data JPA
• Spring Data LDAP
• Spring Data MongoDB
• Spring Data Neo4J
• Spring Data Redis
• Spring Data REST
• Spring Data for Apache Solr
• Spring for Apache Hadoop

四：排序

经过一行代码就能够快速使用：

Sort sort = new Sort(Sort.Direction.DESC, "id");

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

你也能够建立一个多属性的Sort实例。

Sort(Sort.Direction direction, List<String> 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实例.

若是你还想全面了解它的使用，推荐阅读官方英文文档：https://docs.spring.io/spring-data/data-commons/docs/current/api/org/springframework/data/domain/Sort.html

五：分页

Pageable只是 Spring Data 提供的分页信息的抽象接口。

实现类：

AbstractPageRequest：抽象类。供PageRequest和QPageRequest继承。

PageRequest： 基本的可页面化Java Bean实现。

QPageRequest：基本的Java Bean实现，能够支持QueryDSL。

分页功能也只须要一行代码：

Pageable pageable = new PageRequest(int page, int size, Sort sort);

page - 从零开始的索引页

size- 要返回的页面的大小

sort - 排序

你也能够建立没有排序的分页

PageRequest(int page, int size)

更方便的是能够一行代码建立有排序方向和属性的分页

PageRequest(int page, int size, Sort.Direction direction, String... properties)

若是你使用的是2.0之后的版本，官方已经弃用以上构造方法的形式，推荐使用静态方法：

修饰符和类型	方法和描述
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将会把数据的总体信息、当前数据的信息，分页的信息都放入到返回值中。这样，咱们就可以方便的进行个性化的分页查询。

public interface UserRepository extends JpaRepository<User,Long> {

    @Override
    Page<Medical> findAll(Pageable pageable);
}

若是你想用@Query写原生查询语句并实现分页：

Spring Data JPA目前不支持原生查询的动态排序，由于它必须操做声明的实际查询，这对于原生SQL是没法可靠地作到的。可是，您能够经过本身指定count查询来使用原生查询进行分页，以下面的示例所示:

public interface UserRepository extends JpaRepository<User, Long> {

  @Query(value = "SELECT * FROM USERS WHERE LASTNAME = ?1",
    countQuery = "SELECT count(*) FROM USERS WHERE LASTNAME = ?1",
    nativeQuery = true)
  Page<User> findByLastname(String lastname, Pageable pageable);
}

七：读取

分页查询：

Page<Book> sampleEntities = userRepository.findAll(pageable);

接口Page继承了接口Slice，话很少说，直接上干货！

总页数

int getTotalPages()

元素的总数

long getTotalElements()

返回当前页的索引（是第几页）

int getNumber()

返回做为List的页面内容

List<T> 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()

---

关于Spring Data的排序与分页就到这里，记得点赞哦~~~

本文已受权微信公众号“后端技术精选”独家发布