转载

Java Bean Validation

案例概述

在这本文中，我们将介绍使用标准框架验证Java bean的基础知识 - JSR 380，也称为Bean Validation 2.0。

当然，验证用户输入在大多数应用程序中是一个超常见的要求，Java Bean Validation框架已经成为处理这种逻辑的事实上的标准。

JSR 380

JSR 380是用于bean验证的Java API的规范，是JavaEE和JavaSE的一部分，它使用@NotNull、@Min和@Max等注释确保bean的属性满足特定的标准。

此版本需要Java 8或更高版本，并利用Java 8中添加的新功能（如类型注释），并支持Optional和LocalDate等新类型。

有关规范的完整信息，请继续阅读JSR 380。

依赖性

我们将使用Maven示例来显示所需的依赖项，但当然，可以使用各种方式添加这些jar。

验证API

根据JSR 380规范，validation-api依赖包含标准验证API：

<dependency>
    <groupId>javax.validation</groupId>
    <artifactId>validation-api</artifactId>
    <version>2.0.0.Final</version>
</dependency>
复制代码

验证API参考实现

Hibernate Validator是验证API的参考实现。

要使用它，我们必须添加以下依赖项：

<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>6.0.2.Final</version>
</dependency>
<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator-annotation-processor</artifactId>
    <version>6.0.2.Final</version>
</dependency>
复制代码

这里快速说明的是，hibernate-validator完全独立于Hibernate的持久性方面，并且通过将其添加为依赖项，我们不会将这些持久性方面添加到项目中。

表达式语言依赖关系

JSR 380提供对变量插值的支持，允许在违规消息中使用表达式。

要解析这些表达式，我们必须在表达式语言API和该API的实现上添加依赖项。GlassFish提供参考实现：

<dependency>
    <groupId>javax.el</groupId>
    <artifactId>javax.el-api</artifactId>
    <version>3.0.0</version>
</dependency>
 
<dependency>
    <groupId>org.glassfish.web</groupId>
    <artifactId>javax.el</artifactId>
    <version>2.2.6</version>
</dependency>
复制代码

如果未添加这些JAR，您将在运行时收到错误消息，如下所示：

HV000183：无法加载'javax.el.ExpressionFactory'。检查您是否在类路径上有EL依赖项，或使用ParameterMessageInterpolator

使用验证注释

我们将在这里使用User bean作为主要示例，并为其添加一些简单的验证：

import javax.validation.constraints.AssertTrue;
import javax.validation.constraints.Max;
import javax.validation.constraints.Min;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Size;
import javax.validation.constraints.Email;
 
public class User {
 
    @NotNull(message = "Name cannot be null")
    private String name;
 
    @AssertTrue
    private boolean working;
 
    @Size(min = 10, max = 200, message 
      = "About Me must be between 10 and 200 characters")
    private String aboutMe;
 
    @Min(value = 18, message = "Age should not be less than 18")
    @Max(value = 150, message = "Age should not be greater than 150")
    private int age;
 
    @Email(message = "Email should be valid")
    private String email;
 
    // standard setters and getters 
}
复制代码

示例中使用的所有注释都是标准的JSR注释：

@NotNull - 验证带注释的属性值不为 null
@AssertTrue - 验证带注释的属性值是否为 true
@Size - 验证带注释的属性值是否具有属性min和max之间的大小; 可以应用于String， Collection， Map和数组属性
@Min - 验证带注释的属性的值是否小于value属性
@Max - 验证带注释的属性的值是否大于value属性
@Email - 验证带注释的属性是否为有效的电子邮件地址

某些注释接受其他属性，但message属性对所有属性都是通用的。这是当相应属性的值未通过验证时通常会呈现的消息。

可以在JSR中找到的一些其他注释是：

@NotEmpty - 验证属性不为null或为空; 可以应用于String， Collection， Map或 Array值
@NotBlank - 只能应用于文本值，并验证该属性不是null或空格
@Positive和@PositiveOrZero - 适用于数值并验证它们是严格正数还是正数，包括0
@Negative和@NegativeOrZero - 适用于数值并验证它们是严格为负数，还是负数，包括0
@Past和@PastOrPresent - 验证日期值是否过去，包括现在; 可以应用于日期类型，包括Java 8中添加的日期类型
@Future和@FutureOrPresent - 验证日期值是否将来包括现在

验证注释也可以应用于集合的元素：

List<@NotBlank String> preferences;
复制代码

在这种情况下，将验证添加到选项列表中的任何值。

该规范还支持 Java 8中的新Optional类型：

private LocalDate dateOfBirth;
 
public Optional<@Past LocalDate> getDateOfBirth() {
    return Optional.of(dateOfBirth);
}
复制代码

在这里，验证框架将自动解包LocalDate值并对其进行验证。

程序验证

一些框架 - 例如Spring--只需使用注释就可以通过简单的方法触发验证过程。这主要是为了使我们不必与程序验证API进行交互。

现在让我们进入手动路线并以编程方式设置：

ValidatorFactory factory = Validation.buildDefaultValidatorFactory();
Validator validator = factory.getValidator();
复制代码

要验证bean，我们必须首先拥有Validator对象，该对象使用ValidatorFactory构造。

定义Bean

我们现在要设置一个无效用户 - 使用空名称值：

User user = new User();
user.setWorking(true);
user.setAboutMe("Its all about me!");
user.setAge(50);
复制代码

验证Bean

现在我们有了一个Validator，我们可以通过将它传递给validate方法来验证我们的bean 。任何违反User对象中定义的约束的行为都将作为Set返回。

Set<ConstraintViolation<User>> violations = validator.validate(user);
复制代码

通过迭代违规，我们可以使用getMessage方法获取所有违规消息。

for (ConstraintViolation<User> violation : violations) {
    log.error(violation.getMessage()); 
}
复制代码

在我们的示例中（ifNameIsNull_nameValidationFails），该集合将包含一个ConstraintViolation，消息“ Name not not null”。

案例结论

本文重点介绍了标准Java Validation API的简单传递，并使用javax.validation注释和API 说明了bean验证的基础知识。

原文 https://juejin.im/post/5c2c6ae66fb9a049b3481784

正文到此结束

所属分类：编程技术 Java

本文标签： java map list id spring value Collection js 解析 IO https CTO bean mail 注释 message maven 代码 http tab API build tag web UI final validator
版权声明： 本文为互联网转载文章，出处已在文章中说明(部分除外)。如果侵权，请联系本站长删除，谢谢。
本文海报： 生成海报一生成海报二

其他链接

关于本站

本站定位：个人技术类博客

本站作用：写博客、记日志、闲聊扯淡鼓捣技术。

问题交流

Java Bean Validation

热门推荐

相关文章

说给你听

本文目录

随机标签

书籍教程

近期评论

网站信息

其他链接

关于本站

问题交流