S09L02 - Spring Boot 中的分页与排序 - 本节总结

html

在Spring Boot中实现分页和排序：全面指南
目录

介绍 ………………………………………………………………... 1
理解分页和排序 …………………… 2

什么是分页？ ………………………………………………… 2
什么是排序？ ………………………………………………………… 3


在Spring Boot中设置分页 ………………… 4

配置请求参数 ………………………… 4
实现控制器逻辑 ………………… 6


将排序与分页集成 ………………………… 9

解析并应用排序参数 ……………… 9


生成分页链接 …………………………………… 12

创建动态链接 …………………………………………… 12
处理活动状态 ………………………………………… 14


使用Bootstrap增强视图 ………………………… 17

集成Bootstrap分页 …………………… 17


结论 …………………………………………………………………....... 20


介绍
在Web开发领域，高效管理大数据集对于提供无缝的用户体验至关重要。实现这一目标的两种基本技术是pagination和sorting。Pagination将大量数据列表分解为可管理的块，而sorting根据特定的标准组织数据，提升了可访问性和可用性。
本电子书深入探讨了在Spring Boot应用程序中实现pagination和sorting。我们将探讨配置请求参数、编写控制器逻辑、集成排序机制以及动态生成pagination链接。利用Bootstrap进行前端增强，确保pagination界面既实用又美观。
关键点

Pagination将数据分割成独立的页面，改善加载时间和用户导航。
Sorting根据指定字段排列数据，辅助数据检索和分析。
在Spring Boot中实现这些功能涉及配置请求参数、控制器方法和前端集成。
使用Bootstrap增强pagination链接的视觉展示。

优缺点


特性
优点
缺点


Pagination
- 改善性能
- 提升用户体验
- 增加了实现复杂性


Sorting
- 促进数据分析
- 提升数据可访问性
- 可能使查询逻辑复杂化


何时及在哪里使用

Pagination适用于展示大量数据集的应用程序，如博客、电子商务网站和管理仪表板。
Sorting在用户需要按日期、相关性、名称或其他相关字段组织数据时至关重要。


理解分页和排序
什么是分页？
Pagination是将内容分割成不同页面的过程，使用户更容易浏览大量数据。分页不是一次性加载所有记录，而是加载一个子集，通常每页固定数量，提升了性能和用户体验。
分页的好处

改善加载时间：减少一次性加载的数据量。
增强用户体验：防止用户被过多信息淹没。
高效的资源管理：优化服务器和客户端资源的使用。

什么是排序？h3>
Sorting涉及根据特定标准（如字母顺序、日期或相关性）组织数据。它允许用户以结构化和有意义的方式查看数据，便于更快地访问所需信息。
排序的好处

数据可访问性：更容易定位特定记录。
增强分析：有助于有效比较和分析数据。
用户便利性：提供数据查看和交互的灵活性。


在Spring Boot中设置分页
在Spring Boot应用程序中实现pagination涉及配置请求参数以接受分页输入，调整控制器以处理这些输入，并与数据库接口以获取适当的数据子集。
配置请求参数
为了启用pagination，我们需要在应用程序中接受诸如offset、perPage和page等参数。这些参数决定了要检索和显示的数据子集。




		
		
			
			
Java
			
			// 导入必要的包
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;

// 控制器方法
@GetMapping("/posts")
public String getPosts(
    @RequestParam(value = "soughtBy", required = false, defaultValue = "createdAt") String soughtBy,
    @RequestParam(value = "perPage", required = false, defaultValue = "5") int perPage,
    @RequestParam(value = "page", required = false, defaultValue = "1") int page,
    Model model) {
    
    // 控制器逻辑将在这里实现
}
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
				
						// 导入必要的包
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
 
// 控制器方法
@GetMapping("/posts")
public String getPosts(
    @RequestParam(value = "soughtBy", required = false, defaultValue = "createdAt") String soughtBy,
    @RequestParam(value = "perPage", required = false, defaultValue = "5") int perPage,
    @RequestParam(value = "page", required = false, defaultValue = "1") int page,
    Model model) {
    
    // 控制器逻辑将在这里实现
}
					
				
			
		


解释：

@RequestParam：将HTTP请求参数绑定到方法参数。
soughtBy：确定数据排序的字段。它是可选的，默认为createdAt。
perPage：指定每页的记录数。它是可选的，默认为5。
page：指示当前页码。它是可选的，默认为1。

实现控制器逻辑
控制器负责处理分页参数，与服务层交互以获取所需的数据子集，并为视图准备模型属性。




		
		
			
			
Java
			
			import org.springframework.data.domain.Page;
import org.springframework.data.domain.PageRequest;
import org.springframework.data.domain.Sort;

@GetMapping("/posts")
public String getPosts(
    @RequestParam(value = "soughtBy", required = false, defaultValue = "createdAt") String soughtBy,
    @RequestParam(value = "perPage", required = false, defaultValue = "5") int perPage,
    @RequestParam(value = "page", required = false, defaultValue = "1") int page,
    Model model) {
    
    // 调整页码为零基索引
    int currentPage = page - 1;
    
    // 创建 PageRequest 对象
    PageRequest pageRequest = PageRequest.of(currentPage, perPage, Sort.by(soughtBy).ascending());
    
    // 获取分页的帖子
    Page<Post> postPage = postService.findAll(pageRequest);
    
    // 总页数
    int totalPages = postPage.getTotalPages();
    
    // 生成页码列表
    List<Integer> pages = createPageRange(0, totalPages - 1);
    
    // 生成分页链接
    List<String> links = generatePaginationLinks(pages, perPage, soughtBy, currentPage);
    
    // 将属性添加到模型中
    model.addAttribute("links", links);
    model.addAttribute("postsOnPage", postPage.getContent());
    
    return "home";
}

// 辅助方法创建页码范围
private List<Integer> createPageRange(int start, int end) {
    List<Integer> range = new ArrayList<>();
    for (int i = start; i <= end; i++) {
        range.add(i);
    }
    return range;
}

// 辅助方法生成分页链接
private List<String> generatePaginationLinks(List<Integer> pages, int perPage, String sortBy, int currentPage) {
    List<String> links = new ArrayList<>();
    for (Integer link : pages) {
        String active = "";
        if (link == currentPage) {
            active = "active";
        }
        String url = "/posts?perPage=" + perPage + "&page=" + (link + 1) + "&soughtBy=" + sortBy;
        String htmlLink = "<li class='page-item " + active + "'><a class='page-link' href='" + url + "'>" + (link + 1) + "</a></li>";
        links.add(htmlLink);
    }
    return links;
}
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
				
						import org.springframework.data.domain.Page;
import org.springframework.data.domain.PageRequest;
import org.springframework.data.domain.Sort;
 
@GetMapping("/posts")
public String getPosts(
    @RequestParam(value = "soughtBy", required = false, defaultValue = "createdAt") String soughtBy,
    @RequestParam(value = "perPage", required = false, defaultValue = "5") int perPage,
    @RequestParam(value = "page", required = false, defaultValue = "1") int page,
    Model model) {
    
    // 调整页码为零基索引
    int currentPage = page - 1;
    
    // 创建 PageRequest 对象
    PageRequest pageRequest = PageRequest.of(currentPage, perPage, Sort.by(soughtBy).ascending());
    
    // 获取分页的帖子
    Page<Post> postPage = postService.findAll(pageRequest);
    
    // 总页数
    int totalPages = postPage.getTotalPages();
    
    // 生成页码列表
    List<Integer> pages = createPageRange(0, totalPages - 1);
    
    // 生成分页链接
    List<String> links = generatePaginationLinks(pages, perPage, soughtBy, currentPage);
    
    // 将属性添加到模型中
    model.addAttribute("links", links);
    model.addAttribute("postsOnPage", postPage.getContent());
    
    return "home";
}
 
// 辅助方法创建页码范围
private List<Integer> createPageRange(int start, int end) {
    List<Integer> range = new ArrayList<>();
    for (int i = start; i <= end; i++) {
        range.add(i);
    }
    return range;
}
 
// 辅助方法生成分页链接
private List<String> generatePaginationLinks(List<Integer> pages, int perPage, String sortBy, int currentPage) {
    List<String> links = new ArrayList<>();
    for (Integer link : pages) {
        String active = "";
        if (link == currentPage) {
            active = "active";
        }
        String url = "/posts?perPage=" + perPage + "&page=" + (link + 1) + "&soughtBy=" + sortBy;
        String htmlLink = "<li class='page-item " + active + "'><a class='page-link' href='" + url + "'>" + (link + 1) + "</a></li>";
        links.add(htmlLink);
    }
    return links;
}
					
				
			
		


解释：

PageRequest：构建分页信息，包括页码、大小和排序。
postService.findAll(pageRequest)：获取分页和排序后的帖子列表。
createPageRange：根据总页数生成页码列表。
generatePaginationLinks：为每个页面创建HTML链接，并将当前页面标记为活动状态。
模型属性：

links：包含分页链接的HTML片段。
postsOnPage：存储当前页面的帖子列表。



将排序与分页集成
将sorting与pagination结合，可以通过允许用户以首选顺序查看数据子集来增强数据检索。此集成涉及解析排序参数并在数据检索过程中应用它们。
解析并应用排序参数
为了实现排序，我们修改控制器以接受一个soughtBy参数，确定数据排序所依据的字段。




		
		
			
			
Java
			
			// 更新的控制器方法
@GetMapping("/posts")
public String getPosts(
    @RequestParam(value = "soughtBy", required = false, defaultValue = "createdAt") String soughtBy,
    @RequestParam(value = "perPage", required = false, defaultValue = "5") int perPage,
    @RequestParam(value = "page", required = false, defaultValue = "1") int page,
    Model model) {
    
    int currentPage = page - 1;
    
    // 基于 soughtBy 参数应用排序
    PageRequest pageRequest = PageRequest.of(currentPage, perPage, Sort.by(soughtBy).ascending());
    
    Page<Post> postPage = postService.findAll(pageRequest);
    
    int totalPages = postPage.getTotalPages();
    List<Integer> pages = createPageRange(0, totalPages - 1);
    List<String> links = generatePaginationLinks(pages, perPage, soughtBy, currentPage);
    
    model.addAttribute("links", links);
    model.addAttribute("postsOnPage", postPage.getContent());
    
    return "home";
}
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
				
						// 更新的控制器方法
@GetMapping("/posts")
public String getPosts(
    @RequestParam(value = "soughtBy", required = false, defaultValue = "createdAt") String soughtBy,
    @RequestParam(value = "perPage", required = false, defaultValue = "5") int perPage,
    @RequestParam(value = "page", required = false, defaultValue = "1") int page,
    Model model) {
    
    int currentPage = page - 1;
    
    // 基于 soughtBy 参数应用排序
    PageRequest pageRequest = PageRequest.of(currentPage, perPage, Sort.by(soughtBy).ascending());
    
    Page<Post> postPage = postService.findAll(pageRequest);
    
    int totalPages = postPage.getTotalPages();
    List<Integer> pages = createPageRange(0, totalPages - 1);
    List<String> links = generatePaginationLinks(pages, perPage, soughtBy, currentPage);
    
    model.addAttribute("links", links);
    model.addAttribute("postsOnPage", postPage.getContent());
    
    return "home";
}
					
				
			
		


解释：

soughtBy 参数：确定用于排序的字段（例如createdAt、title等）。
Sort.by(soughtBy).ascending()：基于指定字段应用升序排序。

处理可选参数
soughtBy参数是可选的。如果未提供，它将默认为createdAt，确保数据始终基于预定义字段进行排序。




		
		
			
			
Java
			
			@RequestParam(value = "soughtBy", required = false, defaultValue = "createdAt") String soughtBy
			
				
					
				
					1
				
						@RequestParam(value = "soughtBy", required = false, defaultValue = "createdAt") String soughtBy
					
				
			
		


解释：

required = false：使参数成为可选的。
defaultValue = "createdAt"：如果未提供soughtBy，则设置默认排序字段。


生成分页链接
动态生成pagination链接允许用户无缝导航不同页面。本节涵盖基于当前pagination状态创建这些链接。
创建动态链接
分页链接是基于总页数和当前页码生成的。每个链接将引导到相应的页面，并带有应用的排序和pagination参数。




		
		
			
			
Java
			
			private List<String> generatePaginationLinks(List<Integer> pages, int perPage, String sortBy, int currentPage) {
    List<String> links = new ArrayList<>();
    for (Integer link : pages) {
        String active = "";
        if (link == currentPage) {
            active = "active";
        }
        String url = "/posts?perPage=" + perPage + "&page=" + (link + 1) + "&soughtBy=" + sortBy;
        String htmlLink = "<li class='page-item " + active + "'><a class='page-link' href='" + url + "'>" + (link + 1) + "</a></li>";
        links.add(htmlLink);
    }
    return links;
}
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
				
						private List<String> generatePaginationLinks(List<Integer> pages, int perPage, String sortBy, int currentPage) {
    List<String> links = new ArrayList<>();
    for (Integer link : pages) {
        String active = "";
        if (link == currentPage) {
            active = "active";
        }
        String url = "/posts?perPage=" + perPage + "&page=" + (link + 1) + "&soughtBy=" + sortBy;
        String htmlLink = "<li class='page-item " + active + "'><a class='page-link' href='" + url + "'>" + (link + 1) + "</a></li>";
        links.add(htmlLink);
    }
    return links;
}
					
				
			
		


解释：

遍历页码：迭代每个页码。
活动类：为当前页链接添加active类，以进行视觉区分。
URL构建：使用perPage、page和soughtBy的查询参数构建URL。
HTML链接：为每个分页链接创建一个HTML片段。

处理活动状态
突出显示活动页码增强了用户导航，表明当前页面的上下文。




		
		
			
			
Java
			
			if (link == currentPage) {
    active = "active";
}
			
				
					
				
					1
2
3
				
						if (link == currentPage) {
    active = "active";
}
					
				
			
		


解释：

条件：检查循环中的当前链接是否对应活动页面。
活动类：为当前页链接分配active类，以不同方式进行样式处理。


使用Bootstrap增强视图
将Bootstrap集成到前端，确保pagination界面具有响应性和视觉吸引力。本节概述了将Bootstrap的pagination组件集成到视图中的方法。
集成Bootstrap分页
Bootstrap提供了预定义的类，可以有效地用于样式化pagination链接。




		
		
			
			
Java
			
			<!-- home.html中的分页部分 -->
<nav aria-label="Page navigation example">
  <ul class="pagination">
    <th:block th:if="${links != null}">
      <th:block th:each="link : ${links}">
        <th:block th:utext="${link}"></th:block>
      </th:block>
    </th:block>
  </ul>
</nav>
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
				
						<!-- home.html中的分页部分 -->
<nav aria-label="Page navigation example">
  <ul class="pagination">
    <th:block th:if="${links != null}">
      <th:block th:each="link : ${links}">
        <th:block th:utext="${link}"></th:block>
      </th:block>
    </th:block>
  </ul>
</nav>
					
				
			
		


解释：

导航元素（<nav>）：定义分页区域的语义结构。
无序列表（<ul>）：使用Bootstrap的pagination类进行样式化。
Spring Thymeleaf 集成：

th:if：检查是否存在pagination链接。
th:each：迭代links模型属性中的每个链接。
th:utext：插入未转义的HTML以保留HTML结构。


样式化活动链接
使用Bootstrap的类，活动分页链接会被视觉区分，以指示当前页。




		
		
			
			
Java
			
			&lt;li class="page-item active"&gt;
  &lt;a class="page-link" href="#"&gt;1&lt;/a&gt;
&lt;/li&gt;
			
				
					
				
					1
2
3
				
						&lt;li class="page-item active"&gt;
  &lt;a class="page-link" href="#"&gt;1&lt;/a&gt;
&lt;/li&gt;
					
				
			
		


解释：

page-item active：将Bootstrap的分页项类与active类结合使用，以进行高亮显示。
page-link：根据Bootstrap的分页链接样式对链接进行样式化。


结论
在Spring Boot应用程序中实现pagination和sorting显著提升了数据管理和用户体验。通过配置请求参数、调整控制器逻辑以及集成Bootstrap进行前端展示，开发人员可以高效地处理大量数据集，并为用户提供直观的导航体验。
主要收获

Pagination通过将内容分割成可管理的页面，优化了数据加载并提升了性能。
Sorting根据指定标准组织数据，辅助了数据的可访问性和分析。
Spring Boot的PageRequest和Sort类便于无缝集成pagination和sorting。
结合Bootstrap的样式，动态生成的pagination链接实现了响应性和用户友好的界面。

未来的增强

动态排序：允许用户在升序和降序之间切换。
过滤集成：将pagination和sorting与数据过滤结合，实现更细致的数据检索。
异步加载：通过AJAX实现更流畅的导航，无需整个页面重新加载。


SEO 优化关键词：Spring Boot pagination, Spring Boot sorting, pagination in Spring Boot, sorting in Spring Boot, Spring Boot PageRequest, Spring Boot Sort, Bootstrap pagination, Java Spring Boot 教程, implementing pagination Spring Boot, data sorting Spring Boot, enhancing user experience Spring Boot, Spring Boot controller pagination, dynamic pagination links Spring Boot
特性	优点	缺点
Pagination	- 改善性能 - 提升用户体验	- 增加了实现复杂性
Sorting	- 促进数据分析 - 提升数据可访问性	- 可能使查询逻辑复杂化
在Spring Boot中实现分页和排序：全面指南

目录

介绍

关键点

优缺点

何时及在哪里使用

理解分页和排序

什么是分页？

分页的好处

什么是排序？h3> Sorting涉及根据特定标准（如字母顺序、日期或相关性）组织数据。它允许用户以结构化和有意义的方式查看数据，便于更快地访问所需信息。

排序的好处

在Spring Boot中设置分页

配置请求参数

实现控制器逻辑

将排序与分页集成

解析并应用排序参数

处理可选参数

生成分页链接

创建动态链接

处理活动状态

使用Bootstrap增强视图

集成Bootstrap分页

样式化活动链接

结论

主要收获

未来的增强

什么是排序？h3>

Sorting涉及根据特定标准（如字母顺序、日期或相关性）组织数据。它允许用户以结构化和有意义的方式查看数据，便于更快地访问所需信息。
