詳解使用Spring AOP和自定義注解進(jìn)行參數(shù)檢查

更新時(shí)間：2018年04月18日 16:53:51 作者：liaosilzu2007

本篇文章主要介紹了詳解使用Spring AOP和自定義注解進(jìn)行參數(shù)檢查，小編覺(jué)得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧

引言

使用SpringMVC作為Controller層進(jìn)行Web開(kāi)發(fā)時(shí)，經(jīng)常會(huì)需要對(duì)Controller中的方法進(jìn)行參數(shù)檢查。本來(lái)SpringMVC自帶@Valid和@Validated兩個(gè)注解可用來(lái)檢查參數(shù)，但只能檢查參數(shù)是bean的情況，對(duì)于參數(shù)是String或者Long類型的就不適用了，而且有時(shí)候這兩個(gè)注解又突然失效了（沒(méi)有仔細(xì)去調(diào)查過(guò)原因），對(duì)此，可以利用Spring的AOP和自定義注解，自己寫一個(gè)參數(shù)校驗(yàn)的功能。

代碼示例

注意：本節(jié)代碼只是一個(gè)演示，給出一個(gè)可行的思路，并非完整的解決方案。

本項(xiàng)目是一個(gè)簡(jiǎn)單Web項(xiàng)目，使用到了：Spring、SpringMVC、Maven、JDK1.8

項(xiàng)目結(jié)構(gòu)：

自定義注解：

ValidParam.java：

package com.lzumetal.ssm.paramcheck.annotation;

import java.lang.annotation.*;

/**
 * 標(biāo)注在參數(shù)bean上，表示需要對(duì)該參數(shù)校驗(yàn)
 */
@Target({ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ValidParam {
  
  
}

NotNull.java：

package com.lzumetal.ssm.paramcheck.annotation;

import java.lang.annotation.*;

@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface NotNull {

  String msg() default "字段不能為空";
  
}

NotEmpty.java：

package com.lzumetal.ssm.paramcheck.annotation;

import java.lang.annotation.*;

@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface NotEmpty {

  String msg() default "字段不能為空";
  
}

切面類

ParamCheckAspect.java：

package com.lzumetal.ssm.paramcheck.aspect;
import com.lzumetal.ssm.paramcheck.annotation.NotEmpty;
import com.lzumetal.ssm.paramcheck.annotation.NotNull;
import com.lzumetal.ssm.paramcheck.annotation.ValidParam;
import org.apache.commons.lang3.StringUtils;
import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import org.aspectj.lang.reflect.MethodSignature;
import org.springframework.stereotype.Component;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.HttpSession;
import java.lang.reflect.Field;
import java.lang.reflect.Parameter;
import java.util.Arrays;
/**
 * 參數(shù)檢查切面類
 */
@Aspect
@Component
public class ParamCheckAspect {

  @Before("execution(* com.lzumetal.ssm.paramcheck.controller.*.*(..))")
  public void paramCheck(JoinPoint joinPoint) throws Exception {
    //獲取參數(shù)對(duì)象
    Object[] args = joinPoint.getArgs();
    //獲取方法參數(shù)
    MethodSignature signature = (MethodSignature) joinPoint.getSignature();
    Parameter[] parameters = signature.getMethod().getParameters();
    for (int i = 0; i < parameters.length; i++) {
      Parameter parameter = parameters[i];
      //Java自帶基本類型的參數(shù)（例如Integer、String）的處理方式
      if (isPrimite(parameter.getType())) {
        NotNull notNull = parameter.getAnnotation(NotNull.class);
        if (notNull != null && args[i] == null) {
          throw new RuntimeException(parameter.toString() + notNull.msg());
        }
        //TODO
        continue;
      }
      /*
       * 沒(méi)有標(biāo)注@ValidParam注解，或者是HttpServletRequest、HttpServletResponse、HttpSession時(shí)，都不做處理
      */
      if (parameter.getType().isAssignableFrom(HttpServletRequest.class) || parameter.getType().isAssignableFrom(HttpSession.class) ||
          parameter.getType().isAssignableFrom(HttpServletResponse.class) || parameter.getAnnotation(ValidParam.class) == null) {
        continue;
      }
      Class<?> paramClazz = parameter.getType();
      //獲取類型所對(duì)應(yīng)的參數(shù)對(duì)象，實(shí)際項(xiàng)目中Controller中的接口不會(huì)傳兩個(gè)相同的自定義類型的參數(shù)，所以此處直接使用findFirst()
      Object arg = Arrays.stream(args).filter(ar -> paramClazz.isAssignableFrom(ar.getClass())).findFirst().get();
      //得到參數(shù)的所有成員變量
      Field[] declaredFields = paramClazz.getDeclaredFields();
      for (Field field : declaredFields) {
        field.setAccessible(true);
        //校驗(yàn)標(biāo)有@NotNull注解的字段
        NotNull notNull = field.getAnnotation(NotNull.class);
        if (notNull != null) {
          Object fieldValue = field.get(arg);
          if (fieldValue == null) {
            throw new RuntimeException(field.getName() + notNull.msg());
          }
        }
        //校驗(yàn)標(biāo)有@NotEmpty注解的字段，NotEmpty只用在String類型上
        NotEmpty notEmpty = field.getAnnotation(NotEmpty.class);
        if (notEmpty != null) {
          if (!String.class.isAssignableFrom(field.getType())) {
            throw new RuntimeException("NotEmpty Annotation using in a wrong field class");
          }
          String fieldStr = (String) field.get(arg);
          if (StringUtils.isBlank(fieldStr)) {
            throw new RuntimeException(field.getName() + notEmpty.msg());
          }
        }
      }
    }
  }
  /**
   * 判斷是否為基本類型：包括String
   * @param clazz clazz
   * @return true：是;   false：不是
   */
  private boolean isPrimite(Class<?> clazz){
    return clazz.isPrimitive() || clazz == String.class;
  }
}

參數(shù)JavaBean

StudentParam.java：

package com.lzumetal.ssm.paramcheck.requestParam;
import com.lzumetal.ssm.paramcheck.annotation.NotEmpty;
import com.lzumetal.ssm.paramcheck.annotation.NotNull;
public class StudentParam {
  @NotNull
  private Integer id;
  private Integer age;
  @NotEmpty
  private String name;
  //get、set方法省略...
}

驗(yàn)證參數(shù)校驗(yàn)的Controller

TestController.java：

package com.lzumetal.ssm.paramcheck.controller;
import com.google.gson.Gson;
import com.lzumetal.ssm.paramcheck.annotation.NotNull;
import com.lzumetal.ssm.paramcheck.annotation.ValidParam;
import com.lzumetal.ssm.paramcheck.requestParam.StudentParam;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.ResponseBody;
@Controller
public class TestController {
  private static Gson gson = new Gson();
  @ResponseBody
  @RequestMapping(value = "/test", method = RequestMethod.POST)
  public StudentParam checkParam(@ValidParam StudentParam param, @NotNull Integer limit) {
    System.out.println(gson.toJson(param));
    System.out.println(limit);
    return param;
  }
}

本節(jié)示例代碼已上傳至GitHub：https://github.com/liaosilzu2007/ssm-parent.git

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

您可能感興趣的文章: