Spring中的REST分页

栏目: Java · 发布时间: 6年前

内容简介：本文将介绍在REST API中实现分页的基础知识。我们将专注于使用Spring Boot和Spring Data 在Spring MVC中构建REST分页。分页是一种处理大结果数据集的机制。在REST API中实现分页并没有什么不同，但需要一些额外的思考过程。为REST API提供流畅有效的分页可以增加用户体验并有助于构建高效，快速的REST API。我们使用Spring Boot作为示例。

本文将介绍在REST API中实现分页的基础知识。我们将专注于使用Spring Boot和Spring Data 在Spring MVC中构建REST分页。

分页是一种处理大结果数据集的机制。在REST API中实现分页并没有什么不同，但需要一些额外的思考过程。为REST API提供流畅有效的分页可以增加用户体验并有助于构建高效，快速的REST API。我们使用Spring Boot作为示例。

1.资源与表示

在我们开始设计分页API之前，我们需要清楚地了解页面作为资源或资源的表示。我们需要记住许多基本要素

一个页面Page不是REST中的一个资源，而是其请求的属性。

以资源名称Product为构建分页的例子，在高层次上我们确实有以下三个选项来构建分页。

将产品Product作为资源并使用查询字符串来处理分页以及其他参数，例如排序等（例如http://domainname/products?page=1）。
第二个选项是将页面Page用作资源和查询字符串进行排序。（例如http://domainname/products/page/1?sort_by=date）。
使用页面Page作为资源和URL部分进行排序。（例如http://domainname/products/date/page/1）

考虑到上述问题，让我们尝试回答一些在设计REST API分页时有用的问题。

您是否将页面Page视为页面中产品的资源?

请记住，REST API不是围绕任何预定义的规则或规范构建的，所有上述三个选项都是有效的，并且基于上述问题的答案。如果我们将页面视为资源，则选项3是有效选择；但如果我们说页面上的产品是资源，那么选项3不再有效（在第1,2页上的产品可能会在将来更改），就个人而言，我会选择选项1，因为对我来说，页面 Page 不是资源Resouce，它是请求的属性。

2.可发现性

可发现性有助于使 RESTful API 更加实用和优雅。使REST API 可被发现经常被忽视。以下是REST API可发现性的高级摘要。

有了这个功能，REST API在对客户端的响应中提供完整的URI意味着没有客户端需要“组合”URI。
客户端API独立于URI结构。
通过以上2点，API更加灵活，允许开发人员在不破坏API的情况下更改URI架构。（请记住，API提供所有URI，它们不是由客户端API动态创建的）。

可发现性与REST API中的HATEOAS密切相关。REST API分页可发现将通过"next"，"previous"，"first"和"last"链路作为响应数据的一部分。我们正在考虑如何在分页期间将此功能添加到您的API。

3.分页设计考虑因素

在构建REST API分页界面时，让我们快速介绍一些要点。

3.1 限制limit

限制允许API和客户端控制结果集中请求的结果数。通过传递 limit 参数，您可以指定每个页面要返回的项目数.API可以配置默认限制，但应允许客户端指定限制。

http://hostname/products?page=1&limit=50

在上面的请求中，客户端将限制设置为50.小心，同时允许客户将limit 参数设置，设置为极高数量的限制会降低API性能。建议在API设计期间具有最大允许限制。

3.1 排序

排序总是与搜索和分页并排。在设计REST API时，提供灵活性，让客户指定排序选项，同时从API返回结果。建议在设计API时使用 sort_by = [attribute name] - [asc / desc]模式.API设计器应将允许的属性名称指定为sort参数。例如，您可以使用?name-asc按产品名称排序或?name-desc反向排序。

4. Maven依赖

我们在Spring中处理REST分页时介绍了所有基本内容。我们在这篇文章中使用了以下技术堆栈，但它可以在任何其他技术上实现，前提是您在设计时遵循所有基本原则。

Spring Boot
JPA.
Spring Data REST

在本文中使用 Spring Data REST 的原因之一是Data REST API支持的开箱即用功能。

我们将在pom.xml中添加以下依赖项

Spring Boot JPA
Spring Boot Data REST
HATEOS和Web

<dependencies>
   <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-jpa</artifactId>
   </dependency>
   <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-<b>rest</b></artifactId>
   </dependency>
   <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-hateoas</artifactId>
   </dependency>
   <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
   </dependency>
   <dependency>
      <groupId>org.hsqldb</groupId>
      <artifactId>hsqldb</artifactId>
      <scope>runtime</scope>
   </dependency>
</dependencies>

4.1 REST控制器:

@RestController
<b>public</b> <b>class</b> ProductRESTController {

 @Autowired
 <b>private</b> ProductService productService;

 @Autowired <b>private</b> EntityLinks links;

 @GetMapping(value = <font>"/products"</font><font>, produces = MediaType.APPLICATION_JSON_VALUE)
 <b>public</b> ResponseEntity < PagedResources < ProductEntity >> AllProducts(Pageable pageable, PagedResourcesAssembler assembler) {
  Page < ProductEntity > products = productService.findAllProducts(pageable);
  PagedResources < ProductEntity > pr = assembler.toResource(products, linkTo(ProductRESTController.<b>class</b>).slash(</font><font>"/products"</font><font>).withSelfRel());
  HttpHeaders responseHeaders = <b>new</b> HttpHeaders();
  responseHeaders.add(</font><font>"Link"</font><font>, createLinkHeader(pr));
  <b>return</b> <b>new</b> ResponseEntity < > (assembler.toResource(products, linkTo(ProductRESTController.<b>class</b>).slash(</font><font>"/products"</font><font>).withSelfRel()), responseHeaders, HttpStatus.OK);
 }

 <b>private</b> String createLinkHeader(PagedResources < ProductEntity > pr) {
  <b>final</b> StringBuilder linkHeader = <b>new</b> StringBuilder();
  linkHeader.append(buildLinkHeader(pr.getLinks(</font><font>"first"</font><font>).get(0).getHref(), </font><font>"first"</font><font>));
  linkHeader.append(</font><font>", "</font><font>);
  linkHeader.append(buildLinkHeader(pr.getLinks(</font><font>"next"</font><font>).get(0).getHref(), </font><font>"next"</font><font>));
  <b>return</b> linkHeader.toString();
 }

 <b>public</b> <b>static</b> String buildLinkHeader(<b>final</b> String uri, <b>final</b> String rel) {
  <b>return</b> </font><font>"<"</font><font> + uri + </font><font>">; rel=\""</font><font> + rel + </font><font>"\""</font><font>;
 }
}
</font>

让我们快速介绍上面代码中的几个要点。

我们使用 Pageable作为控制器的参数之一。这将有助于返回页面而不是列表。
Pageable具有所有必需的分页信息。
Pageable在Spring JPA中运行得非常好，并且透明地处理分页。

4.2 Previous 和Next 链接

每个页面响应将返回链接到当前页面前面和后面的页，这是基于使用IANA定义链接关系 prev 和 next 。但是，如果您当前位于结果的第一页，则不会呈现任何 prev链接。

我们来看下面的例子：

curl http://localhost:8080/products

{
    <font>"_embedded"</font><font>: {
        </font><font>"productEntities"</font><font>: [
            ...data...
        ]
    },
    </font><font>"_links"</font><font>: {
        </font><font>"first"</font><font>: {
            </font><font>"href"</font><font>: </font><font>"http://localhost:8080/products?page=0&size=20"</font><font>
        },
        </font><font>"self"</font><font>: {
            </font><font>"href"</font><font>: </font><font>"http://localhost:8080/products"</font><font>
        },
        </font><font>"next"</font><font>: {
            </font><font>"href"</font><font>: </font><font>"http://localhost:8080/products?page=1&size=20"</font><font>
        },
        </font><font>"last"</font><font>: {
            </font><font>"href"</font><font>: </font><font>"http://localhost:8080/products?page=4&size=20"</font><font>
        }
    },
    </font><font>"page"</font><font>: {
        </font><font>"size"</font><font>: 20,
        </font><font>"totalElements"</font><font>: 100,
        </font><font>"totalPages"</font><font>: 5,
        </font><font>"number"</font><font>: 0
    }
}
</font>

让我们深入了解响应数据中的一些有趣事实

next 链接指向下一页。last 链接指向的最后一个结果集。
self 链接提供整个系列。
底部 page 提供有关分页的信息，包括页面大小，总结果，总页数和当前页码。

4.2使用链接头

HTTP标头是REST API的关键方面.HTTP链接标头还可用于将分页信息传递给客户端。通过上述测试，系统将返回以下附加信息作为Link HTTP标头的一部分。

Link →<http:<font><i>//localhost:8080/products?page=0&size=20>; rel="first", <http://localhost:8080/products?page=1&size=20>; rel="next"</i></font><font>
</font>

rel="next" 意思是下一页是 page=2；rel="first" 意思是第一页总是依赖page=2.于提供给你的这些链接关系。不要试图猜测或构建自己的URL。Spring PagedResource提供所有这些信息作为结果的一部分，我们只需要确保从这些信息中构建正确的HTTP头。在我们的控制器示例中，我们在createLinkHeader方法中构建标头。

<b>private</b> String createLinkHeader(PagedResources < ProductEntity > pr) {
 <b>final</b> StringBuilder linkHeader = <b>new</b> StringBuilder();
 linkHeader.append(buildLinkHeader(pr.getLinks(<font>"first"</font><font>).get(0).getHref(), </font><font>"first"</font><font>));
 linkHeader.append(</font><font>", "</font><font>);
 linkHeader.append(buildLinkHeader(pr.getLinks(</font><font>"next"</font><font>).get(0).getHref(), </font><font>"next"</font><font>));
 <b>return</b> linkHeader.toString();
}

<b>public</b> <b>static</b> String buildLinkHeader(<b>final</b> String uri, <b>final</b> String rel) {
 <b>return</b> </font><font>"<"</font><font> + uri + </font><font>">; rel=\""</font><font> + rel + </font><font>"\""</font><font>;
}
</font>

总结

在这篇文章中，我们学习了如何在Spring和Spring Boot中实现 REST分页。我们讨论了如何构建响应以及在REST API响应中使用链接HTTP标头的重要性。

所有这些示例和代码片段的实现都可以在 GitHub项目中找到

以上就是本文的全部内容，希望本文的内容对大家的学习或者工作能带来一定的帮助，也希望大家多多支持码农网

查看所有标签

猜你喜欢:

Spring中的REST分页

本站部分资源来源于网络，本站转载出于传递更多信息之目的，版权归原作者或者来源机构所有，如转载稿涉及版权问题，请联系我们。

码农书籍

Beginning XML with DOM and Ajax

Sas Jacobs / Apress / 2006-06-05 / USD 39.99

Don't waste time on 1,000-page tomes full of syntax; this book is all you need to get ahead in XML development. Renowned web developer Sas Jacobs presents an essential guide to XML. Beginning XML with......一起来看看《Beginning XML with DOM and Ajax》这本书的介绍吧!

码农工具

Spring中的REST分页

Beginning XML with DOM and Ajax

随机密码生成器

Base64 编码/解码

URL 编码/解码