Spring中的REST分页的实现代码

2023-08-29 10:45:04 63

本文将介绍在RESTAPI中实现分页的基础知识。我们将专注于使用SpringBoot和SpringData在SpringMVC中构建REST分页。

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

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）

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

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

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

2.可发现性

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

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

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

3.分页设计考虑因素

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

3.1限制limit

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

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

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

3.2排序

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

4.Maven依赖

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

SpringBoot
JPA.
SpringDataREST

在本文中使用SpringDataREST的原因之一是DataRESTAPI支持的开箱即用功能。

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

SpringBootJPA
SpringBootDataREST
HATEOS和Web



org.springframework.boot
spring-boot-starter-data-jpa


org.springframework.boot
spring-boot-starter-data-rest


org.springframework.boot
spring-boot-starter-hateoas


org.springframework.boot
spring-boot-starter-web


org.hsqldb
hsqldb
runtime

4.1REST控制器:

@RestController
publicclassProductRESTController{

@Autowired
privateProductServiceproductService;

@AutowiredprivateEntityLinkslinks;

@GetMapping(value="/products",produces=MediaType.APPLICATION_JSON_VALUE)
publicResponseEntity>AllProducts(Pageablepageable,PagedResourcesAssemblerassembler){
Pageproducts=productService.findAllProducts(pageable);
PagedResourcespr=assembler.toResource(products,linkTo(ProductRESTController.class).slash("/products").withSelfRel());
HttpHeadersresponseHeaders=newHttpHeaders();
responseHeaders.add("Link",createLinkHeader(pr));
returnnewResponseEntity<>(assembler.toResource(products,linkTo(ProductRESTController.class).slash("/products").withSelfRel()),responseHeaders,HttpStatus.OK);
}

privateStringcreateLinkHeader(PagedResourcespr){
finalStringBuilderlinkHeader=newStringBuilder();
linkHeader.append(buildLinkHeader(pr.getLinks("first").get(0).getHref(),"first"));
linkHeader.append(",");
linkHeader.append(buildLinkHeader(pr.getLinks("next").get(0).getHref(),"next"));
returnlinkHeader.toString();
}

publicstaticStringbuildLinkHeader(finalStringuri,finalStringrel){
return"<"+uri+">;rel=\""+rel+"\"";
}
}

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

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

4.2Previous和Next链接

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

我们来看下面的例子：

curlhttp://localhost:8080/products

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

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

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

4.2使用链接头

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

Link→;rel="first",;rel="next"

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

privateStringcreateLinkHeader(PagedResourcespr){
finalStringBuilderlinkHeader=newStringBuilder();
linkHeader.append(buildLinkHeader(pr.getLinks("first").get(0).getHref(),"first"));
linkHeader.append(",");
linkHeader.append(buildLinkHeader(pr.getLinks("next").get(0).getHref(),"next"));
returnlinkHeader.toString();
}

publicstaticStringbuildLinkHeader(finalStringuri,finalStringrel){
return"<"+uri+">;rel=\""+rel+"\"";
}

总结

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

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

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持毛票票。

Spring中的REST分页的实现代码

热门推荐

随机推荐