@DecimalMin 浮点数最小值验证

该注解用于验证一个数字是否大于或等于指定的最小值。具体来说，@DecimalMin 注解可以用于验证浮点数、双精度数或它们的包装类是否大于或等于指定的最小值。

在使用 @DecimalMin 注解时，你需要指定一个 value 参数，表示所需的最小值。你还可以选择指定一个 inclusive 参数，来指定验证时是否包含等于最小值的情况。默认情况下，inclusive 参数为 true，表示包含等于最小值的情况。

支持的类型有：

• BigDecimal

• BigInteger

• CharSequence

• byte, short, int, long, 和它们的包装类型

注意，由于四舍五入存在误差，因此不支持 double 和 float（某些提供商可能会提供近似支持）。如果字段的值为 null，则将被视为有效。源码如下：

@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })
@Retention(RUNTIME)
@Documented
@Constraint(validatedBy = { })
public @interface DecimalMin {
    String message() default "{javax.validation.constraints.DecimalMin.message}";
    Class<?>[] groups() default { };
    Class<? extends Payload>[] payload() default { };
    
    // 根据 BigDecimal 字符串表示法，最小值的字符串表示。
    String value();
    
    // 指定最小值是包含型还是排除型。默认为包含型。
    // true 字段的值必须大于等于指定的最小值
    // false 字段的值必须大于指定的最小值
    boolean inclusive() default true;
    
    // 在同一元素上定义多个 @DecimalMin 注解。
    @Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })
    @Retention(RUNTIME)
    @Documented
    @interface List {
        DecimalMin[] value();
    }
}

注意：message、groups、payload 属性用法参考 @NotNull 注解。

java 广告位

示例：

package com.hxstrive.validation;

import lombok.Builder;
import lombok.Data;
import org.hibernate.validator.HibernateValidator;

import javax.validation.ConstraintViolation;
import javax.validation.Validation;
import javax.validation.Validator;
import javax.validation.constraints.DecimalMin;
import java.util.Set;

/**
 * 注解元素必须是一个数字，且大于等于最小值
 * @author hxstrive.com
 */
@Data
@Builder
public class DecimalMinDemo {

   @DecimalMin(value = "0.1", message = "年龄必须大于等于0.1")
   private Float age;

   public static void main(String[] args) {
       DecimalMinDemo.builder().age(null).build().validator("case1"); // OK
       DecimalMinDemo.builder().age(0f).build().validator("case2"); // Fail
       DecimalMinDemo.builder().age(0.1f).build().validator("case3"); // OK
       DecimalMinDemo.builder().age(-1f).build().validator("case4"); // Fail
   }

   private void validator(String caseName) {
       validator(caseName, this);
   }

   private <T> void validator(String caseName, T obj) {
       // 手动调用 API 对定义了注解的字段进行校验
       Validator validator = Validation.byProvider(HibernateValidator.class).configure()
               .failFast(true).buildValidatorFactory().getValidator();
       Set<ConstraintViolation<T>> set = validator.validate(obj);
       if (set.size() > 0) {
           // 校验失败
           System.out.println(caseName + " :: Fail :: " + set.iterator().next().getMessage());
       } else {
           // 校验通过
           System.out.println(caseName + " :: Succeed");
       }
   }

}

运行示例，输出如下：

case1 :: Succeed
case2 :: Fail :: 年龄必须大于等于0.1
case3 :: Succeed
case4 :: Fail :: 年龄必须大于等于0.1