java标准--校验参数

以往在写接口实现的时候，经常会在方法的开始，对参数做各种判断，如：if (name == null){.......}

现在好了，JSR-303提供了一套标准的annotation，只要给参数加上诸如@NotNull的注解，一切就交给javax.validation的实现去做吧！常用的实现方案有hibernate-validation-4.2.0-Final。基本用法：

ValidationFactory vf = Validation.buildDefaultValidationFactory();

Validator validator = vf.getValidator();

Set<ConstraintViolation> constrains = validator.validate(javabean, groupClass);  //校验失败的一组信息

ConstraintViolation{

    getMessage()--返回提示信息，hibernate-validation会在jar里面的ValidationMessages_{Local}.properties中查找相关信息

    getRootBeanClass()--返回JavaBean类名

    getPropertyPath()--返回属性名

}

分组校验：为了使同一个Bean在不同场合校验不同的属性，默认是Default.class，也可以自己定义N个接口来作为分组。

分组序列(@GroupSequence=({Group1.class, Group2.class,.....}))：提示检验器按照顺序逐个进行（原本是无序的），一旦失败则终止后面的Group校验。

关联校验(@Valid)：标记此时要校验Bean里面的（Pojo或集合类）子对象。

可以为Validator注解的message，使用ResourceMessage属性文件来自定义Hints，只要在注解的时候message属性以"{}"括起。另：在属性文件中同样可以使用{min}来引用其他的属性值，如：user.username.length=用户名长度必须在{min}到{max}之间。

自定义validation的约束：

 @Constraint(validatedBy={BetweenValidator.class} )

interface @Between{

      //必须有以下三个方法

      String message() default "{data.between.message}";    //返回 ResourceMessage的key

      Class<?>[] group();

      Class<? extends Payload> payload();

      Number min();

      Number max();  

}

在这个类中需要使用 @Constraint指明使用哪个Validator来实现校验操作，其中：

public class BetweenValidator implements ConstraintValidator<Between, Double> {

@Override
public void initialize(Between constraintAnnotation) {

}

@Override
public boolean isValid(Double value, ConstraintValidatorContext context) {

}

}

-------------------------一些常用的注解

@AssertTrue //用于boolean字段，该字段只能为true  

@AssertFalse//该字段的值只能为false  

@CreditCardNumber//对信用卡号进行一个大致的验证  

@DecimalMax//只能小于或等于该值  

@DecimalMin//只能大于或等于该值  

@Digits(integer=2,fraction=20)//检查是否是一种数字的整数、分数,小数位数的数字。  

@Email//检查是否是一个有效的email地址  

@Future//检查该字段的日期是否是属于将来的日期  

@Length(min=,max=)//检查所属的字段的长度是否在min和max之间,只能用于字符串  

@Max//该字段的值只能小于或等于该值  

@Min//该字段的值只能大于或等于该值  

@NotNull//不能为null  

@NotBlank//不能为空，检查时会将空格忽略  

@NotEmpty//不能为空，这里的空是指空字符串  

@Null//检查该字段为空  

@Past//检查该字段的日期是在过去  

@Size(min=, max=)//检查该字段的size是否在min和max之间，可以是字符串、数组、集合、Map等  

@URL(protocol=,host,port)//检查是否是一个有效的URL，如果提供了protocol，host等，则该URL还需满足提供的条件