Spring MVC 教程-@CookieValue详解

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

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

1、预备知识

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、本文案例代码结构说明

Java 面试宝典是大明哥全力打造的 Java 精品面试题，它是一份靠谱、强大、详细、经典的 Java 后端面试宝典。它不仅仅只是一道道面试题，而是一套完整的 Java 知识体系，一套你 Java 知识点的扫盲贴。

它的内容包括：

大厂真题：Java 面试宝典里面的题目都是最近几年的高频的大厂面试真题。
原创内容：Java 面试宝典内容全部都是大明哥原创，内容全面且通俗易懂，回答部分可以直接作为面试回答内容。
持续更新：一次购买，永久有效。大明哥会持续更新 3+ 年，累计更新 1000+，宝典会不断迭代更新，保证最新、最全面。
覆盖全面：本宝典累计更新 1000+，从 Java 入门到 Java 架构的高频面试题，实现 360° 全覆盖。
不止面试：内容包含面试题解析、内容详解、知识扩展，它不仅仅只是一份面试题，更是一套完整的 Java 知识体系。
宝典详情：https://www.yuque.com/chenssy/sike-java/xvlo920axlp7sf4k
宝典总览：https://www.yuque.com/chenssy/sike-java/yogsehzntzgp4ly1
宝典进展：https://www.yuque.com/chenssy/sike-java/en9ned7loo47z5aw

目前 Java 面试宝典累计更新 400+ 道，总字数 42w+。大明哥还在持续更新中，下图是大明哥在 2024-12 月份的更新情况：

想了解详情的小伙伴，扫描下面二维码加大明哥微信【daming091】咨询

同时，大明哥也整理一套目前市面最常见的热点面试题。微信搜[大明哥聊 Java]或扫描下方二维码关注大明哥的原创公众号[大明哥聊 Java] ，回复【面试题】即可免费领取。

阅读全文