javascript
JSR 303 - Bean Validation 简介及使用方法
前些天發(fā)現(xiàn)了一個(gè)巨牛的人工智能學(xué)習(xí)網(wǎng)站,通俗易懂,風(fēng)趣幽默,忍不住分享一下給大家。點(diǎn)擊跳轉(zhuǎn)到教程。
一、JSR-303簡(jiǎn)介
JSR-303 是 JAVA EE 6 中的一項(xiàng)子規(guī)范,叫做 Bean Validation,官方參考實(shí)現(xiàn)是Hibernate Validator。
此實(shí)現(xiàn)與 Hibernate ORM 沒(méi)有任何關(guān)系。 JSR 303 用于對(duì) Java Bean 中的字段的值進(jìn)行驗(yàn)證。?
Spring MVC 3.x 之中也大力支持 JSR-303,可以在控制器中對(duì)表單提交的數(shù)據(jù)方便地驗(yàn)證。?
注:可以使用注解的方式進(jìn)行驗(yàn)證
二、準(zhǔn)備校驗(yàn)時(shí)使用的JAR
validation-api-1.0.0.GA.jar:JDK的接口;?
hibernate-validator-4.2.0.Final.jar是對(duì)上述接口的實(shí)現(xiàn);?
log4j、slf4j、slf4j-log4j
三、JSR 303 基本的校驗(yàn)規(guī)則
空檢查?
@Null 驗(yàn)證對(duì)象是否為null?
@NotNull 驗(yàn)證對(duì)象是否不為null, 無(wú)法查檢長(zhǎng)度為0的字符串?
@NotBlank 檢查約束字符串是不是Null還有被Trim的長(zhǎng)度是否大于0,只對(duì)字符串,且會(huì)去掉前后空格.?
@NotEmpty 檢查約束元素是否為NULL或者是EMPTY.
Booelan檢查?
@AssertTrue 驗(yàn)證 Boolean 對(duì)象是否為 true?
@AssertFalse 驗(yàn)證 Boolean 對(duì)象是否為 false
長(zhǎng)度檢查?
@Size(min=, max=) 驗(yàn)證對(duì)象(Array,Collection,Map,String)長(zhǎng)度是否在給定的范圍之內(nèi)?
@Length(min=, max=) Validates that the annotated string is between min and max included.
日期檢查?
@Past 驗(yàn)證 Date 和 Calendar 對(duì)象是否在當(dāng)前時(shí)間之前,驗(yàn)證成立的話被注釋的元素一定是一個(gè)過(guò)去的日期?
@Future 驗(yàn)證 Date 和 Calendar 對(duì)象是否在當(dāng)前時(shí)間之后 ,驗(yàn)證成立的話被注釋的元素一定是一個(gè)將來(lái)的日期?
@Pattern 驗(yàn)證 String 對(duì)象是否符合正則表達(dá)式的規(guī)則,被注釋的元素符合制定的正則表達(dá)式,regexp:正則表達(dá)式 flags: 指定 Pattern.Flag 的數(shù)組,表示正則表達(dá)式的相關(guān)選項(xiàng)。
數(shù)值檢查?
建議使用在Stirng,Integer類型,不建議使用在int類型上,因?yàn)楸韱沃禐椤啊睍r(shí)無(wú)法轉(zhuǎn)換為int,但可以轉(zhuǎn)換為Stirng為”“,Integer為null?
@Min 驗(yàn)證 Number 和 String 對(duì)象是否大等于指定的值?
@Max 驗(yàn)證 Number 和 String 對(duì)象是否小等于指定的值?
@DecimalMax 被標(biāo)注的值必須不大于約束中指定的最大值. 這個(gè)約束的參數(shù)是一個(gè)通過(guò)BigDecimal定義的最大值的字符串表示.小數(shù)存在精度?
@DecimalMin 被標(biāo)注的值必須不小于約束中指定的最小值. 這個(gè)約束的參數(shù)是一個(gè)通過(guò)BigDecimal定義的最小值的字符串表示.小數(shù)存在精度?
@Digits 驗(yàn)證 Number 和 String 的構(gòu)成是否合法?
@Digits(integer=,fraction=) 驗(yàn)證字符串是否是符合指定格式的數(shù)字,interger指定整數(shù)精度,fraction指定小數(shù)精度。?
@Range(min=, max=) 被指定的元素必須在合適的范圍內(nèi)?
@Range(min=10000,max=50000,message=”range.bean.wage”)?
@Valid 遞歸的對(duì)關(guān)聯(lián)對(duì)象進(jìn)行校驗(yàn), 如果關(guān)聯(lián)對(duì)象是個(gè)集合或者數(shù)組,那么對(duì)其中的元素進(jìn)行遞歸校驗(yàn),如果是一個(gè)map,則對(duì)其中的值部分進(jìn)行校驗(yàn).(是否進(jìn)行遞歸驗(yàn)證)?
@CreditCardNumber信用卡驗(yàn)證?
@Email 驗(yàn)證是否是郵件地址,如果為null,不進(jìn)行驗(yàn)證,算通過(guò)驗(yàn)證。?
@ScriptAssert(lang= ,script=, alias=)?
@URL(protocol=,host=, port=,regexp=, flags=)
四、案例分析
在使用的時(shí)候直接對(duì)JavaBean進(jìn)行注解既可以實(shí)現(xiàn)對(duì)屬性的驗(yàn)證
public class Order {// 必須不為 null, 大小是 10@NotNull@Size(min = 10, max = 10)private String orderId;// 必須不為空@NotEmptyprivate String customer;// 必須是一個(gè)電子信箱地址@Emailprivate String email;// 必須不為空@NotEmptyprivate String address;// 必須不為 null, 必須是下面四個(gè)字符串'created', 'paid', 'shipped', 'closed'其中之一// @Status 是一個(gè)定制化的 contraint@NotNull@Statusprivate String status;// 必須不為 null@NotNullprivate Date createDate;// 嵌套驗(yàn)證@Validprivate Product product;// getter 和setter方法 }?
又例:
?
@NotNull(message = "adultTax不能為空")private Integer adultTax;@NotNull(message = "adultTaxType不能為空")@Min(value = 0, message = "adultTaxType 的最小值為0")@Max(value = 1, message = "adultTaxType 的最大值為1")private Integer adultTaxType;@NotNull(message = "reason信息不可以為空")@Pattern(regexp = "[1-7]{1}", message = "reason的類型值為1-7中的一個(gè)類型")private String reason;//訂單取消原因?
五、下邊是一個(gè)完整的例子:
?
public class ValidateTestClass{@NotNull(message = "reason信息不可以為空")@Pattern(regexp = "[1-7]{1}", message = "reason的類型值為1-7中的一個(gè)類型")private String reason;//訂單取消原因//get、set方法、有參構(gòu)造方法、無(wú)參構(gòu)造方法、toString方法省略/*** 驗(yàn)證參數(shù):就是驗(yàn)證上述注解的完整方法* @return*/public void validateParams() {//調(diào)用JSR303驗(yàn)證工具,校驗(yàn)參數(shù)Validator validator = Validation.buildDefaultValidatorFactory().getValidator();Set<ConstraintViolation<ValidateTestClass>> violations = validator.validate(this);Iterator<ConstraintViolation<ValidateTestClass>> iter = violations.iterator();if (iter.hasNext()) {String errMessage = iter.next().getMessage();throw new ValidationException(errMessage);}} }?
?
?
我們可以寫(xiě)一個(gè)測(cè)試類進(jìn)行驗(yàn)證:
public class ValidateTestClassValidateTest{@Testpublic void validateParam(){ValidateTestClass validateTestClass = new ValidateTestClass();validateTestClass .setReason(12);validateTestClass .validateParams(); //調(diào)用驗(yàn)證的方法} }?
就可以進(jìn)行測(cè)試。
?
并且我們?cè)谑褂玫臅r(shí)候一定要注意,對(duì)于某一種驗(yàn)證規(guī)則是適用于一種數(shù)據(jù)類型的,簡(jiǎn)單說(shuō)來(lái),正則則表達(dá)式的驗(yàn)證對(duì)象可以為String類型的,但是不可以為Integer類型的數(shù)據(jù),那么當(dāng)我們使用正則表達(dá)式進(jìn)行驗(yàn)證的時(shí)候就會(huì)出現(xiàn)錯(cuò)誤。?
類似于:
javax.validation.UnexpectedTypeException: HV000030: No validator could be found for type: java.lang.Integer. at org.hibernate.validator.internal.engine.constraintvalidation.ConstraintValidatorManager.verifyResolveWasUnique(ConstraintValidatorManager.java:218)?
- ?
?
意思就是你這個(gè)驗(yàn)證的注解不應(yīng)該對(duì)該類型進(jìn)行注解。
到此OK。
?
總結(jié)
以上是生活随笔為你收集整理的JSR 303 - Bean Validation 简介及使用方法的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問(wèn)題。
- 上一篇: StrUtils 单元下的公用函数目录
- 下一篇: 非常恶俗地分享一首歌曲(童年·葫芦娃)