SpringBoot工程实践：对请求参数进行校验Validated-自定义校验注解

/**
 * The annotated element size must be between the specified boundaries (included).
 * <p>
 * Supported types are:
 * <ul>
 *     <li>{@code CharSequence} (length of character sequence is evaluated)</li>
 *     <li>{@code Collection} (collection size is evaluated)</li>
 *     <li>{@code Map} (map size is evaluated)</li>
 *     <li>Array (array length is evaluated)</li>
 * </ul>
 * <p>
 * {@code null} elements are considered valid.
 *
 * @author Emmanuel Bernard
 */
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE })
@Retention(RUNTIME)
@Repeatable(List.class)
@Documented
@Constraint(validatedBy = { })
public @interface Size {

@Validated
public interface UserService {

    ApiResult getByName(@NotBlank(message = "用户名不能为空") @Length(min = 1, max = 8, message = "用户名长度不符") String name);

    ApiResult getByAge(@Min(value = 1, message = "年龄起始范围不正确") Integer ageFrom, @Max(value = 150, message = "年龄结束范围不正确") Integer ageTo);

    ApiResult getByEmail(@Email(message = "邮箱格式不正确") String email);
}

@Validated
public interface UserService {

    ApiResult save(@Validated UserDTO userDTO);

    ApiResult update(@Valid UserDTO userDTO);

}


@Data
public class UserDTO {

    private Long id;

    /**
     * 根据正则校验手机号是否是由数字组成
     */
    @Pattern(regexp = "^\\d{11}$", message = "手机格式不正确,不是11位")
    private String telephone;

    /**
     * 校验该对象是否为null
     * 对于String来说，空字符串可通过校验，所以String应该使用@NotBlank进行校验，此处仅做示例而已。
     */
    @NotNull(message = "联系人不能为空")
    private String friendName;

    /**
     * 校验对象是否是空对象，可用于Array,Collection,Map,String
     */
    @NotEmpty(message = "家庭成员不能为空")
    private List families;

    /**
     * 校验长度，可以用于Array,Collection,Map,String
     */
    @Size(min = 4, max = 8, message = "用户名长度错误 by size")
    /**
     * 校验长度，只能用于String
     */
    @Length(min = 4, max = 8, message = "用户名长度错误 by length")
    private String username;

    /**
     * javax校验
     */
    @Max(value = 200, message = "年龄一般不会超过200 by max")
    @Min(value = 1, message = "年龄一般不能小于1 by min")
    /**
     * hibernate校验，效果等同
     */
    @Range(min = 0, max = 200, message = "年龄范围在0-200之间 by range")
    private Integer age;

    /**
     * 校验参数是否是False, 相反的是@AssertTrue
     */
    @AssertFalse(message = "用户初始化无需冻结")
    private Boolean lock;

    /**
     * String专用
     */
    @NotBlank(message = "密码不能为空")
    @Size(min = 6, max = 12, message = "密码长度不对")
    private String password;

    /**
     * 时间必需是过去的时间
     */
    @Past(message = "生日只能为以前的时间")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm")
    private LocalDateTime birth;

    /**
     * 校验Email
     */
    @Email(message = "邮件地址不正确")
    private String email;

}

public interface SaveValidateGroup extends Default {}

public interface UpdateValidateGroup extends Default {}

@Validated
public interface UserService {
    
    ApiResult save(@Validated(value = SaveValidGroup.class) UserDTO userDTO);

    ApiResult update(@Validated(value = UpdateValidGroup.class) UserDTO userDTO);

}

@Data
public class UserDTO {

    @Null(message = "用户ID不为空", groups = SaveValidGroup.class)
    @NotNull(message = "用户ID为空", groups = UpdateValidGroup.class)
    private Long id;
    
}