Java后端中提取请求头Cookie与Token全攻略

下面介绍 Java 后端 中如何提取请求头中的 Cookie 与 Token 的详细方法与原理。本文从原生 Servlet API 到基于 Spring Boot 的实现进行了全面阐述，每一步均附上详细注释和解析，确保您能够精准掌握核心技术。😊

1. 使用 Servlet API 提取 Cookie 与 Token

在 Java Web 开发中，HttpServletRequest 对象提供了直接操作请求头的方法，可以用来提取 Cookie 和 Token 信息。

示例代码

// 从请求中获取所有的 Cookie 信息
Cookie[] cookies = request.getCookies(); // 获取所有 Cookie 数组
if (cookies != null) {
    // 遍历 Cookie 数组，查找指定名称的 Cookie
    for (Cookie cookie : cookies) {
        // 判断当前 Cookie 名称是否匹配目标名称 <font color="red">yourCookieName</font>
        if ("<font color="red">yourCookieName</font>".equals(cookie.getName())) {
            // 获取 Cookie 的值
            String cookieValue = cookie.getValue();
            // 这里可以加入对 cookieValue 的业务处理逻辑
        }
    }
}

// 提取 Token 通常放在请求头中的 Authorization 字段
String token = request.getHeader("<font color="red">Authorization</font>");
if (token != null && token.startsWith("Bearer ")) { // 判断 Token 是否以 "Bearer " 开头
    // 去除前缀 "Bearer "，提取纯 Token 字符串
    token = token.substring(7);
    // 这里可以加入对 token 的业务处理逻辑
}

代码解释

• Cookie 部分：

  • request.getCookies() 方法返回所有 Cookie 数组；
  • 通过循环遍历，判断 Cookie 名称是否等于 <font color="red">yourCookieName</font>；
  • 使用 cookie.getValue() 获取具体的 Cookie 值，用于后续处理。

• Token 部分：

  • request.getHeader("Authorization") 直接从请求头中获取 Token；
  • 判断 Token 是否以 "Bearer " 开头，如果是，则通过 substring(7) 截取出实际的 Token 值。

2. 使用 Spring Boot 快速获取请求头数据

在 Spring Boot 中，我们可以利用注解实现对请求头的直接提取，从而提高代码的简洁性和可维护性。

示例代码

import javax.servlet.http.Cookie;
import javax.servlet.http.HttpServletRequest;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestHeader;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class DemoController {

    // 定义 GET 接口 /extract 用于提取 Cookie 与 Token
    @GetMapping("/extract")
    public String extractData(
        // 使用 @RequestHeader 注解直接提取请求头中的 Token 值，允许为空
        @RequestHeader(value = "Authorization", required = false) String token,
        // 注入 HttpServletRequest 对象，用于提取 Cookie
        HttpServletRequest request) {

        String cookieValue = null;
        // 获取所有 Cookie
        Cookie[] cookies = request.getCookies();
        if (cookies != null) {
            // 遍历 Cookie 数组，查找名称为 <font color="red">yourCookieName</font> 的 Cookie
            for (Cookie cookie : cookies) {
                if ("<font color="red">yourCookieName</font>".equals(cookie.getName())) {
                    cookieValue = cookie.getValue();
                    break;
                }
            }
        }
    
        // 处理 Token：判断是否存在且以 "Bearer " 开头
        if (token != null && token.startsWith("Bearer ")) {
            token = token.substring(7); // 截取实际的 Token 值
        }
    
        // 返回提取的 Cookie 与 Token 信息
        return "Cookie: " + cookieValue + " ; Token: " + token;
    }
}

代码解释

• @RequestHeader 注解：

  • 直接从请求头中获取名为 "Authorization" 的值，并允许为空（required = false），避免因缺失而引发异常。

• Cookie 提取：

  • 利用 HttpServletRequest.getCookies() 获取所有 Cookie，并遍历查找目标 Cookie；
  • 找到后通过 cookie.getValue() 获取值，存储后用于业务逻辑处理。

• Token 处理：

  • 通过判断字符串是否以 "Bearer " 开头，将 Token 的前缀去除后提取实际 Token 值。

3. 原理解释表

下表总结了提取 Cookie 与 Token 的工作原理与各步骤的重要性：

图解说明

• A 到 B： 接收请求并获取 HttpServletRequest 对象，为后续数据提取提供基础。
• B 到 C-D-E-F： 提取 Cookie 过程，通过数组遍历查找指定 Cookie 并提取其值。
• B 到 G-H-I： 提取 Token 过程，通过请求头直接获取 Token，然后去除前缀获取实际 Token 值。
• F 与 I 到 J： 将提取的数据汇总后进行后续的业务处理。

5. 实用建议与注意事项

• 安全性：
  对提取的 Cookie 与 Token 值应进行严格验证与加密处理，防止恶意篡改或泄漏。
• 异常处理：
  处理过程中可能遇到空指针或格式错误，建议增加必要的判断和异常捕获机制。
• 日志记录：
  为方便排查问题，可以在业务处理时记录关键信息，但应避免记录敏感数据。
• 代码复用：
  建议封装常用的提取逻辑为工具方法，以提高代码复用性和维护效率。

通过以上详细说明与示例，您可以清晰地了解在 Java 后端 中如何精准提取请求头中的 Cookie 与 Token。每一步的实现都经过严格推理与验证，确保在实际开发中既实用又安全。希望本攻略对您的开发工作能带来帮助！💡