Java 分页：让你的数据列表优雅展示

最新推荐文章于 2026-02-18 04:04:01 发布

原创最新推荐文章于 2026-02-18 04:04:01 发布 · 1.1k 阅读

20 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#java #开发语言

在 Web 应用中，数据列表是常见的展示方式。当数据量较大时，如果一次性加载所有数据，不仅会影响页面加载速度，还会给服务器带来巨大的压力。这时，分页就显得尤为重要。分页可以将大量数据分割成多个小页面，用户可以按需浏览，从而提高用户体验和系统性能。

什么是分页？

分页是一种将大量数据分割成多个页面的技术。它允许用户按需浏览数据，而不是一次性加载所有数据。分页通常包括以下几个要素：

当前页码 (currentPage): 用户当前正在浏览的页面。
每页显示条数 (pageSize): 每个页面显示的数据条数。
总记录数 (totalCount): 数据总共有多少条记录。
总页数 (totalPage): 数据总共可以分成多少页。

通过这几个要素，我们可以计算出当前页需要显示的数据范围，并提供分页导航功能，方便用户切换页面。

Java 中实现分页的方式

在 Java 中，实现分页的方式有很多种，常见的包括：

数据库分页： 在 SQL 查询语句中使用 LIMIT (MySQL, PostgreSQL) 或 ROWNUM (Oracle) 等关键字进行分页。
内存分页： 将所有数据加载到内存中，然后根据分页参数进行截取。
第三方分页组件： 使用现有的分页组件，例如，MyBatis-Plus 的 Page 对象、Spring Data JPA 的 Pageable 接口等。

数据库分页 是最常用和推荐的方式，因为它将分页计算和数据检索的压力转移到了数据库，避免了内存占用过高的问题。

数据库分页的实现

下面以 MySQL 为例，介绍如何使用 LIMIT 关键字进行数据库分页：

public class PageHelper {

    /**
     *  构建分页 SQL
     * @param sql 查询 SQL
     * @param currentPage 当前页码
     * @param pageSize 每页显示条数
     * @return 分页 SQL
     */
    public static String buildPageSql(String sql, int currentPage, int pageSize) {
        int offset = (currentPage - 1) * pageSize;
        return sql + " LIMIT " + offset + ", " + pageSize;
    }
}

在 Java 代码中，我们可以使用 PageHelper 类来构建分页 SQL：

import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.util.ArrayList;
import java.util.List;

public class UserDAO {

    private final Connection connection;
    public UserDAO(Connection connection){
        this.connection=connection;
    }

    public List<User> getUserList(int currentPage, int pageSize) throws SQLException {
        String sql = "SELECT * FROM user";
        String pageSql = PageHelper.buildPageSql(sql, currentPage, pageSize);
        PreparedStatement statement = connection.prepareStatement(pageSql);
        ResultSet resultSet = statement.executeQuery();
        List<User> userList = new ArrayList<>();
        while (resultSet.next()) {
            User user = new User();
            user.setId(resultSet.getInt("id"));
            user.setName(resultSet.getString("name"));
            userList.add(user);
        }
        return userList;
    }

    public int getTotalCount() throws SQLException {
        String sql = "SELECT COUNT(*) FROM user";
        PreparedStatement statement = connection.prepareStatement(sql);
        ResultSet resultSet = statement.executeQuery();
        int totalCount = 0;
        if (resultSet.next()) {
            totalCount = resultSet.getInt(1);
        }
        return totalCount;
    }
}

说明：

buildPageSql 方法用于构建分页 SQL，它根据当前页码和每页显示条数计算出 LIMIT 子句的参数。
getUserList 方法执行分页查询，返回当前页的用户列表。
getTotalCount 方法查询总记录数。

使用第三方分页组件

除了手动构建分页 SQL，我们还可以使用第三方分页组件，例如，MyBatis-Plus 的 Page 对象：

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class UserService {

    private final UserMapper userMapper;

    public UserService(UserMapper userMapper) {
        this.userMapper = userMapper;
    }

    public IPage<User> getUserPage(int currentPage, int pageSize) {
        IPage<User> page = new Page<>(currentPage, pageSize);
        return userMapper.selectPage(page, null);
    }
}

说明：