您的位置:首頁技術文章
文章詳情頁

Spring的@Validation和javax包下的@Valid區別以及自定義校驗注解

瀏覽:7日期:2023-07-24 15:42:54
1.后臺參數校驗

Spring Validation驗證框架對參數的驗證機制提供了@Validated(Spring JSR-303規范,是標準JSR-303的一個變種),javax提供了@Valid(標準JSR-303規范),配合BindingResult可以直接提供參數驗證結果

spring提供的驗證:org.springframework.validation.annotation.Validated;javax提供的驗證:javax.validation.Valid;

在檢驗Controller的入參是否符合規范時,使用@Validated或者@Valid在基本驗證功能上沒有太多區別。但是在分組、注解地方、嵌套驗證等功能上兩個有所不同:

1.1 分組

@Validated:提供了一個分組功能,可以在入參驗證時,根據不同的分組采用不同的驗證機制,這個網上也有資料,不詳述。@Valid:作為標準JSR-303規范,還沒有分組的功能。

1.2 注解地方

@Validated:可以用在類型、方法和方法參數上。但是不能用在成員屬性(字段)上

@Valid:可以用在方法、構造函數、方法參數和成員屬性(字段)上

兩者是否能用于成員屬性(字段)上直接影響能否提供嵌套驗證的功能。

1.3 嵌套驗證

@Validated:用在方法入參上無法單獨提供嵌套驗證功能。不能用在成員屬性(字段)上,也無法提示框架進行嵌套驗證。能配合嵌套驗證注解@Valid進行嵌套驗證。

示例代碼:

#使用@Validated的分組功能,需要提供接口,原因是 @Target({ElementType.TYPE, ElementType.METHOD,ElementType.PARAMETER}) @Retention(RetentionPolicy.RUNTIME) @Documented public @interface Validated { Class<?>[] value() default {}; #需要定義類型做區分,所以提供個接口做分組區分 }

示例分類接口:

public interface CreateGroup { } #在需要驗證的字段上添加分組即可

示例代碼:

public class WebOrderQo { /** * 用戶ID */ @ApiModelProperty('用戶ID') @NotNull(message = '用戶ID不能為空', groups = {UpdateGroup.class, CreateGroup.class, QueryGroup.class}) private Long uid; } #在Controller里面的方法上加@Validated注解,啟動分組需要在@Validated(CreateGroup.class)填上對應的分組類型,默認沒有指定分組的校驗注解@NotNull,在分組校驗情況@Validated({CreateGroup.class})下不生效,只會在@Validated生效;

示例代碼:

@RestController public class ItemController { @RequestMapping('/item/add') public void addItem(@Validated Item item, BindingResult bindingResult) { doSomething(); }}

@Valid:用在方法入參上無法單獨提供嵌套驗證功能。能夠用在成員屬性(字段)上,提示驗證框架進行嵌套驗證。能配合嵌套驗證注解@Valid進行嵌套驗證

示例代碼:

public class Item {@NotNull(message = 'id不能為空')@Min(value = 1, message = 'id必須為正整數')@ListValue(vals = {0,1}) //自定義注解private Long id;@Valid // 嵌套驗證必須用@Valid@NotNull(message = 'props不能為空')@Size(min = 1, message = 'props至少要有一個自定義屬性') //嵌套驗證private List<Prop> props;}2.自定義參數驗證注解

當驗證框架提供的驗證注解無法滿足業務需求的時候,可以自定義驗證注解實現我們的業務需求

1)、編寫一個自定義的校驗注解

@Documented @Constraint(validatedBy = { ListValueConstraintValidator.class }) @Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE }) @Retention(RUNTIME) public @interface ListValue { String message() default '{pers.store.market.common.valid.ListValue.message}'; //可以在配置文件中配置自定的消息提醒 Class<?>[] groups() default { }; Class<? extends Payload>[] payload() default { }; int[] vals() default { };}

注意:可以在resources下面創建ValidationMessages.properties文件,讀取自定義的提示消息

pers.store.market.common.valid.ListValue.message=參數提交錯誤2)、編寫一個自定義的校驗器ConstraintValidator

public class ListValueConstraintValidator implements ConstraintValidator<ListValue,Integer> {private Set<Integer> set = new HashSet<>();//初始化方法@Overridepublic void initialize(ListValue constraintAnnotation) { int[] vals = constraintAnnotation.vals(); for (int val : vals) { set.add(val); }}/** * * @param value 需要校驗的值 * @param context * @return */@Overridepublic boolean isValid(Integer value, ConstraintValidatorContext context) { return set.contains(value); }}

3)、關聯自定義的校驗器和自定義的校驗注解

@Documented @Constraint(validatedBy = { ListValueConstraintValidator.class【可以指定多個不同的校驗器適配不同類型的校驗】 }) @Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE }) @Retention(RUNTIME) public @interface ListValue {}

到此這篇關于Spring的@Validation和javax包下的@Valid區別以及自定義校驗注解的文章就介紹到這了,更多相關Spring的@Validation和@Valid區別內容請搜索好吧啦網以前的文章或繼續瀏覽下面的相關文章希望大家以后多多支持好吧啦網!

標簽: Java
相關文章:
国产综合久久一区二区三区