Hibernate Validator簡(jiǎn)介

Hibernate項(xiàng)目中不僅有ORM一個(gè)框架辟宗,這里介紹的是它的另一個(gè)框架Validator停撞,用來(lái)驗(yàn)證實(shí)體類(lèi)是否滿足需求赖欣。Validator實(shí)現(xiàn)了Java的一項(xiàng)標(biāo)準(zhǔn)Bean Validation邻悬。

如果使用Maven佩脊,就需要在pom.xml中添加如下一段蛙粘,Hibernate需要Java EL表達(dá)式,因此需要添加EL的依賴(lài)項(xiàng)威彰。

<dependency>
   <groupId>org.hibernate</groupId>
   <artifactId>hibernate-validator</artifactId>
   <version>5.3.4.Final</version>
</dependency>
<dependency>
   <groupId>javax.el</groupId>
   <artifactId>javax.el-api</artifactId>
   <version>2.2.4</version>
</dependency>
<dependency>
   <groupId>org.glassfish.web</groupId>
   <artifactId>javax.el</artifactId>
   <version>2.2.4</version>
</dependency>

如果使用Gradle出牧,需要將上面的依賴(lài)項(xiàng)轉(zhuǎn)換一下。

compile group: 'org.hibernate', name: 'hibernate-validator', version: '5.3.4.Final'
compile group: 'javax.el', name: 'javax.el-api', version: '3.0.1-b04'
compile group: 'org.glassfish.web', name: 'javax.el', version: '2.2.6'

添加依賴(lài)之后歇盼,就可以在實(shí)體類(lèi)中添加條件注解了舔痕。常用的幾個(gè)注解如下:

注解 作用
AssertTrue 布爾值為真
AssertFalse 布爾值為假
Null 引用為空
NotNull 引用不為空
NotEmpty 字符串引用和值都不是空
Min 數(shù)字的最小值
Max 數(shù)字的最大值
Past 日期必須是過(guò)去
Future 日期必須是未來(lái)
Pattern 字符串必須匹配正則表達(dá)式
Valid 遞歸驗(yàn)證引用
Size 驗(yàn)證字符串是否在Size范圍內(nèi)
Email 驗(yàn)證字符串是否是一個(gè)有效的電子郵箱
URL 字符串是否是一個(gè)有效的URL

需要注意最后兩個(gè)注解是Hibernate Validator自定義的,假如使用其他的Bean Validation實(shí)現(xiàn),可能沒(méi)有這兩個(gè)注解伯复。

下面向兩個(gè)實(shí)體類(lèi)添加了驗(yàn)證注解慨代,其他方法已經(jīng)省略了。和JPA注解一樣啸如,如果驗(yàn)證注解添加到字段上侍匙,Hibernate就會(huì)直接讀取字段的值。如果注解到Getter方法上叮雳,Hibernate就會(huì)調(diào)用方法取得值想暗。在一個(gè)類(lèi)中不要同時(shí)應(yīng)用這兩種方式,會(huì)導(dǎo)致重復(fù)驗(yàn)證的問(wèn)題帘不。如果在一個(gè)集合上應(yīng)用Valid注解说莫, Hibernate就會(huì)遞歸驗(yàn)證集合中的每一個(gè)元素。

public class Author {
    @NotNull
    @Size(min = 6, max = 15)
    @Pattern(regexp = "([a-zA-Z]+\d*)+")
    private String username;
    @NotNull
    @Size(min = 6, max = 20)
    private String password;
    @NotNull
    private String nickname;
    @Email
    private String email;
    @Min(0)
    private int age;
    @Size(max = 500)
    private String address;
    @Past
    @NotNull
    private Date birthday;
    @Valid
    @NotNull
    private List<Article> articles = new ArrayList<>();
}
public class Article {
    @NotNull
    private String title;
    @NotNull
    private String content;
    @NotNull
    private Author author;
    @Past
    private Date createTime;
    @Past
    private Date modifyTime;
}

向?qū)嶓w類(lèi)添加了驗(yàn)證注解之后厌均,我們就可以開(kāi)始驗(yàn)證了唬滑。首先需要構(gòu)造一個(gè)ValidatorFactory,然后使用構(gòu)造出的ValidatorFactory生成一個(gè)Validator棺弊,然后調(diào)用這個(gè)Validator的validate方法晶密,就可以驗(yàn)證實(shí)體類(lèi)了。validate方法會(huì)返回一個(gè)Set<ConstraintViolation>模她,每一個(gè)ConstraintViolation都是一個(gè)驗(yàn)證結(jié)果稻艰,如果實(shí)體類(lèi)沒(méi)有錯(cuò)誤,那么這個(gè)集合的大小就是0侈净,表示驗(yàn)證通過(guò)尊勿。如果存在錯(cuò)誤,我們就可以通過(guò)這個(gè)集合來(lái)查看存在什么錯(cuò)誤畜侦。

public class ValidatorTest {
    private static ValidatorFactory factory;
    private static Validator validator;
    private static Logger logger;

    @BeforeClass
    public static void init() {
        factory = Validation.buildDefaultValidatorFactory();
        validator = factory.getValidator();
        logger = LoggerFactory.getLogger(ValidatorTest.class);
    }

    @AfterClass
    public static void clean() {
        factory.close();
    }

    @Test
    public void testKindsOfErrors() {
        Author author = new Author();
        author.setUsername("123");
        author.setPassword("1234");
        author.setAddress("");
        author.setEmail("");
        author.setArticles(null);
        author.setAge(-20);
        Set<ConstraintViolation<Author>> set = validator.validate(author);
        for (ConstraintViolation<Author> c : set) {
            logger.info(c.toString());
        }
    }

    @Test
    public void testAllRight() {
        Author author = new Author();
        author.setUsername("yitian");
        author.setPassword("12345678");
        author.setAddress("");
        author.setNickname("");
        author.setEmail("yitian@yitian.com");
        author.setBirthday(new Date());
        Set<ConstraintViolation<Author>> set = validator.validate(author);
        for (ConstraintViolation<Author> c : set) {
            logger.info(c.toString());
        }
        Assert.assertEquals(0, set.size());
    }

    @Test
    public void testOneProperty() {
        Author author = new Author();
        author.setUsername("yitian");
        Set<ConstraintViolation<Author>> set = validator.validateProperty(author, "username");
        for (ConstraintViolation<Author> c : set) {
            logger.info(c.toString());
        }
    }

    @Test
    public void testCustomMessage() {
        Article article = new Article();
        LocalDate date = LocalDate.of(2099, 1, 1);
        article.setModifyTime(Date.from(date.atStartOfDay(ZoneId.systemDefault()).toInstant()));
        Set<ConstraintViolation<Article>> set = validator.validateProperty(article, "modifyTime");
        for (ConstraintViolation<Article> c : set) {
            logger.info(c.toString());
        }
    }
}

以上就是一個(gè)簡(jiǎn)單的驗(yàn)證的例子元扔。通過(guò)這個(gè)例子,大家應(yīng)該明白了Hibernate Validator的基本內(nèi)容旋膳。很多框架比如Spring也提供了相關(guān)的內(nèi)容澎语,能方便的將Hibernate Validator整合到項(xiàng)目中。如果希望了解更多信息验懊,可以查看一下它們的相關(guān)文檔擅羞。這里就起到一個(gè)拋磚引玉的作用。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末义图,一起剝皮案震驚了整個(gè)濱河市减俏,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌碱工,老刑警劉巖娃承,帶你破解...
    沈念sama閱讀 216,496評(píng)論 6 501
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件奏夫,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡草慧,警方通過(guò)查閱死者的電腦和手機(jī)桶蛔,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,407評(píng)論 3 392
  • 文/潘曉璐 我一進(jìn)店門(mén),熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)漫谷,“玉大人仔雷,你說(shuō)我怎么就攤上這事√蚴荆” “怎么了碟婆?”我有些...
    開(kāi)封第一講書(shū)人閱讀 162,632評(píng)論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)惕稻。 經(jīng)常有香客問(wèn)我竖共,道長(zhǎng),這世上最難降的妖魔是什么俺祠? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 58,180評(píng)論 1 292
  • 正文 為了忘掉前任公给,我火速辦了婚禮,結(jié)果婚禮上蜘渣,老公的妹妹穿的比我還像新娘淌铐。我一直安慰自己,他們只是感情好蔫缸,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,198評(píng)論 6 388
  • 文/花漫 我一把揭開(kāi)白布腿准。 她就那樣靜靜地躺著,像睡著了一般拾碌。 火紅的嫁衣襯著肌膚如雪吐葱。 梳的紋絲不亂的頭發(fā)上,一...
    開(kāi)封第一講書(shū)人閱讀 51,165評(píng)論 1 299
  • 那天校翔,我揣著相機(jī)與錄音弟跑,去河邊找鬼。 笑死防症,一個(gè)胖子當(dāng)著我的面吹牛窖认,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播告希,決...
    沈念sama閱讀 40,052評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼烧给!你這毒婦竟也來(lái)了燕偶?” 一聲冷哼從身側(cè)響起,我...
    開(kāi)封第一講書(shū)人閱讀 38,910評(píng)論 0 274
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤础嫡,失蹤者是張志新(化名)和其女友劉穎指么,沒(méi)想到半個(gè)月后酝惧,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,324評(píng)論 1 310
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡伯诬,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,542評(píng)論 2 332
  • 正文 我和宋清朗相戀三年晚唇,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片盗似。...
    茶點(diǎn)故事閱讀 39,711評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡哩陕,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出赫舒,到底是詐尸還是另有隱情悍及,我是刑警寧澤,帶...
    沈念sama閱讀 35,424評(píng)論 5 343
  • 正文 年R本政府宣布接癌,位于F島的核電站心赶,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏缺猛。R本人自食惡果不足惜缨叫,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,017評(píng)論 3 326
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望荔燎。 院中可真熱鬧耻姥,春花似錦、人聲如沸湖雹。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 31,668評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)摔吏。三九已至鸽嫂,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間征讲,已是汗流浹背据某。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 32,823評(píng)論 1 269
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留诗箍,地道東北人癣籽。 一個(gè)月前我還...
    沈念sama閱讀 47,722評(píng)論 2 368
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像滤祖,于是被迫代替她去往敵國(guó)和親筷狼。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,611評(píng)論 2 353

推薦閱讀更多精彩內(nèi)容