Spring MVC 教程-@RequestAttribute详解

作者简介：大家好，我是smart哥，前中兴通讯、美团架构师，现某互联网公司CTO

联系qq：184480602，加我进群，大家一起学习，一起进步，一起对抗互联网寒冬

学习必须往深处挖，挖的越深，基础越扎实！

阶段1、深入多线程

阶段2、深入多线程设计模式

阶段3、深入juc源码解析

阶段4、深入jdk其余源码解析

阶段5、深入jvm源码解析

码哥源码部分

码哥讲源码-原理源码篇【2024年最新大厂关于线程池使用的场景题】

码哥讲源码【炸雷啦！炸雷啦！黄光头他终于跑路啦！】

码哥讲源码-【jvm课程前置知识及c/c++调试环境搭建】

​​​​​​码哥讲源码-原理源码篇【揭秘join方法的唤醒本质上决定于jvm的底层析构函数】

码哥源码-原理源码篇【Doug Lea为什么要将成员变量赋值给局部变量后再操作？】

码哥讲源码【你水不是你的错,但是你胡说八道就是你不对了！】

码哥讲源码【谁再说Spring不支持多线程事务，你给我抽他！】

终结B站没人能讲清楚红黑树的历史，不服等你来踢馆！

打脸系列【020-3小时讲解MESI协议和volatile之间的关系，那些将x86下的验证结果当作最终结果的水货们请闭嘴】

本文将介绍SpringMVC中的@RequestAttribute注解。

1、预备知识

1.  接口测试利器 HTTP Client
2. 参数解析器HandlerMethodArgumentResolver解密

 

​​​​​​​2、@RequestAttribute注解

2.1、作用

用来标注在接口的参数上，参数的值来源于request作用域。

2.2、用法

如下代码，site参数上使用了@RequestAttribute("site")注解，site参数的值等于request.getAttribute("site")

    @ResponseBody
    public String test2(@RequestAttribute("site") String site) {
        return site;
    }

这个注解的源码如下

    @Target(ElementType.PARAMETER)
    @Retention(RetentionPolicy.RUNTIME)
    @Documented
    public @interface RequestAttribute {
    
    	/**
    	 * 指定request作用域中属性的名称
    	 */
    	@AliasFor("name")
    	String value() default "";
    
    	/**
    	 * 同value属性
    	 */
    	@AliasFor("value")
    	String name() default "";
    
    	/**
    	 * 属性是不是必须的，如果是true，request中没有取到时，则会抛出异常
    	 * 此时可以将required设置为false，或者使用java8中的Option类型来修饰参数解决
    	 */
    	boolean required() default true;
    
    }

3、案例

下面代码中有2个接口方法

• 第一个方法test1中向request域中丢了一个site属性，然后进行了跳转，跳转到第二个方法，最后将site作为响应体输出
• 第二个方的site参数上标注了@RequestAttribute("site")，所以会拿到request中site的值，然后输出

    package com.javacode2018.springmvc.chat18.controller;
    
    import org.springframework.stereotype.Controller;
    import org.springframework.web.bind.annotation.RequestAttribute;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.ResponseBody;
    
    import javax.servlet.http.HttpServletRequest;
    
    @Controller
    public class RequestAttributeController {
    
        @RequestMapping("/requestattribute/test1")
        public String test1(HttpServletRequest request) {
            request.setAttribute("site",
                    "<a href='http://www.itsoku.com'>路人博客，包含了所有系列文章，阅读更方便</a>");
            return "forward:/requestattribute/test2";
        }
    
        @RequestMapping(value = "/requestattribute/test2", produces = "text/html;charset=UTF-8")
        @ResponseBody
        public String test2(@RequestAttribute("site") String site) {
            return site;
        }
    }

浏览器中访问第一个接口/requestattribute/test1，输出如下

若我们调整一下接口1中代码，将site的值置为空

    request.setAttribute("site", null);

此时再次访问接口会报400错误，原因：request域中没有找到site这个属性对应的值，即request.getAttribute("site")为null

2种解决方案

• 方案1：将@RequestAttribute的required属性设置为false，常用这种方式
• 方案2：将@RequestAttribute标注的参数类型调整为java8中的java.util.Optional类型，上面的接口2的site参数类型可以调整为Optional<String>类型，即可解决问题

4、@RequestAttribute注解原理

@RequestAttribute注解标注的参数的值来源于org.springframework.web.servlet.mvc.method.annotation.RequestAttributeMethodArgumentResolver解析器，源码

    public class RequestAttributeMethodArgumentResolver extends AbstractNamedValueMethodArgumentResolver {
    
    	@Override
    	public boolean supportsParameter(MethodParameter parameter) {
    		return parameter.hasParameterAnnotation(RequestAttribute.class);
    	}
    
    	@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);
    	}
    
    	@Override
    	@Nullable
    	protected Object resolveName(String name, MethodParameter parameter, NativeWebRequest request){
    		return request.getAttribute(name, RequestAttributes.SCOPE_REQUEST);
    	}
    
    	@Override
    	protected void handleMissingValue(String name, MethodParameter parameter) throws ServletException {
    		throw new ServletRequestBindingException("Missing request attribute '" + name +
    				"' of type " +  parameter.getNestedParameterType().getSimpleName());
    	}
    
    }