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的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

Spring Task定时任务开发实战教程
文章介绍了SpringTask,这是Spring框架提供的用于实现定时任务的模块,它基于注解和配置方式,简化了任务调度的实现,本文结合实例代码给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧
2026-03-03
Java数据结构之二叉排序树的实现
二叉排序树（Binary Sort Tree），又称二叉查找树（Binary Search Tree），亦称二叉搜索树。本文详细介绍了二叉排序树的原理，并且提供了Java代码的完全实现。需要的可以参考一下
2022-01-01
Python机器学习三大件之二pandas
这篇文章主要介绍了Python机器学习三大件之二pandas,文中有非常详细的代码示例,对正在学习Python的小伙伴们有很好地帮助,需要的朋友可以参考下
2021-05-05
centos上安装配置java WEB环境
前提是centos6.3系统已经安装好，在这里以64位系统为例，下面是jdk，tomcat，mysql下载安装步骤，有需要的小伙伴可以参考下
2016-10-10
SSM框架流程及原理分析
本文给大家分享小编一些心得体会，主要是学习SSM框架之后的收获吧，重点给大家介绍SSM框架流程以及原理分析，通过图文实例相结合给大家介绍的非常详细，需要的朋友参考下吧
2021-06-06
MyBatis框架简介及入门案例详解
MyBatis是一个优秀的持久层框架，它对jdbc的操作数据库的过程进行封装，使开发者只需要关注SQL本身，而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码，本文将作为最终篇为大家介绍MyBatis的使用
2022-08-08
使用Java解决数组旋转问题的方法详解
给定一个包含n个整数的数组,要求将数组中的元素向前移动m个位置,即数组的前n-m个元素顺序向后移动m个位置,最后m个元素移动到数组的最前面,本文给大家介绍了如何使用Java解决数组旋转问题,需要的朋友可以参考下
2026-03-03
使用MyBatis快速生成代码的几种方法
本文主要介绍了如何使用MyBatis快速生成代码的几种方法,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
2023-12-12
多数据源如何实现事务管理
Spring中涉及三个核心事务处理接口：PlatformTransactionManager、TransactionDefinition和TransactionStatus,PlatformTransactionManager提供事务操作的基本方法,如获取事务、提交和回滚
2024-09-09
在Mybatis使用Integer与''进行比较的坑及解决
这篇文章主要介绍了在Mybatis使用Integer与''进行比较的坑及解决方案，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-03-03