JWT 在 Java Web 开发中的奇妙应用

deer332025-05-22技术文章48

JWT 在 Java Web 开发中的奇妙应用

在当今的互联网世界里，安全始终是一个绕不开的话题。而当我们谈论到 Web 应用的安全性时，认证和授权绝对是其中的核心部分。说到这，我忍不住要给大家讲个笑话：有一天，一个程序员走进酒吧，想要证明自己是真正的顾客。他拿出身份证，结果老板说：“哦，我只能看到你的名字，你还没告诉我密码！”没错，传统的 session 认证方式就像这个故事一样，需要依赖服务器来存储状态信息。

不过，时代在进步，我们的认证方式也跟着进化了。今天，我们就来聊聊 JWT（JSON Web Token）——这位认证界的“新贵”，以及它在 Java Web 开发中的独特魅力。

JWT 是什么？让我们揭开它的神秘面纱

JWT，全称 JSON Web Token，是一种基于 JSON 的轻量级认证机制。它的结构简单但功能强大，由三部分组成：头部（Header）、载荷（Payload）和签名（Signature）。我们不妨把它们想象成一封加密信件的三个部分。

头部：信封上的标签

头部就像是这封信的标签，告诉我们这是一封 JWT。它通常包含两个部分：算法类型和令牌类型。比如：

{
  "alg": "HS256",
  "typ": "JWT"
}

这里的 alg 表示使用 HMAC SHA256 算法签名，而 typ 则表明这是一个 JWT。

载荷：信的内容

接下来就是载荷部分，这里存放的是实际的信息，也就是所谓的声明（Claims）。声明分为三类：注册声明、公共声明和私有声明。举个例子：

{
  "sub": "1234567890",
  "name": "John Doe",
  "iat": 1516239022
}

在这个例子中，sub 表示主题，name 是用户名，iat 表示签发时间戳。

签名：信封上的锁

最后，签名是对前面两部分内容的加密处理，用来验证信息的真实性和完整性。具体过程如下：

HMACSHA256(
  base64UrlEncode(header) + "." +
  base64UrlEncode(payload),
  secret
)

这里 secret 是服务器端保存的秘密密钥，用于生成和验证签名。

JWT 在 Java Web 开发中的应用实例

说了这么多理论知识，咱们还是得来点实际操作。下面我就带大家看看如何在 Spring Boot 中使用 JWT 来实现用户认证。

首先，我们需要添加一些必要的依赖项。在 Maven 项目的 pom.xml 文件中添加以下内容：

<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt</artifactId>
    <version>0.9.1</version>
</dependency>

然后，创建一个工具类来生成和解析 JWT：

import io.jsonwebtoken.Jwts;
import io.jsonwebtoken.SignatureAlgorithm;

import java.util.Date;

public class JwtUtil {
    private static final String SECRET = "mySecretKey";

    public static String generateToken(String username) {
        return Jwts.builder()
                .setSubject(username)
                .setIssuedAt(new Date())
                .signWith(SignatureAlgorithm.HS512, SECRET)
                .compact();
    }

    public static String extractUsername(String token) {
        return Jwts.parser()
                .setSigningKey(SECRET)
                .parseClaimsJws(token)
                .getBody().getSubject();
    }
}

这样，我们就有了生成和解析 JWT 的工具了。接下来，在登录接口中使用这些工具：

@PostMapping("/login")
public ResponseEntity<?> authenticateUser(@RequestBody LoginRequest loginRequest) {
    // 假设我们已经验证了用户名和密码
    String token = JwtUtil.generateToken(loginRequest.getUsername());
    return ResponseEntity.ok(new JwtResponse(token));
}

客户端接收到这个 token 后，就可以将其存储并在后续请求中作为 Authorization Header 发送出去：

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

在每个受保护的接口中，我们可以再次利用 JwtUtil 工具类来提取并验证 token：

@GetMapping("/protected")
public ResponseEntity<String> getProtectedData(@RequestHeader("Authorization") String authorization) {
    String token = authorization.split(" ")[1];
    String username = JwtUtil.extractUsername(token);
    return ResponseEntity.ok("Hello, " + username);
}