在 Java 金融计算领域，精度丢失是一个困扰开发者多年的经典问题。二进制浮点数无法精确表示常见的十进制小数（如 0.1、0.01），导致累积误差在复杂计算中不断放大。IEEE-754r 标准引入的十进制浮点格式从根本上解决了这一问题，而 decimal-java 库则为 Java 生态系统提供了 BigDecimal 与 IEEE-754r 十进制格式之间的双向转换能力，成为金融系统数据交互的重要桥梁。
decimal-java 是由 FirebirdSQL 项目维护的 Java 库，当前版本为 2.0.1。该库的核心价值在于它支持三种 IEEE-754r 十进制浮点格式的编解码：decimal32（4 字节）、decimal64（8 字节）和 decimal128（16 字节）。这三种格式在精度和数值范围上逐步递进，开发者可以根据业务场景的精度需求选择合适的格式。值得注意的是，2.0.1 版本要求 Java 17 或更高版本，并采用模块化设计，模块名为 org.firebirdsql.decimal；如果项目仍需运行在 Java 7 环境中，可以回退到 1.0.2 版本。
从工程参数的角度来看，三种格式的选型依据非常明确。decimal32 提供 7 位十进制有效数字，指数范围为 -95 到 +96，适用于对精度要求不高且数据量巨大的场景，例如物联网设备传输的测量值。decimal64 提供 16 位十进制有效数字，指数范围为 -383 到 +384，这是 Firebird 4.0 数据库 DECFLOAT (16) 所采用的格式，能够满足绝大多数商业计算的需求。decimal128 则提供 34 位十进制有效数字，指数范围为 -6143 到 +6144，对应 DECFLOAT (34)，是金融系统中处理货币金额的首选格式，其精度足以覆盖绝大多数法定货币的计算需求。从内存占用角度，三者的比例为 1:2:4，在高吞吐量场景下选择合适的格式可以显著降低内存压力。
在实际集成中，开发者需要关注溢出处理策略这一关键配置项。decimal-java 的 Decimal32、Decimal64 和 Decimal128 类都提供了 valueOf 方法用于将 BigDecimal 转换为十进制浮点格式。当 BigDecimal 的值超出目标格式的表示范围时，默认行为是将其舍入为正负无穷大（Infinity）。这种默认行为在某些业务场景中可能是不可接受的，因为无穷大会破坏后续的业务逻辑判断。为此，库提供了 OverflowHandling.THROW_EXCEPTION 选项，开发者可以在调用 valueOf 时传入该参数，使溢出情况抛出 DecimalOverflowException 异常，从而让调用方主动处理溢出场景而非静默接受无穷大。
另一个需要关注的边界情况是特殊数值的处理。IEEE-754r 规范定义了正负无穷大（Positive Infinity、Negative Infinity）以及非数值（NaN，Not a Number）这两个特殊概念。当从十进制浮点格式转换回 BigDecimal 时，如果源数据包含这些特殊值，toBigDecimal 方法会抛出 DecimalInconvertibleException 异常。该异常包含了原始特殊值的类型和符号信息，开发者可以通过捕获该异常获取这些细节。如果业务逻辑需要处理这些特殊值，可以调用 Decimal 对象的其他方法（如 isInfinite ()、isNaN ()）先行判断。
从依赖管理的角度，decimal-java 已经发布到 Maven 中央仓库，开发者只需添加一个依赖即可使用。其 GroupId 为 org.firebirdsql，ArtifactId 为 decimal-java，当前最新版本是 2.0.1。值得注意的是，Firebird 的 JDBC 驱动 Jaybird 并没有直接依赖这个库，而是将代码复制进自身项目，以减少 JDBC 驱动在非 Maven/Gradle 环境中的依赖困扰。这一决策也从侧面反映了金融级项目对依赖精简的严格要求。
综合以上工程参数和配置建议，当团队需要在 Java 环境中处理与数据库或外部系统的十进制浮点数据交互时，建议按照以下原则选型：对于货币金额计算优先采用 decimal128 以确保 34 位精度的可靠保障；对于一般的商业数据存储和传输，decimal64 是性价比最高的选择；对于遗留系统或资源受限环境，decimal32 提供了最小的内存占用。在溢出处理策略上，生产环境建议显式指定 OverflowHandling.THROW_EXCEPTION，避免静默的溢出导致难以追踪的计算错误。
资料来源：GitHub firebirdsql/decimal-java (https://github.com/firebirdsql/decimal-java)