当前位置： 首页 > news >正文

完整 Oracle 12c 分页 Demo（Spring Boot+MyBatis+PageHelper）

news 2026/3/27 6:46:21

一、核心代码实现

1. pom.xml（依赖配置）

<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.7.18</version> <!-- 稳定版，适配PageHelper --> <relativePath/> </parent> <groupId>com.example</groupId> <artifactId>oracle-page-demo</artifactId> <version>1.0.0</version> <dependencies> <!-- Spring Boot核心 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <!-- MyBatis --> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>2.3.0</version> </dependency> <!-- PageHelper --> <dependency> <groupId>com.github.pagehelper</groupId> <artifactId>pagehelper-spring-boot-starter</artifactId> <version>1.4.7</version> </dependency> <!-- Oracle驱动 --> <dependency> <groupId>com.oracle.database.jdbc</groupId> <artifactId>ojdbc8</artifactId> <version>21.9.0.0</version> </dependency> <!-- SQL解析 --> <dependency> <groupId>com.github.jsqlparser</groupId> <artifactId>jsqlparser</artifactId> <version>4.6</version> </dependency> <!-- 测试 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project>

2. application.properties（配置文件）

# 服务器端口 server.port=8080 # Oracle数据库配置 spring.datasource.driver-class-name=oracle.jdbc.driver.OracleDriver spring.datasource.url=jdbc:oracle:thin:@localhost:1521:ORCL # 替换为你的Oracle地址 spring.datasource.username=your_username # 替换为你的用户名 spring.datasource.password=your_password # 替换为你的密码 # MyBatis配置 mybatis.mapper-locations=classpath:mybatis/mapper/*.xml mybatis.type-aliases-package=com.example.oraclepage.entity mybatis.configuration.map-underscore-to-camel-case=true # 下划线转驼峰 # PageHelper配置 pagehelper.helper-dialect=oracle12c # 指定自定义的Oracle 12c方言 pagehelper.reasonable=true # 分页合理化（页码越界自动修正） pagehelper.support-methods-arguments=true # 支持Mapper参数传分页参数 pagehelper.params=count=countSql

3. Oracle12cDialect.java（自定义方言）

package com.example.oraclepage.config; import com.github.pagehelper.Page; import com.github.pagehelper.dialect.AbstractHelperDialect; import com.github.pagehelper.page.PageAutoDialect; import org.apache.ibatis.cache.CacheKey; import org.apache.ibatis.mapping.BoundSql; import org.apache.ibatis.mapping.MappedStatement; import org.springframework.stereotype.Component; import java.util.Map; /** * 自定义Oracle 12c分页方言（适配OFFSET ... FETCH语法） */ @Component public class Oracle12cDialect extends AbstractHelperDialect { // 注册方言别名，与配置文件中的pagehelper.helper-dialect对应 static { PageAutoDialect.registerDialectAlias("oracle12c", Oracle12cDialect.class); } /** * 生成Oracle 12c分页SQL（核心方法） * @param sql 原始查询SQL * @param page 分页对象 * @param pageKey 缓存Key * @return 拼接后的分页SQL */ @Override public String getPageSql(String sql, Page page, CacheKey pageKey) { StringBuilder sqlBuilder = new StringBuilder(sql.length() + 60); sqlBuilder.append(sql); // Oracle 12c分页语法：OFFSET 跳过行数 ROWS FETCH NEXT 取行数 ROWS ONLY int offset = page.getStartRow(); // 跳过的行数（(页码-1)*每页条数） int limit = page.getPageSize(); // 每页条数 sqlBuilder.append(" OFFSET ").append(offset).append(" ROWS FETCH NEXT ").append(limit).append(" ROWS ONLY"); // 更新缓存Key（用于MyBatis缓存） pageKey.update(offset); pageKey.update(limit); return sqlBuilder.toString(); } /** * 处理分页参数（Oracle 12c直接拼接SQL，无需额外参数处理） */ @Override public Object processPageParameter(MappedStatement ms, Map<String, Object> paramMap, Page page, BoundSql boundSql) { return paramMap; } }

4. User.java（实体类）

package com.example.oraclepage.entity; /** * 测试用用户实体类（需与数据库表字段对应） */ public class User { private Long id; // 用户ID private String userName; // 用户名（对应数据库user_name） private String email; // 邮箱 // Getter & Setter public Long getId() { return id; } public void setId(Long id) { this.id = id; } public String getUserName() { return userName; } public void setUserName(String userName) { this.userName = userName; } public String getEmail() { return email; } public void setEmail(String email) { this.email = email; } // toString @Override public String toString() { return "User{" + "id=" + id + ", userName='" + userName + '\'' + ", email='" + email + '\'' + '}'; } }

5. UserMapper.java（Mapper 接口）

package com.example.oraclepage.mapper; import com.example.oraclepage.entity.User; import org.apache.ibatis.annotations.Mapper; import java.util.List; /** * 用户Mapper接口 */ @Mapper public interface UserMapper { /** * 查询所有用户（PageHelper自动分页） */ List<User> selectAllUsers(); }

6. UserMapper.xml（Mapper 映射文件）

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> <mapper namespace="com.example.oraclepage.mapper.UserMapper"> <!-- 查询所有用户 --> <select id="selectAllUsers" resultType="com.example.oraclepage.entity.User"> SELECT id, user_name, email FROM t_user <!-- 替换为你的实际表名 --> </select> </mapper>

7. UserService.java（业务层）

package com.example.oraclepage.service; import com.example.oraclepage.entity.User; import com.example.oraclepage.mapper.UserMapper; import com.github.pagehelper.PageHelper; import com.github.pagehelper.PageInfo; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import java.util.List; /** * 用户业务层 */ @Service public class UserService { @Autowired private UserMapper userMapper; /** * 分页查询用户 * @param pageNum 页码（从1开始） * @param pageSize 每页条数 * @return 分页结果（包含数据+分页信息） */ public PageInfo<User> getUsersByPage(int pageNum, int pageSize) { // 开启分页（核心：PageHelper自动拼接Oracle 12c分页SQL） PageHelper.startPage(pageNum, pageSize); // 执行查询（无需修改SQL，PageHelper自动处理） List<User> userList = userMapper.selectAllUsers(); // 包装为PageInfo（包含总条数、总页数、当前页等信息） return new PageInfo<>(userList); } }

8. OraclePageApplication.java（启动类）

package com.example.oraclepage; import org.mybatis.spring.annotation.MapperScan; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; /** * 项目启动类 */ @SpringBootApplication @MapperScan("com.example.oraclepage.mapper") // 扫描Mapper接口 public class OraclePageApplication { public static void main(String[] args) { SpringApplication.run(OraclePageApplication.class, args); } }

9. 测试 Controller（可选）

package com.example.oraclepage.controller; import com.example.oraclepage.entity.User; import com.example.oraclepage.service.UserService; import com.github.pagehelper.PageInfo; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RestController; /** * 测试接口 */ @RestController public class UserController { @Autowired private UserService userService; /** * 分页查询用户接口 * 访问示例：http://localhost:8080/users?pageNum=1&pageSize=10 */ @GetMapping("/users") public PageInfo<User> getUsers( @RequestParam(defaultValue = "1") int pageNum, @RequestParam(defaultValue = "10") int pageSize) { return userService.getUsersByPage(pageNum, pageSize); } }

二、测试

  1. CREATE TABLE t_user ( id NUMBER PRIMARY KEY, user_name VARCHAR2(50), email VARCHAR2(100) ); -- 插入测试数据 INSERT INTO t_user VALUES (1, 'zhangsan', 'zhangsan@test.com'); INSERT INTO t_user VALUES (2, 'lisi', 'lisi@test.com'); INSERT INTO t_user VALUES (3, 'wangwu', 'wangwu@test.com'); COMMIT;
  2. 启动项目：运行OraclePageApplication，访问http://localhost:8080/users?pageNum=1&pageSize=2；
  3. 查看结果：返回的 JSON 包含list（当前页数据）、total（总条数）、pages（总页数）等信息，且底层执行的 SQL 为：
    SELECT id, user_name, email FROM t_user OFFSET 0 ROWS FETCH NEXT 2 ROWS ONLY

三、注意事项

  1. 确保 Oracle 版本为 12c 及以上（OFFSET ... FETCH是 12c 新增语法）；
  2. 替换配置文件中的数据库地址、用户名、密码为你的实际信息；
  3. 表名 / 字段名需与实体类、Mapper.xml 中的配置一致；
  4. PageHelper 版本建议与 Spring Boot 版本适配（避免依赖冲突）。
http://www.jsqmd.com/news/144755/

相关文章：

  • Amazon Bedrock AgentCore：AI Agent 规模化落地的终极方案
  • rk3588变频策略等参数 - M
  • 2025年12月成都涂料/环保涂料/真石漆厂家竞争格局深度分析报告 - 2025年品牌推荐榜
  • 深入解析：【Elasticsearch】索引别名 aliases
  • 5MW风电永磁直驱发电机-1200V直流并网Simulink仿真模型
  • 告别无效调用：高效实现 AI Agent 的 Function 交互设计
  • 高中语法练习解析100篇-005-Huaweis Green 5G Development Strategy 华为的绿色5G发展战略 - new
  • Spring Boot+MyBatis：用 PageHelper 实现 Oracle 12c 的 OFFSET 分页
  • LSTM量化交易策略的环境适应性与入参稳定性评估
  • 动态可视化报告制作：DeepSeek+Mermaid生成交互式流程图/甘特图
  • 区间 LCS/LIS
  • 具有多种最大功率点跟踪（MPPT）方法的光伏发电系统（PO-增量法-人工神经网络-模糊逻辑控制-粒子群优化）之使用粒子群算法的最大功率点追踪（MPPT）（Simulink仿真实现）
  • Day51_图论2.md
  • 计算机毕设项目之基于Springboot vue的社区养老服务小程序
  • 基于HHO-KRR的多输入回归预测(哈里斯鹰优化核岭回归)附Matlab代码
  • 强化学习结合LSTM的量化交易策略奖励函数与入参关联
  • 【电缆】中压电缆局部放电的传输模型研究（Matlab代码实现）
  • CSV大文件处理全流程：数据清洗、去重与格式标准化深度实践
  • 2026企业微信SCRM新趋势：AI如何助力客户转化率提升300%
  • ue python脚本 获取资产
  • 2025年12月江苏徐州变压器系列、智能变电站、新能源配套、高低压配电柜、智慧电力系统推荐榜单：顶尖企业综合评估 - 2025年品牌推荐榜
  • 杭州品牌策略公司概述
  • 【车辆控制】基于模型预测控制MPC的摩托车主动悬挂控制附Matlab代码
  • 使用 PMU(相量测量单元)进行电力系统状态估计【IEEE-14、IEEE30节点】(Matlab代码实现）
  • 学长亲荐8个AI论文工具，自考毕业论文格式规范必备！
  • 基于IWOA-GRNN的激光熔覆质量预测建模方法附Matlab代码
  • zz为什么样本方差无偏估计要除以n-1
  • 云舟观测报表管理功能：从业务到智能运维
  • 【论道】组件封装原则
  • NC verilog ：force命令