如何在Spring JPA中映射Oracle的INTERVAL DAY TO SECOND类型

胖墨同学_1770

胖墨同学_1770

2026-06-17

173人浏览

原创

Oracle INTERVAL DAY TO SECOND在JPA中默认不被支持,需手动实现AttributeConverter并注册自定义Oracle方言,使用ojdbc8+驱动通过Connection.createOracleInterval()安全转换为oracle.sql.INTERVALDS,避免精度丢失或字节错位。

Oracle INTERVAL DAY TO SECOND 在 JPA 中默认不被识别

spring data jpa(含 hibernate)本身不原生支持 interval day to second 类型,直接映射到 java.time.duration 会报错:persistenceexception: unable to resolve java type for column ... of type interval day to second。jdbc 驱动(如 ojdbc8)虽能读取该类型为 oracle.sql.intervalds,但 hibernate 的方言未注册对应转换器,导致元数据解析失败或字段被忽略。

  • 不是所有 Oracle JDBC 版本都返回 INTERVALDS 实例 —— 低版本可能退化为 String 或 BigDecimal,尤其在使用 ResultSet.getObject() 时行为不一致
  • @Column(columnDefinition = "INTERVAL DAY TO SECOND") 仅影响 DDL 生成,对读写无实际作用
  • 若实体字段声明为 Duration,Hibernate 会尝试用默认 converter,但找不到匹配的 AttributeConverter,最终抛 MappingException

必须手动注册 AttributeConverter

核心解法是实现 AttributeConverter<duration oracle.sql.intervalds></duration>,并确保它被 JPA 扫描到。注意:不能用 String 或 Long 中间转换,否则丢失精度(尤其是微秒级秒小数)。

  • Converter 必须处理 null 输入,且 convertToDatabaseColumn 返回的 INTERVALDS 需通过 Connection.createOracleInterval() 构造,不能 new
  • 需在 persistence.xml 中显式声明 converter,或在实体类上用 @Convert(converter = DurationToIntervalDsConverter.class) 绑定
  • 依赖 ojdbc8 或更高版本(至少 21.1+),旧版驱动中 INTERVALDS 构造方法签名不同,比如缺少 toJdbc() 或精度参数
  • 示例片段:
public class DurationToIntervalDsConverter implements AttributeConverter<duration oracle.sql.intervalds> {
    @Override
    public oracle.sql.INTERVALDS convertToDatabaseColumn(Duration duration) {
        if (duration == null) return null;
        // 注意:必须用 Connection 创建,不能 new INTERVALDS()
        return (oracle.sql.INTERVALDS) connection.createOracleInterval(
            "INTERVAL '" + duration.toDays() + " " +
            duration.toHoursPart() + ":" +
            duration.toMinutesPart() + ":" +
            duration.toSecondsPart() + "." +
            String.format("%09d", duration.getNano()).substring(0, 6) +
            "' DAY TO SECOND(6)"
        );
    }
    // convertToEntityAttribute 同理,调用 INTERVALDS.toDuration()
}</duration>

避免用 @Lob 或 byte[] 替代

有人尝试把 INTERVAL DAY TO SECOND 映射为 byte[] 或 @Lob,这是危险的。该类型内部是 11 字节二进制结构(含偏移量编码),直接读写会导致字节错位、符号翻转或纳秒截断 —— 比如天数字段加了 0X80000000 偏移,误当普通整数解析会得到负值。

QuantOracle
QuantOracle

63个确定性量化金融计算器 + 10个通过MCP的复合工作流。期权定价、Greeks、奇异衍生品、风险指标、投资组合优化……

下载
  • INTERVALDS.toBytes() 返回的是 Oracle 内部格式,不是标准 duration 序列化
  • 即使成功存入,跨平台(如不同 endianness 的服务器)或不同 ojdbc 版本下读取结果不可靠
  • JPA 生命周期回调(@PrePersist)中无法安全构造 INTERVALDS,因为此时没有 active Connection

Spring Boot 项目需额外配置方言

仅注册 Converter 不够。Hibernate 默认 Oracle 方言(OracleDialect)不注册 INTERVAL DAY TO SECOND 类型码(SQL 类型 183),需继承并覆盖 registerColumnType。

  • 新建自定义方言类,调用 super.registerColumnType(Types.OTHER, "interval day to second") 并添加对 INTERVALDS 的绑定
  • 在 application.yml 中指定:spring.jpa.database-platform: com.example.CustomOracleDialect
  • 若用 Spring Data JDBC(非 JPA),则无需方言,但要手动在 ResultSet 中用 getINTERVALDS() 提取,并自行转换

最易被忽略的是:Converter 中的 Connection 获取方式。JPA 不保证在 converter 执行时有可用 connection,必须通过 EntityManager.unwrap(SessionImplementor.class).getJdbcConnectionAccess().obtainConnection() 安全获取,否则在事务外调用会 NPE 或连接泄漏。

相关文章

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

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

下载

相关标签:

oracle

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

相关专题

更多
oracle清空表数据
oracle清空表数据

当表中的数据不需要时,则应该删除该数据并释放所占用的空间。本专题为大家提供oracle清空表数据的相关文章,帮助大家解决该问题。

2023.08.16

961

5

Oracle中declare的使用
Oracle中declare的使用

Oracle DECLARE语句是PL/SQL编程语言中用于声明变量、常量、游标或异常的关键字。它的主要作用是在程序中定义这些对象,以便在后续的代码中使用。DECLARE语句的语法简单明了,可以根据需要声明多个对象。通过使用这些声明的对象,可以进行各种操作,如计算、查询数据库、处理异常等 。

2023.09.15

2773

5

oracle怎么分页
oracle怎么分页

实现分页的步骤:1、使用ROWNUM进行分页查询;2、在执行查询之前进行设置分页参数;3、使用"COUNT(*)"函数来获取总行数,并使用"CEIL"函数来向上取整计算总页数;4、在外部查询中使用"WHERE"子句来筛选出特定的行号范围,以实现分页查询。想了解更多oracle怎么分页的文章,可以来阅读本专题先的文章。

2023.09.18

2790

5

Oracle查看表操作历史记录
Oracle查看表操作历史记录

查看操作历史记录的方法:1、使用Oracle内置的审计功能,可以记录数据库中发生的各种操作,包括登录、DDL语句、DML语句等;2、使用Oracle日志文件,其中包含了数据库中发生的各种操作,可以通过查看日志文件来获取操作历史记录;3、使用Oracle的Flashback功能,可以查看数据库在某个时间点的操作历史记录;4、使用第三方工具等。本专题还提供其他查看表操作的文章,大家可以免费阅读。

2023.09.19

1589

3

Oracle中RAC的用法
Oracle中RAC的用法

Oracle中RAC的用法:1、通过在多个服务器上运行数据库实例来提供高可用性;2、允许在需要时增加或减少节点数量;3、通过将工作负载分布到多个节点上来实现负载均衡;4、使用共享存储来实现多个节点之间的数据共享;5、允许多个节点同时处理数据库请求,从而实现并行处理;6、提供了透明故障切换功能;7、使用了一些技术来确保数据的一致性;8、提供了管理工具来简化RAC环境的管理和维护。本专题还提供RAC相关的其他文章,大家可以免费阅读。

2023.09.19

2213

7

oracle imp
oracle imp

imp是Oracle数据库中的一个命令行工具,用于将导出的数据和对象从一个数据库实例导入到另一个数据库实例。imp命令的一般语法为“imp username/password@connect_string file=file_name [options]”。

2023.09.19

2949

4

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.02

4449

19

oracle通配符有哪些
oracle通配符有哪些

oracle通配符有“%”、“_”、“[]”和“[^]"。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.08

237

5

oracle四舍五入怎么操作
oracle四舍五入怎么操作

oracle四舍五入操作可以使用ROUND函数来实现,其语法为“ROUND(number, decimal_places)”,其中,number是要进行四舍五入的数值,decimal_places是指定的小数位数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.14

766

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程