springboot 自定义注解校验参数

本文介绍了如何在SpringBoot中实现自定义注解进行参数校验,包括定义注解、注解实现类、自定义异常处理、实体类以及在Controller中使用。同时,文章还提及了注解分组校验的实现方法,通过创建注解组并在需要的注解上指定组名,以控制多个注解的生效条件。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

1.定义注解

package com.xl.annotation;

import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;
@Target({
    ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR, ElementType.PARAMETER })
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Constraint(validatedBy = {
   MobileValidate.class})
/**
 * 验证手机号码正确的注解
 */
public @interface MobilePattern {
   
    String message() default "Invalid phone number";
    Class<?>[] groups() default {
    };
    Class<? extends Payload>[] payload() default {
    };
}






2.注解实现类

package com.xl.annotation;

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class MobileValidate implements ConstraintValidator<MobilePattern, String> {
   


    @Override
    public boolean isValid(String s, ConstraintValidatorContext constraintValidatorContext) {
   
        Pattern p = Pattern.compile("((13[0-9])|(14[5,7])|(15[^4,\\D])|(17[0,1,3,6-8])|(18[0-9])|(19[8,9])|(166))[0-9]{8}$");
        Matcher m = p.matcher(s);
        return m.matches();
    }
}

3.自定义注解抛出异常类

package com.xl.annotation;

import org.springframework.http.HttpStatus;
import org.springframework.web.bind
### 创建和使用自定义数据校验注解 在 Spring Boot 中实现自定义数据校验注解涉及几个主要步骤,包括创建约束注解、编写验证逻辑以及应用该注解到需要校验的地方。 #### 定义自定义注解 首先,需定义一个新的注解用于标记待检验的属性。此操作可通过 `Constraint` 和其他元注解完成: ```java import javax.validation.Constraint; import javax.validation.Payload; import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; @Target({ ElementType.FIELD, ElementType.METHOD }) @Retention(RetentionPolicy.RUNTIME) @Constraint(validatedBy = MyCustomValidator.class) // 指定对应的验证器类 public @interface MyCustom { String message() default "Invalid value"; Class<?>[] groups() default {}; Class<? extends Payload>[] payload() default {}; } ``` 上述代码片段展示了如何声明名为 `MyCustom` 的新注解[^1]。 #### 实现 ConstraintValidator 接口 接着要为这个新的注解提供具体的验证行为,这通常意味着扩展 `ConstraintValidator<A,T>` 类型并重写其方法: ```java import javax.validation.ConstraintValidator; import javax.validation.ConstraintValidatorContext; public class MyCustomValidator implements ConstraintValidator<MyCustom, String> { @Override public void initialize(MyCustom constraintAnnotation) {} @Override public boolean isValid(String value, ConstraintValidatorContext context) { if (value == null || "".equals(value.trim())) return false; // Add custom validation logic here. return true; // Replace with actual condition check } } ``` 这段程序说明了怎样构建一个简单的字符串有效性检查函数[^2]。 #### 应用自定义注解于实体或 DTO 属性之上 一旦完成了前面两步的工作,则可以直接把刚刚建立好的注解放置在任何希望执行相应规则的位置上: ```java public class UserDTO { private Long id; @MyCustom(message="The username must be valid.") private String userName; // Getters and setters... } ``` 这里展示了一个假设性的场景——即对用户名进行了额外的有效性检测[^3]。 #### 配置与测试 最后一步就是确保应用程序上下文中包含了必要的 Bean 来处理这些新增加的功能;对于大多数情况而言,默认配置已经足够支持基本功能。可以通过单元测试来确认一切正常运作: ```java @SpringBootTest class CustomValidationTests { @Autowired Validator validator; @Test void testValidUserDto(){ UserDTO user = new UserDTO(); Set<ConstraintViolation<UserDTO>> violations = validator.validate(user); assertFalse(violations.isEmpty()); } @Test void testInValidUserDto(){ UserDTO user = new UserDTO(); user.setUserName("validUsername"); Set<ConstraintViolation<UserDTO>> violations = validator.validate(user); assertTrue(violations.isEmpty()); } } ``` 以上示例演示了如何利用 JUnit 测试框架来进行简单有效的集成测试[^4]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值