jjwt -- Token 生成解析技术指南

---

引言

JWT（JSON Web Token）是一种基于JSON的、用于双方之间安全传输信息的简洁的、URL安全的令牌标准。在现代Web应用程序中，JWT作为一种高效且安全的认证机制，被广泛应用于用户身份验证和信息交换场景。本文旨在详细介绍JWT Token的生成与解析过程，为开发者提供一份专业的技术参考。

JJWT简介

JJWT是一个开源的Java库，专门用于处理JSON Web Tokens（JWT）。JWT是一种基于JSON的、用于双方之间安全传输信息的简洁的、URL安全的令牌标准（RFC 7519）。通过JJWT，开发者可以轻松地在Java应用程序中生成、解析和验证JWT。

JWT结构概述

JWT由三个部分组成，它们通过“.”分隔符连接而成：Header（头部）、Payload（负载）和Signature（签名）。

• ‌Header‌：包含令牌的元数据，如签名算法和令牌类型，通常采用Base64Url编码。
• ‌Payload‌：包含实际需要传递的数据，如用户ID、过期时间等官方字段，同样采用Base64Url编码。
• ‌Signature‌：对Header和Payload进行签名，以确保数据的完整性和来源的真实性。签名通常使用指定的算法和密钥生成。

添加依赖

要在Java项目中使用JJWT，首先需要在项目的`pom.xml`文件中添加相应的依赖。以下是一个Maven依赖的示例：

<dependency>
  <groupId>io.jsonwebtoken</groupId>
  <artifactId>jjwt-api</artifactId>
  <version>0.12.3</version>
</dependency>
<dependency>
  <groupId>io.jsonwebtoken</groupId>
  <artifactId>jjwt-impl</artifactId>
  <version>0.12.3</version>
</dependency>
<dependency>
  <groupId>io.jsonwebtoken</groupId>
  <artifactId>jjwt-jackson</artifactId>
  <version>0.12.3</version>
</dependency>

生成Token

使用JJWT生成Token，首先，需要创建一个`Claims`对象来设置Token的负载信息。然后，使用`Jwts.builder()`方法构建Token，并指定签名算法和签名密钥。以下是一个生成Token的示例代码：

/**
     * 生成JWT（JSON Web Token）
     *
     * @param key 用于签名的密钥
     * @return 生成的JWT字符串
     */
    public static String generateToken(Key key) {
   
   
        // 设置JWT的过期时间
        long nowMillis = System.currentTimeMillis();
        Date now = new Date(nowMillis);
        long expMillis = nowMillis + EXPIRATION_TIME; // 1小时后过期
        Date exp = new Date(expMillis);

        // 创建 claims
        Map<String, Object> claims = new HashMap<>();
        claims.put("sub", "subject"); // 设置JWT的主题
        claims.put("name", "Shore");