Java后端接口中提取请求头中的Cookie和Token的方法

更新时间：2025年01月20日 08:53:24 作者：码农阿豪@新空间代码工作室

在现代 Web 开发中,HTTP 请求头（Header）是客户端与服务器之间传递信息的重要方式之一,本文将详细介绍如何在 Java 后端（以 Spring Boot 为例）中提取请求头中的 Cookie 和 Token,并提供完整的代码示例和优化建议,需要的朋友可以参考下

引言

在现代 Web 开发中，HTTP 请求头（Header）是客户端与服务器之间传递信息的重要方式之一。常见的场景包括：

通过 Cookie 传递会话信息。
通过 Authorization 头传递身份验证 Token。

本文将详细介绍如何在 Java 后端（以 Spring Boot 为例）中提取请求头中的 Cookie 和 Token，并提供完整的代码示例和优化建议。

1. 背景

1.1 什么是 HTTP 请求头？

HTTP 请求头是客户端（如浏览器）发送给服务器的附加信息，用于传递元数据。常见的请求头包括：

Cookie：用于传递客户端存储的会话信息。
Authorization：用于传递身份验证信息，如 JWT Token。

1.2 为什么需要提取请求头？

在后端开发中，提取请求头中的信息是常见的需求。例如：

身份验证：从 Authorization 头中提取 Token，验证用户身份。
会话管理：从 Cookie 中提取会话 ID，维护用户会话状态。
数据传递：通过自定义请求头传递额外的业务数据。

2. 使用 Spring Boot 提取请求头

Spring Boot 提供了多种方式来处理 HTTP 请求头。以下是几种常见的方法：

2.1 使用 @RequestHeader 注解

@RequestHeader 注解可以直接将请求头中的值绑定到方法的参数上。

示例代码

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestHeader;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HeaderController {

    @GetMapping("/example")
    public String getHeaders(
            @RequestHeader("Cookie") String cookie, // 提取 Cookie
            @RequestHeader("Authorization") String token // 提取 Token
    ) {
        return "Cookie: " + cookie + ", Token: " + token;
    }
}

说明

@RequestHeader("Cookie")：提取请求头中的 Cookie。
@RequestHeader("Authorization")：提取请求头中的 Token（通常放在 Authorization 头中）。

注意事项

如果请求头中没有指定的字段，Spring 会抛出 MissingRequestHeaderException。可以通过 required = false 设置为可选参数：

@RequestHeader(value = "Cookie", required = false) String cookie

2.2 使用 HttpServletRequest

通过 HttpServletRequest 对象，可以手动获取请求头中的值。

示例代码

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpServletRequest;

@RestController
public class HeaderController {

    @GetMapping("/example")
    public String getHeaders(HttpServletRequest request) {
        String cookie = request.getHeader("Cookie"); // 提取 Cookie
        String token = request.getHeader("Authorization"); // 提取 Token
        return "Cookie: " + cookie + ", Token: " + token;
    }
}

说明

request.getHeader("Cookie")：获取 Cookie 头的值。
request.getHeader("Authorization")：获取 Authorization 头的值。

优点

更灵活，适用于需要动态处理请求头的场景。

2.3 使用 @CookieValue 注解

如果 Cookie 是以键值对的形式传递的（例如 Cookie: name=value），可以使用 @CookieValue 注解提取特定的 Cookie 值。

示例代码

import org.springframework.web.bind.annotation.CookieValue;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HeaderController {

    @GetMapping("/example")
    public String getCookie(
            @CookieValue("sessionId") String sessionId // 提取特定的 Cookie 值
    ) {
        return "Session ID: " + sessionId;
    }
}

说明

@CookieValue("sessionId")：提取名为 sessionId 的 Cookie 值。

注意事项

如果 Cookie 不存在，Spring 会抛出 MissingRequestCookieException。可以通过 required = false 设置为可选参数：

@CookieValue(value = "sessionId", required = false) String sessionId

3. 提取 Token 的常见方式

Token 通常放在 Authorization 头中，格式为 Bearer <token>。我们需要提取 Bearer 后面的部分。

3.1 使用 @RequestHeader 和字符串处理

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestHeader;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HeaderController {

    @GetMapping("/example")
    public String getToken(
            @RequestHeader("Authorization") String authHeader // 提取 Authorization 头
    ) {
        if (authHeader != null && authHeader.startsWith("Bearer ")) {
            String token = authHeader.substring(7); // 提取 Bearer 后面的部分
            return "Token: " + token;
        } else {
            return "Invalid Authorization header";
        }
    }
}

说明

authHeader.startsWith("Bearer ")：检查 Authorization 头是否以 Bearer 开头。
authHeader.substring(7)：提取 Bearer 后面的 Token。

3.2 使用 HttpServletRequest 和字符串处理

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpServletRequest;

@RestController
public class HeaderController {

    @GetMapping("/example")
    public String getToken(HttpServletRequest request) {
        String authHeader = request.getHeader("Authorization"); // 提取 Authorization 头
        if (authHeader != null && authHeader.startsWith("Bearer ")) {
            String token = authHeader.substring(7); // 提取 Bearer 后面的部分
            return "Token: " + token;
        } else {
            return "Invalid Authorization header";
        }
    }
}

4. 综合示例

以下是一个综合示例，提取 Cookie 和 Token，并返回处理结果：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestHeader;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpServletRequest;

@RestController
public class HeaderController {

    @GetMapping("/example")
    public String getHeaders(
            @RequestHeader(value = "Cookie", required = false) String cookie, // 提取 Cookie
            @RequestHeader(value = "Authorization", required = false) String authHeader // 提取 Authorization 头
    ) {
        // 处理 Cookie
        String cookieInfo = (cookie != null) ? "Cookie: " + cookie : "No Cookie provided";

        // 处理 Token
        String tokenInfo;
        if (authHeader != null && authHeader.startsWith("Bearer ")) {
            String token = authHeader.substring(7); // 提取 Bearer 后面的部分
            tokenInfo = "Token: " + token;
        } else {
            tokenInfo = "Invalid or missing Authorization header";
        }

        return cookieInfo + ", " + tokenInfo;
    }
}

5. 测试接口

可以使用 Postman 或 curl 测试接口：

5.1 请求示例

curl -X GET http://localhost:8080/example \
-H "Cookie: sessionId=abc123" \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

5.2 响应示例

{
  "Cookie": "sessionId=abc123",
  "Token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

6. 总结

在 Java 后端（Spring Boot）中提取请求头中的 Cookie 和 Token 有多种方式：

使用 @RequestHeader 注解：适合直接绑定请求头到方法参数。
使用 HttpServletRequest：适合需要动态处理请求头的场景。
使用 @CookieValue 注解：适合提取特定的 Cookie 值。

对于 Token，通常需要从 Authorization 头中提取 Bearer 后面的部分。通过合理的异常处理和参数校验，可以确保代码的健壮性和可维护性。

以上就是Java后端接口中提取请求头中的Cookie和Token的方法的详细内容，更多关于Java后端接口提取Cookie和Token的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

如何实现java Iterator迭代器功能
这篇文章主要介绍了如何实现java Iterator迭代器功能,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-01-01
深入解读MVC模式和三层架构
这篇文章主要介绍了深入解读MVC模式和三层架构,三层架构就是为了符合“高内聚,低耦合”思想,把各个功能模块划分为表示层(UI)、业务逻辑层(BLL)和数据访问层(DAL)的三层架构,各层之间采用接口相互访问,需要的朋友可以参考下
2023-04-04
IDEA自定义setter和getter格式的设置方法
这篇文章主要介绍了IDEA自定义setter和getter格式的设置方法,本文通过图文并茂的形式给大家介绍的非常详细,需要的朋友参考下吧
2023-12-12
老生常谈JVM的内存溢出说明及参数调整
下面小编就为大家带来一篇老生常谈JVM的内存溢出说明及参数调整。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-03-03
Java Swing编写一个简单的计算器软件
大家好，本篇文章主要讲的是Java Swing编写一个简单的计算器软件，感兴趣的同学赶快来看一看吧，对你有帮助的话记得收藏一下，方便下次浏览
2021-12-12
Spring boot easyexcel 实现复合数据导出、按模块导出功能
这篇文章主要介绍了Spring boot easyexcel 实现复合数据导出、按模块导出,实现思路流程是准备一个导出基础填充模板，默认填充key，本文给大家介绍的非常详细，需要的朋友可以参考下
2023-09-09
Java实现PDF转为线性PDF详解
线性化PDF文件是PDF文件的一种特殊格式，可以通过Internet更快地进行查看。本文将通过后端Java程序实现将PDF文件转为线性化PDF。感兴趣的可以了解一下
2021-12-12
JAVA实现基于Tcp协议的简单Socket通信实例
本篇文章主要介绍了JAVA实现基于Tcp协议的简单Socket通信实例，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-01-01
Java整合RabbitMQ实现五种常见消费模型
本文将深入介绍RabbitMQ的五种常见消费模型,包括简单队列模型、工作队列模型、发布/订阅模型、路由模型和主题模型,删除线格式并探讨它们各自的优缺点和适用场景,感兴趣的可以了解一下
2023-11-11
Mybatis-plus与Mybatis依赖冲突问题解决方法
，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧这篇文章主要介绍了Mybatis-plus与Mybatis依赖冲突问题解决方法
2021-04-04