springboot如何忽略接收請(qǐng)求中的參數(shù)

更新時(shí)間：2024年07月16日 09:58:08 作者：Rewloc

這篇文章主要介紹了springboot如何忽略接收請(qǐng)求中的參數(shù)問(wèn)題,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教

一、場(chǎng)景說(shuō)明

在一些開(kāi)發(fā)場(chǎng)景中，特別是前后端分開(kāi)開(kāi)發(fā)的場(chǎng)景中，由于后端接口采用的VO接收前端請(qǐng)求傳遞的參數(shù)，但是前端開(kāi)發(fā)小伙伴可能會(huì)把vo中所有屬性不進(jìn)行過(guò)濾就直接調(diào)用接口，這樣會(huì)導(dǎo)致后端api由于不需要某些字段而導(dǎo)致api運(yùn)行失敗，比如：id字段等。

二、開(kāi)發(fā)環(huán)境

開(kāi)發(fā)工具：IDEA
開(kāi)發(fā)語(yǔ)言：JAVA 1.8
開(kāi)發(fā)環(huán)境：Springboot 2.4.13

三、實(shí)現(xiàn)思路

使用Java的注解技術(shù)，定義一個(gè)ReceiveIgnoreParam注解，作用在Controller的需要忽略接收屬性的方法上。
通過(guò)spring切面編程技術(shù)來(lái)實(shí)現(xiàn)對(duì)方法注解的操作，其判斷方法參數(shù)中是否包含需要忽略的屬性，如果存在直接設(shè)置為null或者空串

四、具體實(shí)現(xiàn)

注解類代碼

package com.rewloc.annotation;

import java.lang.annotation.*;

/**
 * 類描述：忽略接收參數(shù) 注解
 *
 * @date 2022/5/9 10:54
 * @slogan 設(shè)計(jì)就是代碼，代碼就是設(shè)計(jì)
 * @since JDK 8
 */
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Target(ElementType.METHOD)
public @interface ReceiveIgnoreParam {
    /** 字段名數(shù)組 */
    String[] fieldName();
}

切面類代碼

package com.rewloc.aop;

import cn.hutool.core.util.ArrayUtil;
import cn.hutool.core.util.BooleanUtil;
import com.rewloc.annotation.ReceiveIgnoreParam;
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Pointcut;
import org.aspectj.lang.reflect.MethodSignature;
import org.springframework.stereotype.Component;

import java.lang.reflect.Field;
import java.util.Arrays;

/**
 * 類描述：忽略接收參數(shù) 切面類
 *
 * @slogan 設(shè)計(jì)就是代碼，代碼就是設(shè)計(jì)
 * @since JDK 8
 */
@Aspect
@Component
public class ReceiveIgnoreParamAop {
    private static final String ID = "id";

    /**
     * 方法描述： 切面攔截器
     *
     * @slogan 設(shè)計(jì)就是代碼，代碼就是設(shè)計(jì)
     */
    @Pointcut("@annotation(com.rewloc.ReceiveIgnoreParam)")
    private void ignoreReceiveParam() {
    }

    /**
     * 方法描述： 忽略屬性值攔截處理
     *
     * @param point 環(huán)繞通知處理對(duì)象
     * @return {@link Object}
     * @slogan 設(shè)計(jì)就是代碼，代碼就是設(shè)計(jì)
     */
    @Around(value = "ignoreReceiveParam()")
    public Object doAround(ProceedingJoinPoint point) {
        try {
            // 獲取注解信息
            MethodSignature methodSignature = (MethodSignature) point.getSignature();
            ReceiveIgnoreParam ignoreReceiveParam = methodSignature.getMethod().getAnnotation(ReceiveIgnoreParam.class);
            // 獲取方法的參數(shù)
            Object[] args = point.getArgs();
            // 循環(huán)返回參數(shù)，
            for (Object arg : args) {
                // 對(duì)需要忽略的屬性進(jìn)行null賦值 
                Arrays.stream(ignoreReceiveParam.fieldName()).forEach(field -> {
                    try {
                        // 清空忽略屬性的值
                        cleanValue(arg, field);
                    } catch (Exception e) {
                    }
                });
            }
            return point.proceed(args);
        } catch (Throwable e) {
            throw new RuntimeException("系統(tǒng)繁忙，請(qǐng)稍后再試!");
        }
    }

    /**
     * 方法描述： 情況屬性的值
     *
     * @param obj       參數(shù)對(duì)象
     * @param fieldName 字段名稱
     * @return {@link Object}
     * @slogan 設(shè)計(jì)就是代碼，代碼就是設(shè)計(jì)
     */
    private void cleanValue(Object obj, String fieldName) throws IllegalAccessException {
        // 獲取參數(shù)對(duì)象
        Class<?> aClass = obj.getClass();
        // 獲取class中的所有字段
        Field[] fields = aClass.getDeclaredFields();
        for (Field field : fields) {
            // 如果是需要忽略的字段，賦null值
            if (fieldName.equals(field.getName())) {
                field.setAccessible(true);
                field.set(obj, null);
            }
        }
    }
}

vo類

package com.rewloc.vo

import lombok.Data;

@Data
public class ReceiveIgnoreParamVO {
    private String id;
    private String name;
    private String sex;
    private int age;
    private String birthdate;
}

注解使用

package com.rewloc.web;

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * 類描述：忽略接收參數(shù) controller類
 *
 * @slogan 設(shè)計(jì)就是代碼，代碼就是設(shè)計(jì)
 * @since JDK 8
 */
@RestController
@RequestMapping("/receive/ignoreParam")
public class ReceiveIgnoreParamController {
    /**
     * 分頁(yè)獲取查詢列表
     *
     * @param vo    接收查詢參數(shù)的VO對(duì)象
     * @return Result
     */
    @PostMapping("/hello")
    @ReceiveIgnoreParam(fieldName = {"id", "name"})
    public String selectPage(ReceiveIgnoreParamVO vo) {
        // 將當(dāng)前vo對(duì)象返回
        return JSONObject.toJSONString(vo);
    }
}