转载

Spring中的REST分页

本文将介绍在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中添加以下依赖项

  1. Spring Boot JPA
  2. Spring Boot Data REST
  3. 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>

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

  1. 我们使用  Pageable作为控制器的参数之一。这将有助于返回页面而不是列表。
  2. Pageable具有所有必需的分页信息。
  3. 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项目中 找到 

原文  https://www.jdon.com/51623
正文到此结束
Loading...