一、价格校验的核心需求与挑战

在电商、金融等系统中，价格字段的校验涉及货币精度、范围限制、业务规则等多维度约束。传统的手动校验存在代码冗余、维护困难、易遗漏边界条件等问题。Java Validation框架通过注解驱动的方式，将校验逻辑与业务代码解耦，提供声明式的校验方案。

价格校验的典型场景包括：

• 基础格式校验（如货币符号、小数位数）
• 数值范围限制（如最低价、最高价）
• 业务规则校验（如折扣后价格不能低于成本价）
• 组合校验（如不同会员等级对应不同价格区间）

二、Java Validation基础实现

1. 依赖配置

使用Hibernate Validator（JSR-380实现）需添加Maven依赖：

<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>8.0.1.Final</version>
</dependency>
<dependency>
    <groupId>org.glassfish</groupId>
    <artifactId>jakarta.el</artifactId>
    <version>4.0.2</version>
</dependency>

2. 基础注解应用

public class Product {
    @NotNull(message = "价格不能为空")
    @DecimalMin(value = "0.01", message = "价格必须大于0")
    @Digits(integer = 10, fraction = 2, message = "价格最多10位整数，2位小数")
    private BigDecimal price;
    // getters/setters
}

• @NotNull：确保字段非空
• @DecimalMin：设置最小值（包含边界）
• @Digits：控制整数和小数位数

3. 自定义校验注解

对于复杂业务规则（如价格必须为0.99结尾），可创建自定义注解：

@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = PriceEndsWithValidator.class)
public @interface PriceEndsWith {
    String message() default "价格必须以.99结尾";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}
public class PriceEndsWithValidator implements ConstraintValidator<PriceEndsWith, BigDecimal> {
    @Override
    public boolean isValid(BigDecimal value, ConstraintValidatorContext context) {
        if (value == null) return true; // 交由@NotNull处理
        return value.remainder(new BigDecimal("1.00"))
                   .compareTo(new BigDecimal("0.99")) == 0;
    }
}

三、进阶校验场景实现

1. 动态范围校验

根据业务规则动态调整价格范围：

public class DynamicPriceValidator implements ConstraintValidator<DynamicPriceRange, BigDecimal> {
    private BigDecimal min;
    private BigDecimal max;
    @Override
    public void initialize(DynamicPriceRange constraintAnnotation) {
        // 可从数据库或配置文件加载动态值
        this.min = constraintAnnotation.min();
        this.max = constraintAnnotation.max();
    }
    @Override
    public boolean isValid(BigDecimal value, ConstraintValidatorContext context) {
        if (value == null) return true;
        return value.compareTo(min) >= 0 && value.compareTo(max) <= 0;
    }
}
// 使用示例
@DynamicPriceRange(min = "10.00", max = "1000.00")
private BigDecimal price;

2. 组合校验（Group序列）

处理不同业务场景下的校验规则：

public interface ValidationGroups {
    interface Create {}
    interface Update {}
}
public class Product {
    @NotNull(groups = ValidationGroups.Create.class)
    @Null(groups = ValidationGroups.Update.class)
    private Long id;
    @DecimalMin(value = "1.00", groups = ValidationGroups.Create.class)
    @DecimalMin(value = "0.01", groups = ValidationGroups.Update.class)
    private BigDecimal price;
}
// 校验时指定组
Validator validator = Validation.buildDefaultValidatorFactory().getValidator();
Set<ConstraintViolation<Product>> violations = validator.validate(product, ValidationGroups.Create.class);

3. 跨字段校验

校验价格与折扣的关联关系：

public class DiscountRule {
    @AssertTrue(message = "折扣后价格不能低于成本价")
    public boolean isPriceValid() {
        return discountPrice.compareTo(costPrice.multiply(new BigDecimal("0.9"))) >= 0;
    }
}

四、最佳实践与性能优化

1. 校验性能优化

• 对高频校验字段使用@FastValidation注解（自定义实现）
• 批量校验时使用Validator.validateAll()方法
• 缓存Validator实例（线程安全）

2. 错误消息国际化

# messages.properties
PriceEndsWith.message=价格必须以.99结尾
DecimalMin.price=价格不能低于{value}
# 代码中使用
ConstraintValidatorContext context = ...;
context.buildConstraintViolationWithTemplate("{PriceEndsWith.message}")
       .addConstraintViolation();

3. 与Spring框架集成

@RestController
public class ProductController {
    @PostMapping
    public ResponseEntity<?> createProduct(@Valid @RequestBody Product product) {
        // 自动触发校验
    }
}

五、常见问题解决方案

1. BigDecimal比较问题

避免直接使用equals()方法，改用compareTo()：

@AssertTrue(message = "价格必须为正数")
public boolean isPositive() {
    return price.compareTo(BigDecimal.ZERO) > 0;
}

2. 校验顺序控制

通过@GroupSequence控制校验顺序：

@GroupSequence({Default.class, PriceCheck.class, FinalCheck.class})
public class Product {
    // ...
}

3. 异步校验实现

对于耗时校验（如调用第三方价格服务），可使用CompletableFuture：

public class AsyncPriceValidator implements ConstraintValidator<AsyncPriceCheck, BigDecimal> {
    @Override
    public boolean isValid(BigDecimal value, ConstraintValidatorContext context) {
        CompletableFuture<Boolean> future = CompletableFuture.supplyAsync(() -> {
            // 调用价格服务
            return priceService.checkValid(value);
        });
        try {
            return future.get(500, TimeUnit.MILLISECONDS);
        } catch (Exception e) {
            context.disableDefaultConstraintViolation();
            context.buildConstraintViolationWithTemplate("价格校验超时")
                   .addConstraintViolation();
            return false;
        }
    }
}

六、完整示例代码

public class PriceValidationDemo {
    public static void main(String[] args) {
        ValidatorFactory factory = Validation.buildDefaultValidatorFactory();
        Validator validator = factory.getValidator();
        Product product = new Product();
        product.setPrice(new BigDecimal("199.99"));
        product.setCostPrice(new BigDecimal("150.00"));
        Set<ConstraintViolation<Product>> violations = validator.validate(product);
        violations.forEach(v -> System.out.println(v.getMessage()));
    }
}
class Product {
    @NotNull
    @PriceEndsWith
    @DynamicPriceRange(min = "10.00", max = "1000.00")
    private BigDecimal price;
    @DecimalMin("0.01")
    private BigDecimal costPrice;
    @AssertTrue(message = "折扣后价格不能低于成本价")
    public boolean isDiscountValid() {
        return price.compareTo(costPrice.multiply(new BigDecimal("0.8"))) >= 0;
    }
    // getters/setters
}

通过系统化的价格校验实现，开发者可以构建出既满足业务需求又易于维护的校验体系。实际项目中建议结合Spring Validation的自动校验机制，并针对高性能场景进行针对性优化。