首页 > 软件编程 > java > javax.validation.constraints注解

javax.validation.constraints注解使用

2024-07-03 16:40:47 作者：霁月清风与谁同

这篇文章主要介绍了javax.validation.constraints注解使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教

javax.validation.constraints注解

javax.validation.constraints是Java Validation API中的一个包，它提供了一组注解，用于在Java代码中进行数据校验和验证。

该包中定义了多个注解，用于标记属性或方法参数的验证规则。

开发者可以通过在对象的属性上添加这些注解，来定义相应的验证规则。

常用的注解

@NotNull：用于标记属性或方法参数不能为null。

适用于任何类型的属性或方法参数。
不能用于基本数据类型，因为它们不接受null值。

@NotEmpty：

用于标记字符串、集合、Map等类型的属性或方法参数不能为null且不能为空。
适用于String、Collection、Map和数组类型的属性或方法参数。

@NotBlank：

用于标记字符串类型的属性或方法参数不能为null且包含至少一个非空格字符。
适用于String类型的属性或方法参数。

@Min：

用于标记数值类型的属性或方法参数的最小值。
适用于byte、short、int、long和对应的包装类类型的属性或方法参数。

@Max：

用于标记数值类型的属性或方法参数的最大值。
适用于byte、short、int、long和对应的包装类类型的属性或方法参数。

@Size：

用于标记字符串、集合、Map等类型的属性或方法参数的大小范围。
可以用于String、Collection、Map和数组类型的属性或方法参数。
必须指定大小范围，例如@Size(min=2, max=10)。

@Pattern：

用于标记字符串类型的属性或方法参数的正则表达式验证规则。
适用于String类型的属性或方法参数。
必须指定正则表达式，例如@Pattern(regexp=“^[a-zA-Z0-9]+$”)。

@Email：

用于标记字符串类型的属性或方法参数必须符合电子邮件地址的格式。
适用于String类型的属性或方法参数。
验证字符串是否符合电子邮件地址的格式。

其他注解

@Past：用于验证日期或时间类型的属性或方法参数必须在当前时间之前。
@Future：用于验证日期或时间类型的属性或方法参数必须在当前时间之后。
@URL：用于验证字符串类型的属性或方法参数必须符合URL的格式。
@IP：用于验证字符串类型的属性或方法参数必须符合IP地址的格式。

这些注解仅提供了基本的验证规则，可以根据实际需求进行组合和自定义注解以满足特定的验证需求。此外，还可以使用继承和组合注解来扩展验证规则

javax.validation.constraints中@NotBlank和@NotEmpty的区别

在Java的javax.validation.constraints包中，@NotBlank和@NotEmpty是用于验证属性值非空的注解，它们之间有一些区别。

@NotBlank

@NotBlank 用于验证一个字符串是否为非空，它会去除字符串两端的空格后再判断是否为空。

@NotBlank 可以用在 String 类型的字段上。

例如，@NotBlank 用在一个 String 类型的字段上，如果该字段为 null、空字符串或只包含空格，都会触发验证失败。

示例：

public class User { @NotBlank private String username; }

@NotEmpty

@NotEmpty 用于验证一个集合（Collection）、Map、数组或字符串是否非空，它不会去除字符串两端的空格，而是直接判断是否为空。

@NotEmpty 可以用在 Collection、Map、数组和 String 类型的字段上。

例如，@NotEmpty 用在一个集合类型的字段上，如list 或 JSONArray，如果该集合为空，会触发验证失败。

示例：

public class User { @NotEmpty private List<String> phoneNumbers; }

    @ApiModelProperty("结束日期（包含）")
    @NotNull
    private Date endDate;
 
    @ApiModelProperty("任务生成周天（1,2,3,4,5,6,7）")
    @NotNull
    private String weekDay;
 
    @ApiModelProperty("巡检当天时间班次")
    @NotEmpty
    private JSONArray period;

心得

@NotBlank 主要用于验证字符串类型的字段是否非空，会去除两端空格后再进行判断。
@NotEmpty 用于验证集合、Map、数组或字符串类型的字段是否非空，不会去除空格，直接判断是否为空。

根据具体的需求，你可以选择使用 @NotBlank 或 @NotEmpty 进行属性非空的验证。

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

javax.validation.constraints注解使用