每篇一句

改我們就改得：取其精華，去其糟粕。否則木有意義

前言

如果說知道@SessionAttributes這個註解的人已經很少了，那麼不需要統計我就可以確定的說：知道@RequestAttribute註解的更是少之又少。我覺得主要有如下兩個原因：

1. @RequestAttribute這個註解很新，Spring4.3後才有
2. 我們可以使用API呼叫的方式（ServletRequest.getAttribute()）來達到目的，而不用註解。且成本也不太高

既然Spring推出了這個註解，那必然有它的優點。本文就帶大家領略一下它的風騷之處。

Spring提供的這些註解比如@ModelAttribute

、@SessionAttributes、@RequestAttribute都是為了簡化開發，提高複用性。同時另外一個目的是希望完全遮蔽掉源生Servlet API，增加它的擴充套件性。

本文我以@RequestAttribute為例進行講解，因為@SessionAttribute（也是Spring4.3後推出的註解）不管從使用和原理上都是一模一樣的。你可以理解成唯一區別是ServletRequest.getAttribute()和HttpSession.getAttribute()的區別
此處再強調一次，這裡指的是：org.springframework.web.bind.annotation.SessionAttribute

，而非org.springframework.web.bind.annotation.SessionAttributes

@RequestAttribute

它比前面介紹的那些@ModelAttribute、@SessionAttributes等註解要簡單很多，它只能使用在方法入參上。作用：從request中取對應的屬性值。

很多小夥伴對getParameter()和getAttribute()相關方法傻傻分不清楚。建議你可以先弄清楚param和attribute的區別~

// @since 4.3
@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface RequestAttribute {
    @AliasFor("name")
    String value() default "";
    @AliasFor("value")
    String name() default "";

    // 預設情況下 這個屬性是必須的（沒有就報錯了）
    boolean required() default true;
}
 

接下來這句話很重要：@RequestAttribute只負責從request裡面取屬性值，至於你什麼時候往裡放值，是有多種方式的可以達到的：

1. @ModelAttribute註解預存
2. HandlerInterceptor攔截器中預存
3. 請求轉發帶過來

下面分別按照這三種使用場景，給出使用Demo：

@ModelAttribute註解預存

比較簡單，在@ModelAttribute標註的方法上使用源生的HttpServletRequest放值即可

@RestController
@RequestMapping
public class HelloController {

    // 放置attr屬性值
    @ModelAttribute
    public Person personModelAttr(HttpServletRequest request) {
        request.setAttribute("myApplicationName", "fsx-application");
        return new Person("非功能方法", 50);
    }

    @GetMapping("/testRequestAttr")
    public void testRequestAttr(@RequestAttribute("myApplicationName") String myApplicationName, HttpServletRequest request, ModelMap modelMap) {
        System.out.println(myApplicationName); //fsx-application

        // 從request裡獲取
        System.out.println(request.getAttribute("myApplicationName")); //fsx-application

        // 從model裡獲取
        System.out.println(modelMap.get("myApplicationName")); // null 獲取不到attr屬性的
        System.out.println(modelMap.get("person")); // Person(name=非功能方法, age=50)
    }
}

請求/testRequestAttr，結果列印如下：

fsx-application
fsx-application
null
Person(name=非功能方法, age=50)

這裡務必注意：@RequestAttribute("myApplicationName")註解如果省略，是繫結不到attr屬性的哦（必須要有註解）~

但是，這樣是可行的：@RequestAttribute String myApplicationName（若註解沒有指定，Spring MVC會再去看形參的名字來確認自動繫結）
但若你寫成了這樣@RequestAttribute String aaa，那請求就直接400錯誤了丟擲異常：org.springframework.web.bind.ServletRequestBindingException

HandlerInterceptor攔截器中預存

簡單，直接上程式碼：

public class SimpleInterceptor implements HandlerInterceptor {
 
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        request.setAttribute("myApplicationName", "fsx-application");
        return true;
    }
    ...
}

測試程式碼：略。

forward請求轉發帶過來

形如這樣：

request.setAttribute("myApplicationName", "fsx-application");
request.getRequestDispatcher("/index").forward(request, response); 

其實往裡放置屬性值只需要遵循一個原則：在呼叫處理器目標方法之前（引數封裝之前）任意地方放置即可，屬性值是都能被取到的。

原理剖析

按照我的習慣，即使它很簡單，我也會扒開來看看它的原理部分嘛。
根據經驗很容易想到解析它的是一個HandlerMethodArgumentResolver，它就是RequestAttributeMethodArgumentResolver

RequestAttributeMethodArgumentResolver

很明顯，它也是@since 4.3才出現的，命名上也很配套嘛。

public class RequestAttributeMethodArgumentResolver extends AbstractNamedValueMethodArgumentResolver {

    // 只處理標註了@RequestAttribute註解的入參
    @Override
    public boolean supportsParameter(MethodParameter parameter) {
        return parameter.hasParameterAnnotation(RequestAttribute.class);
    }

    // 封裝此註解的屬性到NamedValueInfo 這裡關於引數名的處理有這麼一個處理
    // info.name.isEmpty()也就說如果自己沒有指定，就用形參名parameter.getParameterName()
    @Override
    protected NamedValueInfo createNamedValueInfo(MethodParameter parameter) {
        RequestAttribute ann = parameter.getParameterAnnotation(RequestAttribute.class);
        Assert.state(ann != null, "No RequestAttribute annotation");
        return new NamedValueInfo(ann.name(), ann.required(), ValueConstants.DEFAULT_NONE);
    }

    // 從request請求域去找屬性值
    @Override
    @Nullable
    protected Object resolveName(String name, MethodParameter parameter, NativeWebRequest request){
        return request.getAttribute(name, RequestAttributes.SCOPE_REQUEST);
    }


    // 若值不存在，丟擲異常ServletRequestBindingException
    @Override
    protected void handleMissingValue(String name, MethodParameter parameter) throws ServletException {
        throw new ServletRequestBindingException("Missing request attribute '" + name +
                "' of type " +  parameter.getNestedParameterType().getSimpleName());
    }

}

原始碼短小精悍，非常簡單。
其實它解析入參方面的核心解析流程在其父類AbstractNamedValueMethodArgumentResolver身上，但並不是本文的重點，請詳見HandlerMethodArgumentResolver的章節~

@RequestAttribute屬性required預設為true, request.getAttribute獲取不到引數就會丟擲異常ServletRequestBindingException；required設定為false，即使沒有從request中獲取到就忽略跳過，賦值為null;

總結

這篇文章介紹了@RequestAttribute的使用Demo，以及它很簡單的原理分析。相較於之前所有文章，這篇是非常輕鬆的，希望可以提供給大家一個思路，來使用@RequestAttribute提高你的逼格，哈哈（友情提示：裝逼需謹慎哦~）

說明：因為@SessionAttribute的使用甚至原理幾乎一毛一樣，所以不用再重複篇幅了

總結

這篇文章介紹了@SessionAttributes的核心處理原理，以及也給了一個Demo來介紹它的基本使用，不出意外閱讀下來你對它應該是有很好的收穫的，希望能幫助到你簡化開發~

相關閱讀

從原理層面掌握HandlerMethod、InvocableHandlerMethod、ServletInvocableHandlerMethod的使用【一起學Spring MVC】
從原理層面掌握@SessionAttributes的使用【一起學Spring MVC】
從原理層面掌握@ModelAttribute的使用（核心原理篇）【一起學Spring MVC】
從原理層面掌握@ModelAttribute的使用（使用篇）【一起學Spring MVC】

知識交流

==The last：如果覺得本文對你有幫助，不妨點個讚唄。當然分享到你的朋友圈讓更多小夥伴看到也是被作者本人許可的~==

若對技術內容感興趣可以加入wx群交流：Java高工、架構師3群。
若群二維碼失效，請加wx號：fsx641385712（或者掃描下方wx二維碼）。並且備註："java入群" 字樣，會手動邀請入