Fundamentos de BigDecimal

En el ecosistema de Java, los tipos de datos primitivos de punto flotante como float y double operan en base binaria, lo que inherentemente provoca pérdida de precisión al representar ciertos números decimales. Para escenarios que exigen exactitud matemática, como las transacciones financieras o cálculos científicos complejos, la clase java.math.BigDecimal es la solución estándar.

A diferencia de los tipos primitivos, BigDecimal puede manejar números con una cantidad arbitraria de dígitos significativos. Es crucial recordar que los objetos BigDecimal son inmutables; por lo tanto, no es posible utilizar los operadores aritméticos tradicionales (+, -, *, /). En su lugar, se deben invocar los métodos específicos de la clase, los cuales siempre retornan una nueva instancia sin alterar el objeto original.

Instancicaión y Constructores Seguros

Un error común al trabajar con esta clase es utilizar el constructor que acepta un parámetro de tipo double. Esta práctica hereda los problemas de precisión del tipo primitivo subycaente. Para garantizar la exactitud del valor, se debe utilizar el constructor que recibe un String o el método estático valueOf().

// Enfoques recomendados para evitar pérdida de precisión
BigDecimal accountBalance = new BigDecimal("150.75");
BigDecimal interestRate = BigDecimal.valueOf(0.035);

// Enfoque incorrecto que causa artefactos de punto flotante
BigDecimal flawedBalance = new BigDecimal(150.75); 
// El valor real almacenado tendrá una desviación binaria (ej. 150.75000000000000000...)

Adicionalmente, la API proporciona constantes estáticas inmutables para valores comunes, lo cual optimiza el uso de memoria y mejora la legibilidad del código:

BigDecimal emptyTotal = BigDecimal.ZERO;
BigDecimal unitIncrement = BigDecimal.ONE;
BigDecimal decimalShift = BigDecimal.TEN;

Operaciones Aritméticas

Las operaciones matemáticas se realizan mediante métodos que aceptan otro BigDecimal como argumento. Dado que los objetos son inmutables, el resultado de cada operación debe ser asignado a una variable.

BigDecimal principal = new BigDecimal("1000.00");
BigDecimal rate = new BigDecimal("0.05");

// Multiplicación para calcular intereses
BigDecimal interest = principal.multiply(rate);

// Suma para obtener el monto total
BigDecimal totalAmount = principal.add(interest);

// Resta para aplicar un descuento
BigDecimal finalAmount = totalAmount.subtract(new BigDecimal("50.00"));

// División para prorratear entre 4 personas (requiere escala y modo de redondeo para evitar excepciones)
BigDecimal perPersonShare = finalAmount.divide(new BigDecimal("4"), RoundingMode.HALF_UP);

Evaluación de Igualdad y Comparación

Al comparar instancias de BigDecimal, es funadmental comprender la diferencia entre los métodos compareTo() y equals(). El método compareTo() evalúa el valor matemático y retorna un entero (-1, 0, o 1), ignorando la escala (cantidad de decimales). Por el contrario, equals() exige que tanto el valor numérico como la escala sean idénticos.

BigDecimal measurementA = new BigDecimal("10.0");
BigDecimal measurementB = new BigDecimal("10.00");

// Comparación matemática (Recomendado)
int mathComparison = measurementA.compareTo(measurementB); 
// Retorna 0, indicando que son matemáticamente equivalentes

// Comparación estricta de objetos (No recomendado para lógica de negocios)
boolean strictEquality = measurementA.equals(measurementB); 
// Retorna false porque las escalas (1 y 2) son diferentes

// Normalización de escala para usar equals de manera segura
BigDecimal normalizedA = measurementA.setScale(2);
BigDecimal normalizedB = measurementB.setScale(2);
boolean normalizedEquality = normalizedA.equals(normalizedB); 
// Retorna true al unificar la precisión