背景

一直从事金融相关项目，所以对 BigDecimal 再熟悉不过了，也曾看到很多同学因为不知道、不了解或使用不当导致资损事件发生。

所以，如果你从事金融相关项目，或者你的项目中涉及到金额的计算，那么你一定要花时间看看这篇文章，全面学习一下 BigDecimal。

BigDecimal 概述

Java 在 java.math 包中提供的 API 类 BigDecimal，用来对超过 16 位有效位的数进行精确的运算。双精度浮点型变量 double 可以处理 16 位有效数，但在实际应用中，可能需要对更大或者更小的数进行运算和处理。

一般情况下，对于不需要准确计算精度的数字，可以直接使用 Float 和 Double 处理，但是 Double.valueOf(String) 和 Float.valueOf(String)会丢失精度。所以如果需要精确计算的结果，则必须使用 BigDecimal 类来操作。

BigDecimal 对象提供了传统的+、-、*、/等算术运算符对应的方法，通过这些方法进行相应的操作。BigDecimal 都是不可变的（immutable）的， 在进行每一次四则运算时，都会产生一个新的对象 ，所以在做加减乘除运算时要记得要保存操作后的值。

BigDecimal 的 4 个坑

在使用 BigDecimal 时，有 4 种使用场景下的坑，你一定要了解一下，如果使用不当，必定很惨。掌握这些案例，当别人写出有坑的代码，你也能够一眼识别出来，大牛就是这么练成的。

第一：浮点类型的坑

在学习了解 BigDecimal 的坑之前，先来说一个老生常谈的问题：如果使用 Float、Double 等浮点类型进行计算时，有可能得到的是一个近似值，而不是精确的值。

比如下面的代码：

 @Test public void test0(){  float a = 1;  float b = 0.9f;  System.out.println(a - b); }

结果是多少？0.1 吗？不是，执行上面代码执行的结果是 0.100000024。之所以产生这样的结果，是因为 0.1 的二进制表示是无限循环的。由于计算机的资源是有限的，所以是没办法用二进制精确的表示 0.1，只能用「近似值」来表示，就是在有限的精度情况下，最大化接近 0.1 的二进制数，于是就会造成精度缺失的情况。

关于上述的现象大家都知道，不再详细展开。同时，还会得出结论在科学计数法时可考虑使用浮点类型，但如果是涉及到金额计算要使用 BigDecimal 来计算。

那么，BigDecimal 就一定能避免上述的浮点问题吗？来看下面的示例：

 @Test public void test1(){  BigDecimal a = new BigDecimal(0.01);  BigDecimal b = BigDecimal.valueOf(0.01);  System.out.println("a = " + a);  System.out.println("b = " + b); }

上述单元测试中的代码，a 和 b 结果分别是什么？

a = 0.01000000000000000020816681711721685132943093776702880859375b = 0.01

上面的实例说明，即便是使用 BigDecimal，结果依旧会出现精度问题。这就涉及到创建 BigDecimal 对象时，如果有初始值，是采用 new BigDecimal 的形式，还是通过 BigDecimal#valueOf 方法了。

之所以会出现上述现象，是因为 new BigDecimal 时，传入的 0.1 已经是浮点类型了，鉴于上面说的这个值只是近似值，在使用 new BigDecimal 时就把这个近似值完整的保留下来了。

而 BigDecimal#valueOf 则不同，它的源码实现如下：

    public static BigDecimal valueOf(double val) {        // Reminder: a zero double returns '0.0', so we cannot fastpath        // to use the constant ZERO.  This might be important enough to        // justify a factory approach, a cache, or a few private        // constants, later.        return new BigDecimal(Double.toString(val));    }

在 valueOf 内部，使用 Double#toString 方法，将浮点类型的值转换成了字符串，因此就不存在精度丢失问题了。

此时就得出一个基本的结论：第一，在使用 BigDecimal 构造函数时，尽量传递字符串而非浮点类型；第二，如果无法满足第一条，则可采用 BigDecimal#valueOf 方法来构造初始化值。

这里延伸一下，BigDecimal 常见的构造方法有如下几种：

BigDecimal(int)       创建一个具有参数所指定整数值的对象。BigDecimal(double)    创建一个具有参数所指定双精度值的对象。BigDecimal(long)      创建一个具有参数所指定长整数值的对象。BigDecimal(String)    创建一个具有参数所指定以字符串表示的数值的对象。

其中涉及到参数类型为 double 的构造方法，会出现上述的问题，使用时需特别留意。

第二：浮点精度的坑

如果比较两个 BigDecimal 的值是否相等，你会如何比较？使用 equals 方法还是 compareTo 方法呢？

先来看一个示例：

 @Test public void test2(){  BigDecimal a = new BigDecimal("0.01");  BigDecimal b = new BigDecimal("0.010");  System.out.println(a.equals(b));  System.out.println(a.compareTo(b)); }

乍一看感觉可能相等，但实际上它们的本质并不相同。

equals 方法是基于 BigDecimal 实现的 equals 方法来进行比较的，直观印象就是比较两个对象是否相同，那么代码是如何实现的呢？

    @Override    public boolean equals(Object x) {        if (!(x instanceof BigDecimal))            return false;        BigDecimal xDec = (BigDecimal) x;        if (x == this)            return true;        if (scale != xDec.scale)            return false;        long s = this.intCompact;        long xs = xDec.intCompact;        if (s != INFLATED) {            if (xs == INFLATED)                xs = compactValFor(xDec.intVal);            return xs == s;        } else if (xs != INFLATED)            return xs == compactValFor(this.intVal);
        return this.inflated().equals(xDec.inflated());    }

仔细阅读代码可以看出，equals 方法不仅比较了值是否相等，还比较了精度是否相同。上述示例中，由于两者的精度不同，所以 equals 方法的结果当然是 false 了。而 compareTo 方法实现了 Comparable 接口，真正比较的是值的大小，返回的值为-1（小于），0（等于），1（大于）。

基本结论：通常情况，如果比较两个 BigDecimal 值的大小，采用其实现的 compareTo 方法；如果严格限制精度的比较，那么则可考虑使用 equals 方法。

另外，这种场景在比较 0 值的时候比较常见，比如比较 BigDecimal("0")、BigDecimal("0.0")、BigDecimal("0.00")，此时一定要使用 compareTo 方法进行比较。

第三：设置精度的坑

在项目中看到好多同学通过 BigDecimal 进行计算时不设置计算结果的精度和舍入模式，真是着急人，虽然大多数情况下不会出现什么问题。但下面的场景就不一定了：

 @Test public void test3(){  BigDecimal a = new BigDecimal("1.0");  BigDecimal b = new BigDecimal("3.0");  a.divide(b); }

执行上述代码的结果是什么？ArithmeticException 异常！

java.lang.ArithmeticException: Non-terminating decimal expansion; no exact representable decimal result.
 at java.math.BigDecimal.divide(BigDecimal.java:1690) ...

这个异常的发生在官方文档中也有说明：

If the quotient has a nonterminating decimal expansion and the operation is specified to return an exact result, an ArithmeticException is thrown. Otherwise, the exact result of the division is returned, as done for other operations.

总结一下就是，如果在除法（divide）运算过程中，如果商是一个无限小数（0.333…），而操作的结果预期是一个精确的数字，那么将会抛出 ArithmeticException 异常。

此时，只需在使用 divide 方法时指定结果的精度即可：

 @Test public void test3(){  BigDecimal a = new BigDecimal("1.0");  BigDecimal b = new BigDecimal("3.0");  BigDecimal c = a.divide(b, 2,RoundingMode.HALF_UP);  System.out.println(c); }

执行上述代码，输入结果为 0.33。

基本结论：在使用 BigDecimal 进行（所有）运算时，一定要明确指定精度和舍入模式。

拓展一下，舍入模式定义在 RoundingMode 枚举类中，共有 8 种：

• RoundingMode.UP：舍入远离零的舍入模式。在丢弃非零部分之前始终增加数字(始终对非零舍弃部分前面的数字加 1)。注意，此舍入模式始终不会减少计算值的大小。

• RoundingMode.DOWN：接近零的舍入模式。在丢弃某部分之前始终不增加数字(从不对舍弃部分前面的数字加 1，即截短)。注意，此舍入模式始终不会增加计算值的大小。

• RoundingMode.CEILING：接近正无穷大的舍入模式。如果 BigDecimal 为正，则舍入行为与 ROUNDUP 相同;如果为负，则舍入行为与 ROUNDDOWN 相同。注意，此舍入模式始终不会减少计算值。

• RoundingMode.FLOOR：接近负无穷大的舍入模式。如果 BigDecimal 为正，则舍入行为与 ROUNDDOWN 相同;如果为负，则舍入行为与 ROUNDUP 相同。注意，此舍入模式始终不会增加计算值。

• RoundingMode.HALF_UP：向“最接近的”数字舍入，如果与两个相邻数字的距离相等，则为向上舍入的舍入模式。如果舍弃部分 >= 0.5，则舍入行为与 ROUND_UP 相同;否则舍入行为与 ROUND_DOWN 相同。注意，这是我们在小学时学过的舍入模式(四舍五入)。

• RoundingMode.HALF_DOWN：向“最接近的”数字舍入，如果与两个相邻数字的距离相等，则为上舍入的舍入模式。如果舍弃部分 > 0.5，则舍入行为与 ROUND_UP 相同;否则舍入行为与 ROUND_DOWN 相同(五舍六入)。

• RoundingMode.HALF_EVEN：向“最接近的”数字舍入，如果与两个相邻数字的距离相等，则向相邻的偶数舍入。如果舍弃部分左边的数字为奇数，则舍入行为与 ROUNDHALFUP 相同;如果为偶数，则舍入行为与 ROUNDHALF_DOWN 相同。注意，在重复进行一系列计算时，此舍入模式可以将累加错误减到最小。此舍入模式也称为“银行家舍入法”，主要在美国使用。四舍六入，五分两种情况。如果前一位为奇数，则入位，否则舍去。以下例子为保留小数点 1 位，那么这种舍入方式下的结果。1.15 ==> 1.2 ,1.25 ==> 1.2

• RoundingMode.UNNECESSARY：断言请求的操作具有精确的结果，因此不需要舍入。如果对获得精确结果的操作指定此舍入模式，则抛出 ArithmeticException。

通常我们使用的四舍五入即 RoundingMode.HALF_UP。

第四：三种字符串输出的坑

当使用 BigDecimal 之后，需要转换成 String 类型，你是如何操作的？直接 toString？

先来看看下面的代码：

@Testpublic void test4(){	BigDecimal a = BigDecimal.valueOf(35634535255456719.22345634534124578902);	System.out.println(a.toString());}

执行的结果是上述对应的值吗？并不是：

3.563453525545672E+16

也就是说，本来想打印字符串的，结果打印出来的是科学计数法的值。

这里我们需要了解 BigDecimal 转换字符串的三个方法

• toPlainString()：不使用任何科学计数法；

• toString()：在必要的时候使用科学计数法；

• toEngineeringString() ：在必要的时候使用工程计数法。类似于科学计数法，只不过指数的幂都是 3 的倍数，这样方便工程上的应用，因为在很多单位转换的时候都是 10^3；

三种方法展示结果示例如下：

计算法

基本结论：**根据数据结果展示格式不同，采用不同的字符串输出方法，通常使用比较多的方法为 toPlainString()**。

另外，NumberFormat 类的 format()方法可以使用 BigDecimal 对象作为其参数，可以利用 BigDecimal 对超出 16 位有效数字的货币值，百分值，以及一般数值进行格式化控制。

使用示例如下：

NumberFormat currency = NumberFormat.getCurrencyInstance(); //建立货币格式化引用NumberFormat percent = NumberFormat.getPercentInstance();  //建立百分比格式化引用percent.setMaximumFractionDigits(3); //百分比小数点最多3位
BigDecimal loanAmount = new BigDecimal("15000.48"); //金额BigDecimal interestRate = new BigDecimal("0.008"); //利率BigDecimal interest = loanAmount.multiply(interestRate); //相乘
System.out.println("金额:\t" + currency.format(loanAmount));System.out.println("利率:\t" + percent.format(interestRate));System.out.println("利息:\t" + currency.format(interest));

输出结果如下：

金额: ￥15,000.48 利率: 0.8% 利息: ￥120.00

小结

本篇文章介绍了 BigDecimal 使用中场景的坑，以及基于这些坑我们得出的“最佳实践”。虽然某些场景下推荐使用 BigDecimal，它能够达到更好的精度，但性能相较于 double 和 float，还是有一定的损失的，特别在处理庞大，复杂的运算时尤为明显。故一般精度的计算没必要使用 BigDecimal。而必须使用时，一定要规避上述的坑。

原文链接：https://mp.weixin.qq.com/s/zNIp1rmdauu6g-sV-gHjEw

作者：程序员新视界