OVAL验证框架帮助文档

OVAL验证框架帮助文档
java开源验证框架oval，功能非常强大，使用简单；现在整理帮助文档供大家参考，希望能得到更多的反馈和使用经验。

1.  注解说明
1.1、  @Assert
Check if evaluating the expression in thespecified expression language returns true.

检查指定语言的表达式返回值是否为true；这里表达式是groovy。

参数

说明

expr

表达式

lang

指明脚本语言

errorCode

错误编码（共有属性）

（可以修改成自己的异常编码串）

net.sf.oval.constraint.Assert（默认值）

message

错误描述（共有属性）

when

前置条件（共有属性）

 

 

示例：下面验证登录名必须是用户名或用户编码; when表示前置条件;

@Assert(expr="_value==_this.userName || _value ==_this.userCode" ,

lang="groovy",message="login name error." , ,when="groovy:_this.status>0")

private String loginName;

private int status;

 

1.2、   @AssertFalse、@AssertTrue，@AssertNull
主要参数when、errorCode、message

Check if the value is false. (检查值是否为假或真)

 

Note: Thisconstraint is also satisfied when the value to validate is null, therefore youmight also need to specified @NotNull

该验证当值为null时也满足；当然我们可以结合@NotNull来使用；

@AssertTrue的说明如下，与上面一致，不再翻译；

Check if the value is true.

 

Note: Thisconstraint is also satisified when the value to validate is null, therefore youmight also need to specified @NotNull

 

@AssertNull说明：Check if null. 与@NotNull相反；

1.3、  @AssertURL
参数

说明

connect(boolean)

Specifies if a connection to the URL should be attempted to verify its validity.

是否发起连接进行尝试；

 

Check if the value is a valid URL. (检查值是否为有效的URL)

 

Note: Thisconstraint is also satisfied when the value to validate is null, therefore youmight also need to specified @NotNull

 

1.4、  @CheckWith
参数

说明

Class<? extendsCheckWithCheck.SimpleCheck>

value

          Check class to use for validation.

指明验证类

ignoreIfNull        

 this constraint will be ignored if the value to check is null

说明：

Check the value by a method of the sameclass that takes the value as argument and returns true if valid and false ifinvalid.

使用net.sf.oval.constraint.CheckWithCheck.SimpleCheck实现该接口的类中isSatisfied方法来判断，返回true有效，false无效；如果实现类是内部的，必须为静态类。

 

示例：验证User类中的age字段

@CheckWith(value=CheckAge.class,message="agemust in (18~65)")

private int age;

 

验证类如下：

publicclass CheckAge implements CheckWithCheck.SimpleCheck {
    private static final long serialVersionUID =1L;

 

    @Override

    public boolean isSatisfied(ObjectvalidatedObject, Object value) {
        User user = (User)validatedObject;

        int age = user.getAge();

       

        if(age <18 || age > 65)

            return false;

        else

            return true;

    }

}

 

 

1.5、  @DateRange、@Future、@Past
参数

说明

min

         /**

          * The upper date compared against in the format specified with the dateFormat parameter.

          * If not specified then no upper boundary check is performed.<br>

          * Special values are:

          * <ul>

          * <li><code>now</code>

          * <li><code>today</code>

          * <li><code>yesterday</code>

          * <li><code>tomorrow</code>

          * </ul>

          */

max     

         /**

          * The lower date compared against in the format specified with the dateFormat parameter.

          * If not specified then no lower boundary check is performed.<br>

          * Special values are:

          * <ul>

          * <li><code>now</code>

          * <li><code>today</code>

          * <li><code>yesterday</code>

          * <li><code>tomorrow</code>

          * </ul>

          */

 

 

Check if the date is within the a daterange.

Note: This constraint is also satisfied when the value to validate isnull, therefore you might also need to specified @NotNull

 

示例：字符串类型一样可以；

@Future(message="date isfuture.") 不能验证字符串，改用自定义类型@CFuture

@Past(message="date is past.")    不能验证字符串，改用自定义类型@CPast

 

@DateRange可以验证字符串类型，请查看源码验证

@DateRange(min="2010-10-01",max="now",message="dateis error.")

private String birthday;

1.6、  @Email
Check if the value is a valid e-mailaddress. The check is performed based on a regular expression.

 

Note: Thisconstraint is also satisfied when the value to validate is null, therefore youmight also need to specified @NotNull

示例：

@Email(message="email is error.")

private String email;

 

1.7、  @EqualToField，@Not EqualToField
参数

说明

boolean useGetter

useGetter default false;

 

 

Check if value equals the value of thereferenced field.

 

Note: Thisconstraint is also satisfied when the value to validate is null, therefore youmight also need to specified @NotNull

 

示例：检查userCode是否和userName相等；使用get方法。

 

@EqualToField(value="userName",message="mustequals userName",useGetter=true)

private String userCode;

 

示例与上面相反；

@NotNull(message="not null")

@NotEqualToField(value="userCode",message="can'tequals userCode")

private String userName;

 

1.8、  @HasSubstring
参数

说明

value

需要给的子串

 

ignoreCase（boolean）

ignoreCase default false;

 

Check if the string contains a certainsubstring.

 

Note: Thisconstraint is also satisfied when the value to validate is null, therefore youmight also need to specified @NotNull

 

示例：

         @HasSubstring(value="san",ignoreCase=true,message="mustcontains 'san'")

         privateString userCode;

 

1.9、   @Length，@MaxLength，@MinLength
参数

说明

max

最大长度，默认为：Integer.MAX_VALUE

 

min

默认值为0

@MaxLength和 @MinLength只有value属性；表示和value进行比较；

min和max是@length的属性；

Checkif the string representation has certain length. 检查字符串的长度

 

Note: Thisconstraint is also satisfied when the value to validate is null, therefore youmight also need to specified @NotNull

 

示例：检查长度，汉字算一个;

@Length(max=10,message="最大长度不能超过10")

private String code;

 

源码逻辑参考：

final int len =valueToValidate.toString().length();

return len >= min && len <=max;

 

 

 

1.10、          @Size、@MinSize、@MaxSize
参数

说明

max

 

min

 

@MaxSize 和 @MinSize只有value属性；表示和value进行比较，判断array,map, or collection大小；

min和max是@size的属性；

 

Check if the array,map, or collection has the given size. For objects of other types thelength of their String representation will be checked. 检查array、map或集合的大小；其他类型的对象检查对应字符串的长度；建议字符长度使用@Length验证。

 

Note: Thisconstraint is also satisfied when the value to validate is null, therefore youmight also need to specified @NotNull

 

 

1.11、          @MemberOf、@NotMemberOf
参数

说明

value 字符串数组

 

ignoreCase

默认值false

 

Check if the string representation iscontained in the given string array.

检查值是否包含在给定的数组中；@NotMemberOf实现相反效果；

 

Note: This constraint is also satisfiedwhen the value to validate is null, therefore you might also need to specified@NotNull

 

1.12、          @NotBlank、@NotNull、@NotEmpty
参数

说明

NotBlank

Check if the string representation is not empty and does not only contain white spaces.

NotNull

Check if not null.

NotEmpty

Check if the string representation is not empty ("").

 

没有其他特殊属性

 

 

1.13、          @NotNegative
Check if the number is greater or equalzero. 检查值是否为非负数

 

Note: Thisconstraint is also satisfied when the value to validate is null, therefore youmight also need to specified @NotNull

 

1.14、          @Digits、@Range、@Max、@Min
@Range 有max和min 属性，检查数值类型的范围；

Check if the number is in the given range.（和Double进行比较）

@Min

Check if the number is greater than orequal to X.

@Max

Check if the number is smaller than orequal to X.

 

@Digits

Check if the String representation has thegiven max/min number of integral and fractional digits.

检查字符串形式的数字范围，对应属性如下

maxFraction = Integer.MAX_VALUE;

maxInteger = Integer.MAX_VALUE;

minFraction = 0;

minInteger = 0;

 

1.15、          @NotMatchPatternCheck，@MatchPatternCheck
Check if the specified regular expressionpattern is or not matched. 正则表达式验证

 

Note: Thisconstraint is also satisfied when the value to validate is null, therefore youmight also need to specified @NotNull

 

参数

说明

pattern

          The regular expression(s) that must match or not match

示例：

1.16、          @ValidateWithMethod
Check the value by a method of the sameclass that takes the value as argument and returns true if valid and false ifinvalid.

验证值作为参数，使用同一个类的某个方法返回值的布尔值进行验证；

方法必须是和验证值在同一类中。

 

参数

说明

methodName

String

name a the single parameter method to use for validation

         

Class<?>          parameterType

type of the method parameter 方法的参数，及被验证值的类型

 

2.  使用总结
总结说明针对不同场景的主要使用那些注解。

2.1.          字符类型
@AsserURL、@Email、@Length、@MaxLength、@MinLength

@NotNull、@NotBlank、@NotEmpty、

@Digits、@HasSubstring

2.2.          数值类型
@Range、@Max、@Min、@NotNegative

2.3.          布尔类型
@AssertFalse、@AssertTrue

2.4.          集合数组
@Size、@MaxSize、@MinSize、@MemberOf、@NotMemberOf

2.5.          表达式或自定义
@Assert、@CheckWith、@NotMatchPatternCheck，@MatchPatternCheck、

@ValidateWithMethod

 

3.  自定义注解
@Past和@Future不能验证字符串类型的日期；自定义@CPast和@CFuture，都提供要给参数指定日期格式，默认为：yyyy-MM-dd;

 

3.1             定义注解
 

@Retention(RetentionPolicy.RUNTIME)

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

@Constraint(checkWith = CPastCheck.class)

public @interface CPast {
 

         Stringmessage()    default "日期必须小于现在.";

         StringdateFormat() default "yyyy-MM-dd";

}

3.2             定义实现
 

public class CPastCheck extends AbstractAnnotationCheck<CPast> {
         private static final longserialVersionUID = 1L;

         private StringdateFormat;

 

         public voidconfigure(final CPast constraintAnnotation) {
                   super.configure(constraintAnnotation);

                   setDateFormat(constraintAnnotation.dateFormat());

         }

 

         public booleanisSatisfied(Object validatedObject, Object valueToValidate,

                            OValContextcontext, Validator validator) throws OValException {
                   SimpleDateFormatsdf = new SimpleDateFormat(dateFormat);

 

                   if(valueToValidate instanceof String) {
                            try {
                                     Datedate = sdf.parse((String) valueToValidate);

                                     returndate.before(new Date());

                            }catch (ParseException e) {
                                     e.printStackTrace();

                                     super.setMessage("日期格式错误,无法验证,请修改成正确格式.");

                                     returnfalse;

                            }

                   }

                   return false;

         }

 

         public StringgetDateFormat() {
                   returndateFormat;

         }

 

         public voidsetDateFormat(String dateFormat) {
                   this.dateFormat= dateFormat;

         }

}

 

4.  记录点滴
总结验证规则，可以在设计时进行定义，自动生成对应的验证语句，提高开发效率；和js验证框架进行结合，实现web开发前后台验证设计保持一致，统一生成代码；
————————————————

原文链接：https://blog.csdn.net/neweastsun/article/details/49154337/