Decimal-java is a library to convert java.math.BigDecimal to and from
IEEE-754r (IEEE-754-2008) decimal byte representations.
This library is licensed under the MIT license, see also LICENSE.md.
At the moment, the API and underlying implementation is still in a state of flux, this is expected to stabilize mid-January 2018.
This library provides conversion between java.math.BigDecimal and IEEE-754r
decimal formats.
Specifically supported are byte representations of:
- decimal32
- decimal64
- decimal128
Other formats (arbitrary precision decimal) are not planned to be supported.
For the time being, the minimum supported Java version is Java 7.
This library explicitly does not include mathematical operations on decimal.
As an alternative, consider using BigDecimal with MathContext.DECIMAL128,
MathContext.DECIMAL64, or MathContext.DECIMAL32.
The reason this library exists is that Firebird
version 4.0 added support for the SQL DECFLOAT type (with a precision of 16
and 34 digits) using decimal64 and decimal128 in the protocol, and this
support needed to be added to Jaybird,
the Firebird JDBC driver.
Unfortunately, I (Mark Rotteveel) was unable to find an existing library for this (maybe my Google-fu is lacking though), so I created one. As I believe others may have similar needs, I decided to release it as a separate library.
I have tried to keep this library generically usable, but I'm sure this raison d'être has informed a number of design and implementation decisions. Pull requests and suggestions for improvements are welcome.
Jaybird does not directly depend on this library, but instead contains a copy to reduce the number of dependencies. External dependencies for JDBC drivers are an annoyance in non-maven/gradle environments, and Jaybird already has three (although two are optional).