Spring MVC 教程-@CookieValue详解

作者简介：大家好，我是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下的验证结果当作最终结果的水货们请闭嘴】

当我们在接口中想获取cookie值的时候，怎么写代码更简单呢？

此时可以使用SpringMVC中的@CookieValue注解来标注参数，下面来看具体的用法。

1、预备知识

​​​​​​

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

 

2、@CookieValue

• 该注释指示应将方法参数绑定到HTTP cookie。
• 方法参数可以声明为javax.servlet.http.Cookie类型，也可以声明为Cookie值类型（String、int等）。

    @Target(ElementType.PARAMETER)
    @Retention(RetentionPolicy.RUNTIME)
    @Documented
    public @interface CookieValue {
    
    	/**
    	 * cookie名称
    	 */
    	@AliasFor("name")
    	String value() default "";
    
    	/**
    	 * 同value属性
    	 */
    	@AliasFor("value")
    	String name() default "";
    
    	/**
    	 * 是否需要cookie。
    	 * 默认值为true，如果请求中缺少cookie，则会引发异常。
    	 * 如果请求中不存在cookie，则希望使用空值，请将此选项切换为false。
    	 * 或者，提供一个默认值defaultValue，它隐式地将此标志设置为false。
    	 */
    	boolean required() default true;
    
    	/**
    	 * 默认值
    	 */
    	String defaultValue() default ValueConstants.DEFAULT_NONE;
    
    }

3、2种用法

• 用法1：参数类型为非javax.servlet.http.Cookie类型，比如（String、int等类型）
• 用法2：参数类型为javax.servlet.http.Cookie类型

4、案例代码

    package com.javacode2018.springmvc.chat18.controller;
    
    import org.springframework.web.bind.annotation.CookieValue;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    import javax.servlet.http.Cookie;
    import java.util.LinkedHashMap;
    import java.util.Map;
    
    @RestController
    public class CookieValueController {
    
        @RequestMapping("/cookievalue/test1")
        public Map<String, Object> test1(@CookieValue("name") String name,
                                         @CookieValue("age") int age) {
            Map<String, Object> result = new LinkedHashMap<>();
            result.put("name", name);
            result.put("age", age);
            return result;
        }
    
        /**
         * @param nameCookie
         * @param ageCookie
         * @return
         */
        @RequestMapping("/cookievalue/test2")
        public Map<String, Object> test2(@CookieValue("name") Cookie nameCookie,
                                         @CookieValue("age") Cookie ageCookie) {
            Map<String, Object> result = new LinkedHashMap<>();
            result.put("nameCookie", nameCookie);
            result.put("ageCookie", ageCookie);
            return result;
        }
    
    }

测试用例代码

    ###
    POST http://localhost:8080/chat18/cookievalue/test1
    Cookie: name=java; age=26
    
    
    ###
    POST http://localhost:8080/chat18/cookievalue/test2
    Cookie: name=java; age=26

运行2个用例

用例1输出

    {
      "name": "java",
      "age": 26
    }

用例2输出

    {
      "nameCookie": {
        "name": "name",
        "value": "java",
        "version": 0,
        "comment": null,
        "domain": null,
        "maxAge": -1,
        "path": null,
        "secure": false,
        "httpOnly": false
      },
      "ageCookie": {
        "name": "age",
        "value": "26",
        "version": 0,
        "comment": null,
        "domain": null,
        "maxAge": -1,
        "path": null,
        "secure": false,
        "httpOnly": false
      }
    }

5、@CookieValue原理

@CookieValue标注的参数的值来源于org.springframework.web.servlet.mvc.method.annotation.ServletCookieValueMethodArgumentResolver解析器

6、代码位置及说明

6.1、git地址

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

6.2、本文案例代码结构说明