❤️SpringMVC成神之路之二十八、SessionAttribute详解

小明的学习圈子2023-12-24后端SpringMVC成神之路

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

1、预备知识

  1. 接口测试利器 HTTP Clientopen in new window
  2. 参数解析器HandlerMethodArgumentResolver解密open in new window

2、@SessionAttribute注解

2.1、作用

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

2.2、用法

如下代码,site参数上使用了@SessionAttribute("site")注解,site参数的值等于session.getAttribute("site")

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

这个注解的源码如下

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

3、案例

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

  • 第一个方法test1中向session域中丢了一个site属性

  • 第二个方的site参数上标注了@SessionAttribute("site"),所以会拿到session中site的值,然后输出

package com.javacode2018.springmvc.chat18.controller; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.*; import javax.servlet.http.HttpSession; @Controller public class SessionAttributeController { @RequestMapping(value = "/sessionattribute/test1",produces = "text/html;charset=UTF-8") @ResponseBody public String test1(HttpSession session) { //向session中放入数据 session.setAttribute("site", "路人博客,包含了所有系列文章,阅读更方便"); //重定向 return "session中放入了site信息!"; } @RequestMapping(value = "/sessionattribute/test2", produces = "text/html;charset=UTF-8") @ResponseBody public String test2(@SessionAttribute("site") String site) { return site; } }


下面来验证一下效果。

![image-20231231214751784](/assets/springmvc/series/28/image-20231231214751784.png)

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

request.setAttribute("site", null);


此时再次访问接口(依次访问接口1和2),第2个接口会报400错误,原因:session域中没有找到site这个属性对应的值,即session.getAttribute(“site”)为null

![image-20231231214829102](/assets/springmvc/series/28/image-20231231214829102.png)

**2种解决方案**

- 方案1:将@SessionAttribute的required属性设置为false,常用这种方式
- 方案2:将@SessionAttribute标注的参数类型调整为java8中的java.util.Optional类型,上面的接口2的site参数类型可以调整为`Optional`类型,即可解决问题

## 4、@SessionAttribute注解原理

@SessionAttribute注解标注的参数的值来源于`org.springframework.web.servlet.mvc.method.annotation.SessionAttributeMethodArgumentResolver`解析器,源码

```java
public class SessionAttributeMethodArgumentResolver extends AbstractNamedValueMethodArgumentResolver {
    @Override
    public boolean supportsParameter(MethodParameter parameter) {
        return parameter.hasParameterAnnotation(SessionAttribute.class);
    }
    @Override
    protected NamedValueInfo createNamedValueInfo(MethodParameter parameter) {
        SessionAttribute ann = parameter.getParameterAnnotation(SessionAttribute.class);
        Assert.state(ann != null, "No SessionAttribute 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_SESSION);
    }
    @Override
    protected void handleMissingValue(String name, MethodParameter parameter) throws ServletException {
        throw new ServletRequestBindingException("Missing session attribute '" + name +
                "' of type " + parameter.getNestedParameterType().getSimpleName());
    }
}

5、案例代码git地址

https://gitee.com/javacode2018/springmvc-series

所有系列文章的均在此仓库中。

来源:http://www.itsoku.com/course/6/239

Last Updated 2024/4/6 11:55:17