AI实践哪家强?来 AICon, 解锁技术前沿,探寻产业新机! 了解详情
写点什么

Java EE 6 Bean Validation 提供了实体验证元数据模型与 API

  • 2010-03-20
  • 本文字数:2114 字

    阅读完需:约 7 分钟

在此前发布的 Java Enterprise Edition( JEE )6系列文章中,我们介绍了Java API for RESTful Web Services( JAX-RS )、Contexts and Dependency Injection( CDI )、 Web 端(Servlet 3、JSF 2)以及 EJB 3.1。在本系列文章行将结束之际,我们再来谈谈 Bean Validation( JSR 303 )——Java EE 6 的一个核心特性,它为实体验证定义了一个元数据模型和 API。其默认的元数据源是注解,但开发者可以通过 XML 描述符对其进行扩展。Validation API 并不依赖特定的应用层或是编程模型,这样同一套验证可由应用的所有层共享。它还提供了通过扩展 Validation API 来增加客户化验证约束的机制以及查询约束元数据仓库的手段。

在 JEE6 的 Bean Validation 出现之前,开发者不得不在表示层框架、业务层以及持久层中编写验证规则以保证这些规则的同步性,但这么做非常浪费时间而且极易出错。Bean Validation 是通过约束实现的,这些约束以注解的形式出现,注解可以放在 JavaBean(如 backing bean)的属性、方法或是类上面。 约束既可以是内建的注解(位于 javax.validation.constraints 包下面),也可以由用户定义。一些常用的内建注解列举如下:

  • Min:被 @Min 所注解的元素必须是个数字,其值要大于或等于给定的最小值。
  • Max:被 @Max 所注解的元素必须是个数字,其值要小于或等于给定的最大值。
  • Size @Size 表示被注解的元素必须位于给定的最小值和最大值之间。支持 Size 验证的数据类型有 String、Collection(计算集合的大小)、Map 以及数组。
  • NotNull @NotNull 确保被注解的元素不能为 null。
  • Null @Null 确保被注解的元素一定为 null。
  • Pattern @Pattern 确保被注解的元素(String)一定会匹配给定的 Java 正则表达式。

下面的示例来自于 Java EE 6系列文章,代码中通过 Bean Validation 注解声明了一些约束:

复制代码
public class Address {
@NotNull @Size(max=30)
private String addressline1;
@Size(max=30)
private String addressline2;
public String getAddressline1() {
return addressline1;
}
public void setAddressline1(String addressline1) {
this.addressline1 = addressline1;
}
}

@NotNull 指定被注解的元素 addressline1 不能为 null;@Size 指定被注解的元素 addressline1 和 addressline2 不能超过给定的最大值,即 30 个字符。

在验证 Address 对象时,addressline1 的值被传递到针对 @NotNull 约束的验证类以及针对 @Size 约束的验证类中,而 addressline2 的值被传递到针对 @Size 约束的验证类中,由相关的验证类进行验证。

如下代码自定义了一个名为 ZipCode 的约束:

复制代码
@Size(min=5, max=5)
@ConstraintValidator(ZipcodeValidator.class)
@Documented
@Target({ANNOTATION_TYPE, METHOD, FIELD})
@Retention(RUNTIME)
public @interface ZipCode {
String message() default "Wrong zipcode";
String[] groups() default {};
}

可以将 @ZipCode 用在类、属性或是方法上,就像其他约束一样。

复制代码
public class Address {
@ZipCode
private String zipCode;
public String getZipCode() {
return zipCode;
}
public void setZipCode(String zipCode) {
this.zipCode = zipCode;
}
}

Validation API

开发者可以借助于 Validation API 以编程的方式验证 JavaBean。Bean Validation API 的默认包是 javax.validation。下面对该包中的一些类进行说明:

ConstraintValidator:这是一个接口,具体的约束验证类需要实现该接口。该接口定义了相关的逻辑以验证给定对象类型中的约束。

Validator:Valida http://java.sun.com/javaee/6/docs/api/index.html?javax/validation/Validator.html tor 接口持有对象验证图的契约。该接口的实现必须是线程安全的。

ConstraintViolation ConstraintViolation 接口表示给定 bean 上的约束验证失败,它公开了约束违背上下文以及描述该违背情况的信息。

ValidationException:如果在验证过程中出现了某些不可恢复的错误就会抛出 ValidationException 异常。某些情况下可以指定该异常,如不合法的分组(group)定义、不合法的约束定义以及不合法的约束声明等等。

约束元数据请求 API

Bean Validation 规范提供了查询约束仓库的手段。该 API 主要用于工具支持和与其他框架、库以及 JSR 的集成。Bean Validation 规范旨在为对象约束提供一个验证引擎和元数据仓库。需要进行约束定义、验证和元数据的框架(Java EE 或 Java SE)可以利用 Bean Validation 规范完成这些功能,从应用或是基础设施的角度来看,这么做可以避免不必要的重复工作。

Bean Validation 已经集成到了 JSF 2.0 JPA 2.0 中。在 JSF 中可以将表单输入域与域对象的属性绑定起来。JSF 2 和 Bean Validation 可以判断出绑定的是哪个属性并执行与之相关的验证,还会将约束违背的信息显示给用户。

Hibernate Validator 4 是 Bean Validation 规范的参考实现框架,其最新版增加了不少新特性,如分组验证、与JPA 2 和JSF 2 的自然集成以及扩展的注解集等等。

查看英文原文: Java EE 6 Bean Validation Provides Entity Validation Metadata Model and API

2010-03-20 04:298288
用户头像

发布了 88 篇内容, 共 269.2 次阅读, 收获喜欢 8 次。

关注

评论

发布
暂无评论
发现更多内容

为什么程序员都不喜欢使用 switch ,而是大量的 if……else if ?

TimeFriends

8月月更

​DTSE Tech Talk丨第3期:解密数据隔离方案,让SaaS应用开发更轻松

华为云开发者联盟

SaaS 企业 华为云

使用 Presto 和 Alluxio 在 AWS 上搭建高性能平台来支持实时游戏服务

Alluxio

游戏 AWS presto Alluxio 8月月更

leetcode 304. Range Sum Query 2D - Immutable 二维区域和检索 - 矩阵不可变(中等)

okokabcd

LeetCode 数据结构与算法

阿里云携手卫宁健康发布WinCloud智慧医疗云联合解决方案,打造新一代智慧医疗系统

阿里云弹性计算

云服务器 分布式云 云盒 本地化部署

Spring进阶(五):Spring事务管理(详解+实例)

No Silver Bullet

spring 事务管理 8月月更

[极致用户体验] 我做的《联机五子棋》是如何追求极致用户体验的?(下)

HullQin

CSS JavaScript html 前端 8月月更

你以为的推荐系统,其实只是推荐模型

OneFlow

机器学习 推荐系统 推荐模型

压力测试-JMeter常用插件、服务器硬件监控

程序知音

Java 程序员 后端 后端技术

如何快速开发一个健康助手,实时守护用户健康

HarmonyOS SDK

三个线程交替打印ABC100次问题思考

越长大越悲伤

面试 线程 后端 JUC

基于keil5新建STM32F10x寄存器版本工程

DS小龙哥

8月月更

【LeetCode】爱吃香蕉的珂珂Java题解

Albert

LeetCode 8月月更

一文搞懂EMAS Serverless小程序开发|电子书免费下载

hum建应用专家

Serverless emas

一套优秀的直播系统源码是什么样的?起码要有这五个模块

开源直播系统源码

软件开发 直播系统 直播系统源码 钠斯直播系统

快速搞懂Mysql中BufferPool底层原理

知识浅谈

Buffer Pool 8月月更

龙蜥开发者说:我眼里的龙蜥社区:一个包容的大家庭 | 第 10 期

OpenAnolis小助手

Linux 开源 操作系统 龙蜥开发者说 参与贡献

flstudio21版本有什么新功能?

茶色酒

FL Studio

计算机网络(三、数据链路层)

计算机网络 8月月更

云原生(二十一) | Kubernetes篇之深入了解Ingress

Lansonli

云原生 8月月更

博睿数据入选《2022爱分析· 银行数字化厂商全景报告》

博睿数据

银行 智能运维 博睿数据

SAFe Day 2022 中国规模化敏捷大会即将开启

爱吃鱼的小雨

敏捷 safe 规模化敏捷 大规模敏捷 SAFeDay

spark实战之:分析维基百科网站统计数据(java版)

程序员欣宸

Java spark 8月月更

深度解读 | 关于SBOM最基础元素,你需要知道的(Part II)

安势信息

#开源 #SBOM 软件供应链安全 SBOM最基础元素 开源安全与治理

那些你不知道的 CSS 自定义形状网格布局

南城FE

CSS 前端 布局

《键值型数据库系统技术及节能要求》团体标准发布,腾讯、京东、北邮等联合发起

科技热闻

从 Angular Component 和 Directive 的实例化,谈谈 Angular forRoot 方法的命令由来

汪子熙

typescript 前端开发 angular web开发 8月月更

RocketMQ高可用设计之同步刷盘

急需上岸的小谢

8月月更

手摸手告诉 UI 妹子数据可视化 20 条优化细则【切图仔直接收藏】

掘金安东尼

前端 UI 8月月更

什么是企业知识库?有什么作用?如何搭建?@附源码

金陵老街

Java、 企业数字化转型 spring-boot

flstudio21水果软件更新内容V21版本

茶色酒

FL Studio

Java EE 6 Bean Validation提供了实体验证元数据模型与API_Java_Srini Penchikala_InfoQ精选文章