自定义Controller接口参数的值不能为空的校验

需求:在进入到相应Controller控制器前,需要先校验参数是否符合规范要求,如是否为空等等。

有人说,可以使用@PathVariable里面的required属性控制,然而该属性只是代表参数是否必填,并不能校验参数的值是否满足要求。

解决

考虑到项目可能多处需要做此判断,所以我采用注解和切面的方式来解决此问题。

首先定义一个注解,用作标识,在参数的值需要做非空判断的地方添加该注解,定义一个切面来对添加了注解的地方进行校验。

添加注解

ParamNotNullCheck.java

内容:

@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ParamNotNullCheck {}

添加切面

切面的逻辑可参考下面代码

@Aspect
@Component
public class ParamNotNullCheckAspect {

    @Around("@annotation(com.dtranx.tools.corpora.business.annotations.ParamNotNullCheck)")
    public Object doAround (ProceedingJoinPoint joinPoint) throws Throwable {
        MethodSignature signature=(MethodSignature) joinPoint.getSignature();
        //获取拦截的方法
        Method method = signature. getMethod();
        //获取方法的参数名
        String[] paramNames = signature.getParameterNames();
        //获取参数值
        Object[] paramValues = joinPoint.getArgs();
        //获取方法参数类型
        Class<?>[] parameterTypes =method .getParameterTypes();
        for (int i=0; i < paramValues.length; i++){
            Object paramValue = paramValues[i];
            if(StrUtil.equals(parameterTypes[i].getName(), "java.lang.String")) {
                if (ObjectUtil.isNull(paramValue) || StrUtil.isBlank((String) paramValue)){
                    //字符串,不能为空串(""、" " 等等)和null
                    return ResponseResult.failure(StrUtil.format( "参数数{}不能为空",paramNames[i]), 10021);}}
            if (ObjectUtil.isNull(paramValue)){
                return ResponseResult.failure(StrUtil.format("参数{}不能为空",paramNames[i]), 10021);}}
        return joinPoint.proceed();
    }
}

最后在需要做非空判断的地方加上@ParamNotNullCheck注解即可。如下所示:

  • 1
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
Java 中,使用注解进行参数校验是一种常见的做法。如果需要实现高级写法,可以使用 Hibernate Validator 库中的 ConstraintValidator 接口自定义注解来实现参数校验。 示例代码如下: 1. 创建自定义注解 ``` @Target({ElementType.FIELD, ElementType.PARAMETER}) @Retention(RetentionPolicy.RUNTIME) @Constraint(validatedBy = NotEmptyValidator.class) public @interface NotEmpty { String message() default "参数不能为空"; Class<?>[] groups() default {}; Class<? extends Payload>[] payload() default {}; } ``` 在上面的代码中,定义了一个 NotEmpty 注解,用于校验参数非空。其中,@Constraint 注解用于指定校验逻辑的实现类 NotEmptyValidator。 2. 创建校验器 ``` public class NotEmptyValidator implements ConstraintValidator<NotEmpty, Object> { @Override public boolean isValid(Object value, ConstraintValidatorContext context) { if (value == null) { return false; } if (value instanceof String) { return StringUtils.isNotBlank((String) value); } if (value instanceof Collection) { return !((Collection<?>) value).isEmpty(); } if (value instanceof Map) { return !((Map<?, ?>) value).isEmpty(); } if (value.getClass().isArray()) { return Array.getLength(value) > 0; } return true; } } ``` 在上面的代码中,创建了 NotEmptyValidator 类,实现了 ConstraintValidator 接口。isValid 方法用于实现校验逻辑,它可以判断不同类型的参数是否为空。 3. 在接口请求对象中使用注解 ``` public class UserQuery { @NotEmpty(message = "用户名不能为空") private String username; @NotEmpty(message = "角色列表不能为空") private List<Role> roles; // 其他字段略 // getter 和 setter 略 } ``` 在上面的代码中,使用 NotEmpty 注解来标记 username 和 roles 字段,表示它们不能为空。如果校验失败,会抛出异常并返回错误信息。 4. 在 Controller 中进行参数校验 ``` @PostMapping("/users") public ResponseEntity<List<User>> listUsers(@RequestBody @Validated UserQuery query) { List<User> users = userService.listUsers(query); return ResponseEntity.ok(users); } ``` 在上面的代码中,使用 @Validated 注解来开启参数校验功能,并将 UserQuery 对象标记为需要进行校验。如果校验失败,会抛出异常并返回错误信息。 使用上述方法,可以在接口请求对象中使用注解来进行参数校验,而不需要在 Controller 中编写大量的校验代码,从而提高代码可读性和可维护性。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值