BigDecimal 保留两位小数注解

在 Java 中，对于 BigDecimal 类型字段保留两位小数的需求，通常不会通过注解直接实现数值的处理逻辑。然而，在某些框架下，比如 Hibernate Validator 或者 Spring Validation 可以利用自定义注解配合特定的方法间接达到目的。
当涉及到数据验证层面时，可以通过创建自定义注解并结合约束校验器来确保某个属性值遵循指定规则，如保留两位小数。这并不是说该注解会自动修改 BigDecimal 的值使其仅保留两位小数，而是用来检验传入的数据是否已经满足此条件[^4]。
为了实现这样的功能，首先需要定义一个新的注解：
import javax.validation.Constraint;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Constraint(validatedBy = BigDecimalTwoDecimalPlacesValidator.class)
@Target({ ElementType.FIELD })
@Retention(RetentionPolicy.RUNTIME)
public @interface TwoDecimalPlaces {
String message() default "Must have two decimal places";
Class<?>[] groups() default {};
Class<? extends Payload>[] payload() default {};
}
登录后复制
接着编写对应的校验器类 BigDecimalTwoDecimalPlacesValidator 来具体执行验证逻辑：
import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;

public class BigDecimalTwoDecimalPlacesValidator implements ConstraintValidator<TwoDecimalPlaces, BigDecimal> {

@Override
public boolean isValid(BigDecimal value, ConstraintValidatorContext context){
if (value == null || value.scale() <= 2) {
return true;
}

try{
// Check scale after rounding to ensure it has at most 2 digits after the point.
return value.setScale(2,RoundingMode.HALF_UP).scale()<=2;
}catch(ArithmeticException e){
return false;
}
}

}
登录后复制
最后可以在实体类中应用这个新创建的注解到相应的字段上：
public class Product {

private Long id;

@TwoDecimalPlaces(message="Price must be with exactly two decimals.")
private BigDecimal price;

// getters and setters omitted

}
登录后复制
需要注意的是上述方式主要用于输入参数的有效性检查而非实际业务逻辑操作；如果目的是在整个应用程序范围内统一处理所有 BigDecimal 字段的显示格式，则可能更倾向于采用全局配置的方式，例如设置视图层模板引擎中的默认格式化选项或是数据库查询结果集映射时指定列格式等措施。