Java 中怎么用 JDBC 实现分页通用工具类

落雪酱_4432

落雪酱_4432

2026-11-06

142人浏览

原创

Java中JDBC分页通用工具类核心是解耦SQL与分页逻辑,通过拦截SELECT语句、按数据库类型(MySQL/Oracle/PostgreSQL)自动包裹分页语法,并保持原参数顺序,返回新SQL与扩展参数列表,支持安全校验与总记录数查询。

java 中怎么用 jdbc 实现分页通用工具类

Java 中用 JDBC 实现分页通用工具类,核心在于**解耦 SQL 与分页逻辑**,避免每查一次都手动拼 LIMIT ?, ? 或 ROWNUM,同时适配不同数据库(如 MySQL、Oracle、PostgreSQL)的分页语法差异。

一、设计思路:SQL 拦截 + 参数注入

不修改原始 SQL 字符串,而是提取查询主体(SELECT ... FROM ... WHERE ...),再包裹为带分页的子查询或直接追加 LIMIT/OFFSET。关键点:

  • 只处理 SELECT 语句,忽略 INSERT/UPDATE/DELETE
  • 保留原有参数占位符(?)顺序,分页参数(offset、limit)追加在末尾
  • 区分数据库类型,由 DatabaseType 枚举统一管理方言

二、核心工具类结构(精简版)

以下是一个轻量、可直接复用的 PaginationUtils 类:

public class PaginationUtils {
    public enum DatabaseType {
        MYSQL, ORACLE, POSTGRESQL
    }
<pre class="brush:java;toolbar:false;">public static class PaginationResult {
    public final String sql;
    public final List<object> params;

    public PaginationResult(String sql, List<object> params) {
        this.sql = sql;
        this.params = params;
    }
}

public static PaginationResult buildPagedSql(String originalSql, int offset, int limit, DatabaseType dbType) {
    String trimmed = originalSql.trim().toUpperCase();
    if (!trimmed.startsWith("SELECT")) {
        throw new IllegalArgumentException("Only SELECT statements supported");
    }

    List<object> newParams = new ArrayList(Arrays.asList(/* 原参数占位符对应值 */));
    String pagedSql;

    switch (dbType) {
        case MYSQL:
            pagedSql = originalSql + " LIMIT ?, ?";
            newParams.add(offset);
            newParams.add(limit);
            break;
        case POSTGRESQL:
            pagedSql = originalSql + " LIMIT ? OFFSET ?";
            newParams.add(limit);
            newParams.add(offset);
            break;
        case ORACLE:
            // 简化版:使用 ROW_NUMBER() 包裹(支持 Oracle 12c+ 可用 FETCH NEXT)
            String wrapped = "SELECT * FROM (SELECT t.*, ROW_NUMBER() OVER (ORDER BY 1) rn FROM (" 
                           + originalSql + ") t) WHERE rn BETWEEN ? AND ?";
            pagedSql = wrapped;
            newParams.add(offset + 1);
            newParams.add(offset + limit);
            break;
        default:
            throw new UnsupportedOperationException("Unsupported database: " + dbType);
    }
    return new PaginationResult(pagedSql, newParams);
}</object></object></object>

}

三、配合 JDBC 使用示例

调用时无需改 DAO 层原有逻辑,只需在执行前包装 SQL 和参数:

Java调试
Java调试

通过 JDWP 实现 Java 远程调试:连接远程 JVM、设置断点、单步执行代码、查看变量值、获取调用栈。适用于需要调试远程 Java 应用、排查运行时状态、追踪代码执行流程的场景。 术语注解 JDWP:Java Debug Wire Protocol,Java 调试有线协议(Java 远程调试底层通信协议) remote JVM:远程 Java 虚拟机 step through code:代码单步调试(步入 / 步过 / 步出调试) inspect variables:变量查看 / 变量检视 stac

下载

String sql = "SELECT id, name FROM user WHERE status = ? AND age > ?";
List<object> params = Arrays.asList(1, 18);
<p>PaginationUtils.PaginationResult result =
PaginationUtils.buildPagedSql(sql, 20, 10, PaginationUtils.DatabaseType.MYSQL);</p>
<p>// 执行 JDBC 查询
try (PreparedStatement ps = conn.prepareStatement(result.sql)) {
for (int i = 0; i </p></object>

四、进阶建议

生产环境可进一步增强:

  • 自动识别 ORDER BY:Oracle 分页必须有明确排序,若原 SQL 无 ORDER BY,可默认补 ORDER BY 1(需谨慎)
  • 总记录数查询支持:提供 countSqlFor(originalSql) 方法,将 SELECT xxx 替换为 SELECT COUNT(*),并剥离 LIMIT/OFFSET
  • Spring 集成:封装为 @Around 切面,通过注解(如 @Pageable)自动织入分页逻辑
  • 防 SQL 注入提醒:检查原始 SQL 是否含非法字符(如 ;、--),日志告警而非抛异常(避免误杀)

不复杂但容易忽略的是:分页参数必须校验非负,且 limit 应设上限(如 ≤ 100),防止恶意拉取全表。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

12017

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

9102

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7792

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1264

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

1028

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1516

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3149

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20391

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1375

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习