如何通过criteriaBuilder使用MySQL函数构造日期计算Specification查询

核心实现逻辑 #

数据库表和对应实体类没有持久化expireDate字段时，不需要给实体新增冗余字段，直接通过criteriaBuilder在查询阶段动态执行到期日=开始日期+间隔天数的计算，再将计算结果作为查询条件匹配即可。

可直接使用的代码示例 #

以下代码兼容以Hibernate为JPA实现的场景（Spring Data JPA默认实现），如果使用其他JPA实现或数据库，可根据注释调整日期计算逻辑：

import jakarta.persistence.criteria.Expression;
import jakarta.persistence.criteria.Specification;
import java.sql.Date;
import java.time.LocalDate;

public class EntitySpecs {
    public static Specification<Entity> expireDateEqual(LocalDate targetExpireDate) {
        return (root, query, cb) -> {
            // 构造动态计算的到期日表达式：startDate + duration
            // Hibernate会自动将日期+整数的sum运算翻译成对应数据库的日期加天数字面量
            Expression<Date> calculatedExpireDate = cb.sum(
                    root.<Date>get("startDate"),
                    root.<Integer>get("duration")
            );

            // 构造匹配条件：计算得到的到期日 = 目标查询日期
            return cb.equal(calculatedExpireDate, Date.valueOf(targetExpireDate));
        };
    }
}

不同数据库适配方案 #

如果使用非MySQL数据库、或JPA实现不支持直接用sum做日期加法，可通过cb.function调用数据库原生日期函数实现计算：

• PostgreSQL 替换到期日计算逻辑即可：

Expression<LocalDate> calculatedExpireDate = cb.function(
        "? + make_interval(days => ?)",
        LocalDate.class,
        root.get("startDate"),
        root.get("duration")
);

• Oracle 原生支持日期直接加数字代表加天数，和上述默认写法逻辑完全一致，无需调整。

注意事项 #

• root.get()方法传入的是实体类的属性名，不是数据库表的列名，请和实体类中定义的开始日期、间隔天数字段名保持一致。
• 如果实体类日期字段使用LocalDate类型而非java.sql.Date，直接将代码中泛型和类型引用替换为LocalDate即可，不需要额外做类型转换。
• 如果需要构造到期日范围查询（比如查询已过期、到期日在某时间段内的数据），只需要将cb.equal替换为cb.lessThan、cb.greaterThan、cb.between等条件构造方法即可，到期日计算逻辑无需改动。

针对给出的示例数据验证逻辑：

• 数据行2022-06-07 | 10计算得到到期日为2022-06-17，传入目标日期为2022-06-17时会匹配该行
• 数据行2022-06-23 | 6计算得到到期日为2022-06-29，传入目标日期为2022-06-29时会匹配该行

内容的提问来源于stack exchange，提问作者Thilina Sampath