如何通过点击按钮逐日回溯查询数据库中的文档数据

胖墨小哥_5696

胖墨小哥_5696

2026-06-25

404人浏览

原创

本文介绍如何在 web 应用中实现“点击一次,查询前一天数据;再点一次,查询前两天数据”的动态日期偏移查询逻辑,涵盖 spring boot 控制器设计、dao 层日期计算与 hql 参数化查询的关键实现。

本文介绍如何在 web 应用中实现“点击一次,查询前一天数据;再点一次,查询前两天数据”的动态日期偏移查询逻辑,涵盖 spring boot 控制器设计、dao 层日期计算与 hql 参数化查询的关键实现。

在构建文档管理系统时,常需支持按时间维度灵活翻页查看历史数据——例如用户每点击一次“上一天”按钮,页面即加载该用户指定天数前(如 1 天前、2 天前……)的全部文档。这要求后端接口能接收动态日期偏移量,并精准匹配数据库中 dateOfIssue 字段(类型为 java.util.Date 或 LocalDate)。

✅ 正确的实现思路:路径参数传递偏移量 + 服务端计算目标日期

原始代码存在两个核心问题:

  1. 硬编码逻辑:仅支持固定“前一天”,无法响应多次点击的递增偏移需求;
  2. SQL 写法错误:current_date() 是 SQL 函数,但未适配 JPA/Hibernate 的参数绑定机制,且未传入实际日期值,导致查询始终为空或报错。

解决方案是将“偏移天数”作为路径变量({daysOffset})传入,由服务端基于当前日期动态计算目标日期,并通过参数化 HQL 安全查询:

Spring Boot Actuator Analyzer
Spring Boot Actuator Analyzer

分析Spring Boot Actuator端点的安全性、健康检查、指标暴露及生产配置——审计信息、健康状态和自定义端点。

下载

? 控制器层(Controller)

@RequestMapping(value = "/getPrevDay/{uztId}/{daysOffset}", method = RequestMethod.GET)
@ResponseBody
@ResponseStatus(HttpStatus.OK)
@ApiOperation(value = "获取指定偏移天数的文档列表(负数表示过去,如 -1=昨天,-2=前天)")
@ApiResponses({
    @ApiResponse(code = 200, message = "Success", response = ResponseApi.class)
})
public List<documents> getPrevDay(
        @PathVariable("uztId") Integer uztId,
        @PathVariable Integer daysOffset) {
    return documentsDao.getPrevDay(uztId, daysOffset);
}</documents>

? 建议将 daysOffset 设计为负数表示过去(如 -1, -2, -3),语义更清晰。前端按钮可维护一个计数器 offset = -1, -2, -3... 并拼接到 URL 中。

? DAO 层(使用现代 Java 时间 API)

public List<documents> getPrevDay(Integer uztId, Integer daysOffset) {
    // 使用 LocalDate 精确处理日期(忽略时分秒)
    LocalDate targetDate = LocalDate.now().plusDays(daysOffset); // 如 daysOffset = -2 → 前天

    // 转为 Date 类型(适配 legacy Date 字段)
    ZoneId zone = ZoneId.systemDefault();
    Date dateParam = Date.from(targetDate.atStartOfDay(zone).toInstant());

    return getCurrentSession()
            .createQuery("FROM Documents WHERE uztId = :uztId AND dateOfIssue = :dateOfIssue ORDER BY dateOfIssue DESC", Documents.class)
            .setParameter("uztId", uztId)
            .setParameter("dateOfIssue", dateParam) // ✅ 参数化,安全且准确
            .getResultList();
}</documents>

⚠️ 关键注意事项

  • 字段名一致性:示例答案中 DAO 查询写的是 dataOfIssue,但问题描述和控制器注释均为 dateOfIssue,请务必统一实体类属性名、数据库列名及 HQL 中的字段名,否则查询将返回空列表。
  • 日期精度问题:若 dateOfIssue 在数据库中存储为含时间的 DATETIME(如 2024-05-20 14:30:00),直接使用 = 匹配 2024-05-20 00:00:00 会失败。此时应改用范围查询:
    // 替代方案:查询当天 00:00:00 至 23:59:59 的所有记录
    .createQuery("FROM Documents WHERE uztId = :uztId " +
                 "AND dateOfIssue >= :startOfDay AND dateOfIssue 
  • 时区安全:ZoneId.systemDefault() 依赖服务器时区。生产环境建议显式指定业务时区(如 ZoneId.of("Asia/Shanghai"))以避免跨服务器行为不一致。
  • 前端调用示例(JavaScript):
    let offset = -1; // 初始偏移:昨天
    function loadPrevDay() {
        fetch(`/getPrevDay/${uztId}/${offset}`)
            .then(res => res.json())
            .then(docs => renderDocs(docs))
            .catch(err => console.error(err));
        offset--; // 每次点击减1,实现“越点越早”
    }

✅ 总结

实现“逐日回溯查询”的本质是:将用户操作转化为可计算的日期偏移量,并通过参数化查询安全、精确地匹配目标日期的数据。避免硬编码日期逻辑、慎用 SQL 内置函数、统一字段命名、关注日期精度与时区,是构建健壮时间查询功能的四大基石。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

spring boot

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

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

2023.06.15

10077

6

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

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

2023.07.05

7222

9

java自学难吗
java自学难吗

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

2023.07.31

6352

8

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

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

2023.08.01

1104

3

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

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

2023.08.02

908

3

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

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

2023.08.02

1336

5

java有什么用
java有什么用

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

2023.08.02

2649

5

java在线网站
java在线网站

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

2023.08.03

19971

3

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

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

2023.08.03

1175

8

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Spring Boot 官方快速入门指南
Spring Boot 官方快速入门指南

共0课时 | 0人学习

Spring Boot 官方参考文档
Spring Boot 官方参考文档

共0课时 | 0人学习

尚硅谷新版SpringBoot3教程
尚硅谷新版SpringBoot3教程

共0课时 | 0人学习