数组 javax.validation.constraints

### 在 `javax.validation.constraints` 中对数组应用约束条件 在 Java 的 Bean Validation API 中，`javax.validation.constraints` 包提供了一些内置的约束注解。这些注解可以用于验证对象属性的值是否符合特定规则。对于数组或集合类型的字段，可以通过以下几种方式应用约束条件： 1. **直接在数组上使用约束注解** 如果需要对数组中的每个元素进行验证，可以直接将约束注解应用到数组类型上。例如，`@NotNull`、`@Size` 等注解可以用于验证数组本身及其元素。 2. **嵌套验证** 如果数组中的元素是复杂对象（如自定义类），则可以通过级联验证机制来验证这些对象的属性。 #### 示例代码 以下是一个使用 `@Size` 和 `@NotNull` 注解验证数组的示例： ```java import javax.validation.constraints.NotNull; import javax.validation.constraints.Size; public class ArrayValidationExample { // 验证数组不能为空且长度必须在 1 到 5 之间 @Size(min = 1, max = 5, message = "Array size must be between 1 and 5") @NotNull(message = "Array cannot be null") private String[] stringArray; public String[] getStringArray() { return stringArray; } public void setStringArray(String[] stringArray) { this.stringArray = stringArray; } } ``` 上述代码中，`@Size` 和 `@NotNull` 被应用于 `stringArray` 字段，确保数组不为空且其长度在指定范围内[^1]。 3. **自定义约束校验器** 如果需要更复杂的验证逻辑，可以实现 `ConstraintValidator` 接口并编写自定义校验器。例如，验证数组中的每个元素是否符合正则表达式。 #### 自定义校验器示例 以下是一个验证数组中每个元素是否符合正则表达式的自定义校验器： ```java import javax.validation.Constraint; import javax.validation.Payload; import javax.validation.ReportAsSingleViolation; import javax.validation.ConstraintValidator; import javax.validation.ConstraintValidatorContext; import java.lang.annotation.*; import java.util.regex.Pattern; // 定义自定义注解 @Documented @Constraint(validatedBy = EncryptIdArrayValidator.class) @Target({ElementType.FIELD, ElementType.PARAMETER}) @Retention(RetentionPolicy.RUNTIME) @ReportAsSingleViolation public @interface ValidEncryptIdArray { String message() default "Invalid encrypt ID format in array"; Class<?>[] groups() default {}; Class<? extends Payload>[] payload() default {}; } // 实现 ConstraintValidator 接口 public class EncryptIdArrayValidator implements ConstraintValidator<ValidEncryptIdArray, String[]> { private static final Pattern PATTERN = Pattern.compile("^[a-f\\d]{6,8}$"); @Override public boolean isValid(String[] values, ConstraintValidatorContext context) { if (values == null) { return true; // 允许为 null } for (String value : values) { if (value != null) { Matcher matcher = PATTERN.matcher(value); if (!matcher.find()) { return false; } } } return true; } } ``` 在上述代码中，`@ValidEncryptIdArray` 是一个自定义注解，用于验证数组中的每个字符串是否符合正则表达式 `^[a-f\\d]{6,8}$`[^2]。 #### 使用自定义注解 将自定义注解应用到数组字段上： ```java public class CustomValidationExample { @ValidEncryptIdArray private String[] encryptIds; public String[] getEncryptIds() { return encryptIds; } public void setEncryptIds(String[] encryptIds) { this.encryptIds = encryptIds; } } ``` 通过这种方式，可以在数组级别应用复杂的验证逻辑。 ### 注意事项 - 如果需要对数组中的每个元素单独验证，可以结合 Hibernate Validator 提供的 `@Valid` 注解进行级联验证[^3]。 - 自定义校验器需要实现 `ConstraintValidator` 接口，并重写 `isValid` 方法以定义具体的验证逻辑。