JSR 303 - Bean Validation 模型验证

类是转载的，不知道转的哪里的。

此类依赖 JSR 303 – Bean Validation， Hibernate Validator。

代码不能直接运行。意会一下。自己改改。

import com.google.common.base.Preconditions;

import com.google.common.collect.Lists;

import com.google.common.collect.Maps;

import com.mmall.exception.ParamException;

import org.apache.commons.collections.MapUtils;

import javax.validation.ConstraintViolation;

import javax.validation.Validation;

import javax.validation.Validator;

import javax.validation.ValidatorFactory;

import java.util.*;

public class BeanValidator {

    private static ValidatorFactory validatorFactory = Validation.buildDefaultValidatorFactory();

    public static <T> Map<String, String> validate(T t, Class... groups) {

        Validator validator = validatorFactory.getValidator();

        Set validateResult = validator.validate(t, groups);

        if (validateResult.isEmpty()) {

            return Collections.emptyMap();

        } else {

            LinkedHashMap errors = Maps.newLinkedHashMap();

            Iterator iterator = validateResult.iterator();

            while (iterator.hasNext()) {

                ConstraintViolation violation = (ConstraintViolation)iterator.next();

                errors.put(violation.getPropertyPath().toString(), violation.getMessage());

            }

            return errors;

        }

    }

    public static Map<String, String> validateList(Collection<?> collection) {

        Preconditions.checkNotNull(collection);

        Iterator iterator = collection.iterator();

        Map errors;

        do {

            if (!iterator.hasNext()) {

                return Collections.emptyMap();

            }

            Object object = iterator.next();

            errors = validate(object, new Class[0]);

        } while (errors.isEmpty());

        return errors;

    }

    public static Map<String, String> validateObject(Object first, Object... objects) {

        if (objects != null && objects.length > 0) {

            return validateList(Lists.asList(first, objects));

        } else {

            return validate(first, new Class[0]);

        }

    }

    public static void check(Object param) throws ParamException {

        Map<String, String> map = BeanValidator.validateObject(param);

        if (MapUtils.isNotEmpty(map)) {

            throw new ParamException(map.toString());

        }

    }

}

校验注解

空检查

@Null：限制只能为 null
@NotNull：限制不能为 null
@NotEmpty：不为 null 且不为空（字符串长度不为0、集合大小不为0）
@NotBlank：不为空（不为 null、去除首位空格后的长度为0，与@NotEmpty不同的是字符串比较时会去除字符串的空格）

Boolean检查

@AssertFalse：限制必须为false
@AssertTrue：限制必须为true

长度检查

@Size（max，min）：限制长度必须在 min 到 max 之间
@Length(min=,max=)：长度在 min 到 max 之间

日期检查

@Past：验证注解的元素值（日期类型）比当前时间早
@Future：限制必须为一个将来的日期
@Pattern（value）：限制必须符合制定的正则表达式

数值检查

@Max（value）：限制必须为一个大于指定值的数字
@Min（value）：限制必须为一个小于指定值的数字
@DecimalMax（value）：限制必须为一个大于指定值的数字
@DecimalMin（value）：限制必须为一个小于指定值的数字
@Range(min=, max=) ：数值在 min 到 max 之间
@Digits（integer，fraction）：限制必须为一个小数，整数部分位数不能超过integer，小数部分不能超过 fraction

其它检查

@Email：验证元素的值时Email
@URL(protocol=,host=, port=,regexp=, flags=)：请求地址、端口、主机检查

作者：林塬
链接：https://www.jianshu.com/p/f85c248294f6
來源：简书
简书著作权归作者所有，任何形式的转载都请联系作者获得授权并注明出处。

下面是具体的规范

Bean Validation 中的 constraint

表 1. Bean Validation 中内置的 constraint

Constraint	详细信息
`@Null`	被注释的元素必须为 `null`
`@NotNull`	被注释的元素必须不为 `null`
`@AssertTrue`	被注释的元素必须为 `true`
`@AssertFalse`	被注释的元素必须为 `false`
`@Min(value)`	被注释的元素必须是一个数字，其值必须大于等于指定的最小值
`@Max(value)`	被注释的元素必须是一个数字，其值必须小于等于指定的最大值
`@DecimalMin(value)`	被注释的元素必须是一个数字，其值必须大于等于指定的最小值
`@DecimalMax(value)`	被注释的元素必须是一个数字，其值必须小于等于指定的最大值
`@Size(max, min)`	被注释的元素的大小必须在指定的范围内
`@Digits (integer, fraction)`	被注释的元素必须是一个数字，其值必须在可接受的范围内
`@Past`	被注释的元素必须是一个过去的日期
`@Future`	被注释的元素必须是一个将来的日期
`@Pattern(value)`	被注释的元素必须符合指定的正则表达式

表 2. Hibernate Validator 附加的 constraint

Constraint	详细信息
`@Email`	被注释的元素必须是电子邮箱地址
`@Length`	被注释的字符串的大小必须在指定的范围内
`@NotEmpty`	被注释的字符串的必须非空
`@Range`	被注释的元素必须在合适的范围内

定制化的 constraint

@Price是一个定制化的 constraint，由两个内置的 constraint 组合而成。

清单 4. @Price 的 annotation 部分

// @Max 和 @Min 都是内置的 constraint

@Max(10000)

@Min(8000)

@Constraint(validatedBy = {})

@Documented

@Target( { ElementType.ANNOTATION_TYPE, ElementType.METHOD, ElementType.FIELD })

@Retention(RetentionPolicy.RUNTIME)

public @interface Price {

String message() default "错误的价格";

Class<?>[] groups() default {};

Class<? extends Payload>[] payload() default {};

}

@Status是一个新开发的 constraint.

清单 5. @Status 的 annotation 部分

@Constraint(validatedBy = {StatusValidator.class})

@Documented

@Target( { ElementType.ANNOTATION_TYPE, ElementType.METHOD, ElementType.FIELD })

@Retention(RetentionPolicy.RUNTIME)

public @interface Status {

String message() default "不正确的状态 , 应该是 'created', 'paid', shipped', closed'其中之一";

Class<?>[] groups() default {};

Class<? extends Payload>[] payload() default {};

}

清单 6. @Status 的 constraint validator 部分

public class StatusValidator implements ConstraintValidator<Status, String>{

private final String[] ALL_STATUS = {"created", "paid", "shipped", "closed"};

public void initialize(Status status) {

}

public boolean isValid(String value, ConstraintValidatorContext context) {

if(Arrays.asList(ALL_STATUS).contains(value))

return true;

return false;

}

JRS 303 Bean Validation 转载看这里 https://www.ibm.com/developerworks/cn/java/j-lo-jsr303/