使用SpringBoot通過自定義註解+AOP+全域性異常處理實現引數統一非空校驗

阿新 • • 發佈：2019-01-02

一、前言

在我們寫後臺介面時，難免對引數進行非空校驗，如果一兩個還好，但如果需要寫大量的介面，及必填引數太多的時候，會給我們開發帶來大量的重複工作，及很多相似程式碼。而sping自帶的@RequestParam註解並不能完全滿足我們的需求，因為這個註解只會校驗請求中是否存在該引數，而不會校驗這個引數的值是nulll還是空字串(“”)，如果引數不存在則會丟擲org.springframework.web.bind.MissingServletRequestParameterException異常。雖然目前已經有許多成熟的校驗框架，功能豐富，但是我們只需要做一個非空校驗即可。

因此我們可以自定義一個註解用於校驗引數是否為空。

使用的的框架

spring boot：1.5.9.RELEASE
JDK：1.8

二、準備工作

首先需要建立一個spring boot專案，並引入相關maven依賴(主要是spring-boot-starter-web與aspectjweaver),pom檔案如下:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation 
="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.beauxie</groupId>
    <artifactId>param-demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging 
>

    <name>param-demo</name>
    <description>param-demo for Spring Boot</description>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.9.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

        <!-- 新增支援web -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!--引入AOP相應的註解-->
        <dependency>
            <groupId>org.aspectj</groupId>
            <artifactId>aspectjweaver</artifactId>
            <version>1.8.5</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

說明:

spring-boot-starter-web用於spring boot WEB支援
aspectjweaver 用於引入aop的相關的註解，如@Aspect、@Pointcut等

三、自定義註解實現統一校驗

總體思路：自定義一個註解，對必填的引數加上該註解，然後定義一個切面，校驗該引數是否為空，如果為空則丟擲自定義的異常，該異常被自定義的異常處理器捕獲，然後返回相應的錯誤資訊。

1. 自定義註解

建立一個名為’ParamCheck’的註解，程式碼如下：

package com.beauxie.param.demo.annotation;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * "引數不能為空"註解，作用於方法引數上。
 * 
 * @author Beauxie
 * @date Created on 2017/1/6
 */
@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
public @interface ParamCheck {
    /**
     * 是否非空,預設不能為空
     */
    boolean notNull() default true;
}

說明:

@Target(ElementType.PARAMETER)表示該註解作用於方法引數上
該類可以拓展，比如增加length校驗

2. 自定義異常類

這個異常類與自定義註解配合一起使用，當加上’@ParamCheck’的引數為空時，丟擲該異常，程式碼如下:

package com.beauxie.param.demo.exception;

/**
 * @author Beauxie
 * @date Created on 2017/1/6
 */
public class ParamIsNullException extends RuntimeException {
    private final String parameterName;
    private final String parameterType;

    public ParamIsNullException(String parameterName, String parameterType) {
        super("");
        this.parameterName = parameterName;
        this.parameterType = parameterType;
    }

    @Override
    public String getMessage() {
        return "Required " + this.parameterType + " parameter \'" + this.parameterName + "\' must be not null !";
    }

    public final String getParameterName() {
        return this.parameterName;
    }

    public final String getParameterType() {
        return this.parameterType;
    }
}

說明:

該異常繼承RuntimeException，並定義了兩個成員屬性、重寫了getMessage()方法
之所以自定義該異常，而不用現有的org.springframework.web.bind.MissingServletRequestParameterException類，是因為MissingServletRequestParameterException為Checked異常,在動態代理過程中，很容易引發java.lang.reflect.UndeclaredThrowableException異常。

3. 自定義AOP

程式碼如下:

package com.beauxie.param.demo.aop;

import com.beauxie.param.demo.annotation.ParamCheck;
import com.beauxie.param.demo.exception.ParamIsNullException;
import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.*;
import org.aspectj.lang.reflect.MethodSignature;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Component;

import java.lang.annotation.Annotation;
import java.lang.reflect.Method;

/**
 * @author Beauxie
 * @date Created on 2017/1/6
 */
@Component
@Aspect
public class ParamCheckAop {
    private Logger logger = LoggerFactory.getLogger(this.getClass());


    /**
     * 定義有一個切入點，範圍為web包下的類
     */
    @Pointcut("execution(public * com.beauxie.param.demo.web..*.*(..))")
    public void checkParam() {
    }

    @Before("checkParam()")
    public void doBefore(JoinPoint joinPoint) {
    }

    /**
     * 檢查引數是否為空
     */
    @Around("checkParam()")
    public Object doAround(ProceedingJoinPoint pjp) throws Throwable {

        MethodSignature signature = ((MethodSignature) pjp.getSignature());
        //得到攔截的方法
        Method method = signature.getMethod();
        //獲取方法引數註解，返回二維陣列是因為某些引數可能存在多個註解
        Annotation[][] parameterAnnotations = method.getParameterAnnotations();
        if (parameterAnnotations == null || parameterAnnotations.length == 0) {
            return pjp.proceed();
        }
        //獲取方法引數名
        String[] paramNames = signature.getParameterNames();
        //獲取引數值
        Object[] paranValues = pjp.getArgs();
        //獲取方法引數型別
        Class<?>[] parameterTypes = method.getParameterTypes();
        for (int i = 0; i < parameterAnnotations.length; i++) {
            for (int j = 0; j < parameterAnnotations[i].length; j++) {
                //如果該引數前面的註解是ParamCheck的例項，並且notNull()=true,則進行非空校驗
                if (parameterAnnotations[i][j] != null && parameterAnnotations[i][j] instanceof ParamCheck && ((ParamCheck) parameterAnnotations[i][j]).notNull()) {
                    paramIsNull(paramNames[i], paranValues[i], parameterTypes[i] == null ? null : parameterTypes[i].getName());
                    break;
                }
            }
        }
        return pjp.proceed();
    }

    /**
     * 在切入點return內容之後切入內容（可以用來對處理返回值做一些加工處理）
     *
     * @param joinPoint
     */
    @AfterReturning("checkParam()")
    public void doAfterReturning(JoinPoint joinPoint) {
    }

    /**
     * 引數非空校驗，如果引數為空，則丟擲ParamIsNullException異常
     * @param paramName
     * @param value
     * @param parameterType
     */
    private void paramIsNull(String paramName, Object value, String parameterType) {
        if (value == null || "".equals(value.toString().trim())) {
            throw new ParamIsNullException(paramName, parameterType);
        }
    }

}

4. 全域性異常處理器

該異常處理器捕獲在ParamCheckAop類中丟擲的ParamIsNullException異常，並進行處理,程式碼如下:

package com.beauxie.param.demo.exception;

import com.beauxie.param.demo.common.Result;
import com.beauxie.param.demo.enums.EnumResultCode;
import com.beauxie.param.demo.utils.ResponseMsgUtil;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.MissingServletRequestParameterException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

import javax.servlet.http.HttpServletRequest;

/**
 * 全域性異常處理.
 * 一般情況下，方法都有異常處理機制，但不能排除有個別異常沒有處理，導致返回到前臺，因此在這裡做一個異常攔截，統一處理那些未被處理過的異常
 *
 * @author Beauxie
 * @date Created on 2017/1/6
 */
@RestControllerAdvice
public class GlobalExceptionHandler {
    private static final Logger LOGGER = LoggerFactory.getLogger(GlobalExceptionHandler.class);


    /**
     * 引數為空異常處理
     *
     * @param ex
     * @return
     */
    @ExceptionHandler({MissingServletRequestParameterException.class, ParamIsNullException.class})
    public Result<String> requestMissingServletRequest(Exception ex) {
        LOGGER.error("request Exception:", ex);
        return ResponseMsgUtil.builderResponse(EnumResultCode.FAIL.getCode(), ex.getMessage(), null);
    }

    /**
     * 特別說明： 可以配置指定的異常處理,這裡處理所有
     *
     * @param request
     * @param e
     * @return
     */
    @ExceptionHandler(value = Exception.class)
    public Result<String> errorHandler(HttpServletRequest request, Exception e) {
        LOGGER.error("request Exception:", e);
        return ResponseMsgUtil.exception();
    }
}

說明：

在requestMissingServletRequest()方法上加上@ExceptionHandler({MissingServletRequestParameterException.class, ParamIsNullException.class})註解，表明只處理處理MissingServletRequestParameterException與ParamIsNullException異常
errorHandler()方法則處理其他的異常

四、測試

在com.beauxie.param.demo.web包下新建一個名為HelloController的類,用於測試,程式碼如下:

package com.beauxie.param.demo.web;

import com.beauxie.param.demo.annotation.ParamCheck;
import com.beauxie.param.demo.common.Result;
import com.beauxie.param.demo.enums.EnumResultCode;
import com.beauxie.param.demo.utils.ResponseMsgUtil;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

/**
 * @author Beauxie
 * @date Created on 2018/1/6
 */
@RestController
public class HelloController {
    /**
     *測試@RequestParam註解
     * @param name
     * @return
     */
    @GetMapping("/hello1")
    public Result<String> hello1(@RequestParam String name) {
        return ResponseMsgUtil.builderResponse(EnumResultCode.SUCCESS.getCode(), "請求成功", "Hello," + name);
    }

    /**
     * 測試@ParamCheck註解
     * @param name
     * @return
     */
    @GetMapping("/hello2")
    public Result<String> hello2(@ParamCheck String name) {
        return ResponseMsgUtil.builderResponse(EnumResultCode.SUCCESS.getCode(), "請求成功", "Hello," + name);
    }

    /**
     * 測試@ParamCheck與@RequestParam一起時
     * @param name
     * @return
     */
    @GetMapping("/hello3")
    public Result<String> hello3(@ParamCheck @RequestParam String name) {
        return ResponseMsgUtil.builderResponse(EnumResultCode.SUCCESS.getCode(), "請求成功", "Hello," + name);
    }

最後執行ParamDemoApplicatio的main方法,開啟瀏覽器進行測試。

1. 測試@RequestParam註解

引數名為空測試
在瀏覽器的位址列輸入:http://localhost:8080/hello1，結果如下:

後臺錯誤資訊輸出：

此時後臺會報org.springframework.web.bind.MissingServletRequestParameterException: Required String parameter 'name' is not present錯誤資訊，提示引數’name’不存在
引數名不為空，值為空測試
在瀏覽器的位址列輸入:http://localhost:8080/hello1?name=，結果如下:

此時，name的值為空，但請求結果正常返回。

2. 測試@ParamCheck註解

3. 測試總結

當引數名為空時，分別新增兩個註解的介面都會提示引數不能為空
當引數名不為空，值為空時，@RequestParam註解不會報錯，但@ParamCheck註解提示引數’name’的值為空

五、總結

經過以上的測試也驗證了@RequestParam只會驗證對應的引數是否存在，而不會驗證值是否為空
ParamCheck還可以進行拓展，比如引數值長度、是否含有非法字元等校驗

六、原始碼下載地址

由於csdn下載需要積分，因此新增github原始碼地址:

使用SpringBoot通過自定義註解+AOP+全域性異常處理實現引數統一非空校驗

一、前言

使用的的框架

二、準備工作

三、自定義註解實現統一校驗

1. 自定義註解

2. 自定義異常類

3. 自定義AOP

4. 全域性異常處理器

四、測試

1. 測試@RequestParam註解

2. 測試@ParamCheck註解

3. 測試總結

五、總結

六、原始碼下載地址

使用SpringBoot通過自定義註解+AOP+全域性異常處理實現引數統一非空校驗

SpringBoot 通過自定義註解實現AOP切面程式設計例項

基於springboot通過自定義註解和AOP實現許可權驗證

通過自定義註解與aop統一存儲操作記錄

spring boot通過自定義註解和AOP攔截指定的請求

Springboot 自定義註解 AOP切面獲取操作日誌

使用Redisson通過自定義註解實現分散式鎖，使用Spring AOP簡化分散式鎖

【Redis】redis非同步訊息佇列+Spring自定義註解+AOP方式實現系統日誌持久化

SpringMvc通過自定義註解在方法的引數中注入資料

Spring Boot自定義註解+AOP實現日誌記錄

通過自定義註解和java反射實現Spring-DI依賴注入

Spring Boot中自定義註解+AOP實現主備庫切換

SpringBoot使用自定義註解實現簡單引數加密解密(註解+HandlerMethodArgumentResolver)

通過自定義屬性，排他的原理實現列表的表頭和對應內容的切換

java自定義註解解析及相關場景實現

JavaEE開發之SpringMVC中的自定義攔截器及異常處理

Springboot（十一）@ControllerAdvice全域性異常處理

JAVAEE——struts2_04：自定義攔截器、struts2標簽、登陸功能和校驗登陸攔截器的實現

研究基於spring通過對http請求資料的預處理（資料加解密、校驗、日誌）（2）過攔截器篇

SpringBoot引數非空校驗的非最優實現歷程

使用SpringBoot通過自定義註解+AOP+全域性異常處理實現引數統一非空校驗

一、前言

使用的的框架

二、準備工作

三、自定義註解實現統一校驗

1. 自定義註解

2. 自定義異常類

3. 自定義AOP

4. 全域性異常處理器

四、測試

1. 測試@RequestParam註解

2. 測試@ParamCheck註解

3. 測試總結

五、總結

六、原始碼下載地址

相關推薦