快捷導(dǎo)航

Springboot Controller接口默認(rèn)自動(dòng)填充業(yè)務(wù)實(shí)體參數(shù)值詳解

更新時(shí)間：2025年05月12日 09:10:48 作者：小目標(biāo)青年

這篇文章主要介紹了Springboot Controller接口默認(rèn)自動(dòng)填充業(yè)務(wù)實(shí)體參數(shù)值,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教

前言

我還是一貫如此，有人不明白，沒(méi)玩過(guò)HandlerMethodArgumentResolver 。

那么很可能不止他一個(gè)人，那么我就有必要出手。

不多說(shuō)，開(kāi)搞。

快速模擬出這個(gè)使用場(chǎng)景

假如有好多接口，都需要用到當(dāng)前的業(yè)務(wù)參數(shù)，這個(gè)業(yè)務(wù)場(chǎng)景需要的參數(shù) 是當(dāng)前登錄人的信息。

常見(jiàn)的方案核心思路無(wú)非有二

① 后端寫(xiě)個(gè)解析+查詢(xún)函數(shù)，哪里需要就調(diào)用一下

② 后端提供一個(gè)獲取登錄人信息接口，前端先調(diào)用接口，緩存起來(lái)；然后哪些接口需要這個(gè)參數(shù)，前端就從緩存拿出來(lái)然后傳過(guò)來(lái)。

第② 個(gè)方案，我直接pass。

需要前端配合，前端存拿存拿很麻煩，哪個(gè)接口需要還得跟前端溝通
前端的緩存什么時(shí)候需要更新？如果涉及改手機(jī)號(hào)或者一些參數(shù)，但是token不失效，也就是業(yè)務(wù)標(biāo)識(shí)ID 不會(huì)變，那么前端的緩存數(shù)據(jù)就不是最新的
xxxx 暫時(shí)不想太多

我的想法：

優(yōu)化第①個(gè)方案

做到減少重復(fù)代碼的輸出，做到簡(jiǎn)單使用、動(dòng)態(tài)使用、自動(dòng)填充。

也就是求救的小伙伴的想法思路，是的，自動(dòng)填充，后端自己整。

事不宜遲，開(kāi)敲。

需要做什么，三件套（要玩花樣，玩動(dòng)態(tài)，少不了自定義注解+aop）：

首先是來(lái)個(gè)自定義注解，用于標(biāo)記，哪些接口需要用到我們默認(rèn)填充業(yè)務(wù)參數(shù):

①LoginUserX.java

import java.lang.annotation.*;


/**
 * @Author: JCccc
 * @Date: 2022-4-11 18:45
 * @Description:
 */
@Target({ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface LoginUserX {
}

② 自定義一個(gè)參數(shù)解析器 HandlerMethodArgumentResolver

LoginUserParamResolver.java

import org.springframework.core.MethodParameter;
import org.springframework.web.bind.support.WebDataBinderFactory;
import org.springframework.web.context.request.NativeWebRequest;
import org.springframework.web.method.support.HandlerMethodArgumentResolver;
import org.springframework.web.method.support.ModelAndViewContainer;

import java.util.Objects;

/**
 * @Author: JCccc
 * @Date: 2022-4-11 18:45
 * @Description:
 */
public class LoginUserParamResolver  implements HandlerMethodArgumentResolver {


    @Override
    public boolean supportsParameter(MethodParameter parameter) {
        if (parameter.getParameterType().isAssignableFrom(LoginUserAnalysis.class) && parameter.hasParameterAnnotation(LoginUserX.class)) {
            return true;
        }
        return false;
    }

    @Override
    public Object resolveArgument(MethodParameter parameter, ModelAndViewContainer mavContainer, NativeWebRequest webRequest, WebDataBinderFactory binderFactory) throws Exception {
       if (Objects.nonNull(parameter.getParameterAnnotation(LoginUserX.class))){
           String token = webRequest.getHeader("token");
           //解析token 、獲取 登錄用戶信息等等，或者是 拿你需要的業(yè)務(wù)參數(shù)
           return  new LoginUserAnalysis().setLoginNameAnalysis("JCcccc").setPhoneAnalysis("136919xxxxx").setTopRoleTypeAnalysis(1);
       }
       return null;
    }
}

代碼簡(jiǎn)析：

可以看到有2個(gè)函數(shù)

supportsParameter ：看看誰(shuí)支持誰(shuí)不支持
resolveArgument ：開(kāi)始解析,寫(xiě)邏輯代碼

③ 默認(rèn)填充的業(yè)務(wù)實(shí)體示例 LoginUserAnalysis.java

import lombok.Data;
import lombok.experimental.Accessors;

@Data
@Accessors(chain = true)
public class LoginUserAnalysis {

    private String loginNameAnalysis;
    private String phoneAnalysis;
    private Integer topRoleTypeAnalysis;
}

最后寫(xiě)2個(gè)模擬的測(cè)試接口，玩一下，看看效果：

@GetMapping("doGetTest")
public  String doGetTest(@LoginUserX LoginUserAnalysis loginUserAnalysis,String queryName){
    System.out.println("接收到的參數(shù)："+queryName);
    System.out.println("默認(rèn)填充的參數(shù)"+loginUserAnalysis.toString());
    return "ok";
}

@PostMapping("doPostTest")
public  void doPostTest(@LoginUserX LoginUserAnalysis loginUserAnalysis, @RequestBody Car car){
    System.out.println("接收到的參數(shù)："+car.toString());
    System.out.println("默認(rèn)填充的參數(shù)"+loginUserAnalysis.toString());
}

測(cè)試：

先看看post接口：