導入：なぜBigDecimalの比較でハマるのか
Javaの数値計算において、通貨や厳密な精度が求められる計算にはBigDecimalクラスが必須です。しかし、多くのエンジニアが「if (a.equals(b))」と記述してバグを埋め込んでしまいます。BigDecimalは「値」だけでなく「スケール（小数点以下の桁数）」まで含めて等価性を判定するため、1.0と1.00を別物として扱ってしまうからです。本記事では、この問題を解決し、意図した通りの比較を行うためのベストプラクティスを解説します。
基礎知識：equalsとcompareToの違い
Javaのequals()メソッドは、値とスケールの両方が完全に一致したときのみtrueを返します。一方、compareTo()メソッドは、2つの数値の数学的な大小関係を比較します。
- equals(): 1.0.equals(1.00) は false
- compareTo(): 1.0.compareTo(1.00) は 0（等しい）
スケールを無視して「数学的に等しいかどうか」を判断したい場合は、必ずcompareTo()を使用し、その結果が0であるかを確認する必要があります。
実装：compareToによる安全な比較
比較を行う際は、以下の手順をとるのが標準的です。
1. 比較対象のBigDecimalがnullでないことを確認する。
2. compareTo()メソッドを呼び出す。
3. 戻り値が 0 であるかを判定する（0なら等しい、-1なら小さい、1なら大きい）。
サンプルプログラム
以下のコードで、equalsとcompareToの挙動の違いと、正しい比較方法を確認してください。
import java.math.BigDecimal;
public class BigDecimalComparison {
public static void main(String[] args) {
BigDecimal val1 = new BigDecimal("1.0");
BigDecimal val2 = new BigDecimal("1.00");
// 1. 間違った比較方法：equalsを使用
// スケールが異なるため false となる
System.out.println("equalsの結果: " + val1.equals(val2));
// 2. 正しい比較方法：compareToを使用
// 数学的な値のみを比較するため 0 (等しい) が返る
if (val1.compareTo(val2) == 0) {
System.out.println("compareToの結果: 値は等しいです");
} else {
System.out.println("compareToの結果: 値は異なります");
}
}
}
応用・注意点：現場で陥りやすい罠
実務でさらに注意すべき点として、以下の2つを覚えておいてください。
1. compareToの戻り値の解釈
compareToは「0」以外にも「-1」や「1」を返します。特定の数値より大きいか小さいかを判定する際、「if (val.compareTo(other) == 1)」と書くとコードが読みづらくなることがあります。「if (val.compareTo(other) > 0)」のように、正負の比較演算子を使うことで、可読性が向上しミスも減ります。
2. equalsを避けるべきケース
MapのキーとしてBigDecimalを使用する場合、Mapは内部でequalsを使用します。そのため、スケールの異なるBigDecimalを同一のキーとして扱うことができません。Mapを使用する際は、事前に stripTrailingZeros() を呼び出してスケールを正規化してから格納するなどの工夫が必要です。
正しい比較手法をマスターして、精度にシビアなシステムでも堅牢なコードを書きましょう。
コメント