Spring Boot JWT 教程

本教程将引导您了解 murraco/spring-boot-jwt 开源项目，该项目演示了如何在 Spring Boot 中集成 JWT（JSON Web Tokens）以实现安全的身份验证。以下是主要内容：

1. 项目目录结构及介绍

spring-boot-jwt/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/
│   │   │       └── example/
│   │   │           └── demo/
│   │   │               ├── config/
│   │   │               │   └── WebSecurityConfig.java # Spring Security 配置
│   │   │               ├── controller/
│   │   │               │   └── AuthController.java    # 登录与认证控制器
│   │   │               ├── repository/
│   │   │               │   └── UserRepository.java   # 用户数据存储接口
│   │   │               ├── service/
│   │   │               │   └── AuthService.java        # 认证服务
│   │   │               └── App.java                  # 应用主入口
│   │   └── resources/
│   │       ├── application.properties         # 应用配置文件
│   │       └── static/                         # 静态资源目录
└── pom.xml                                      # Maven 构建文件

目录结构展示了典型的 Spring Boot 应用结构。核心代码位于 src/main/java/com/example/demo 目录下，包括安全配置、控制器、服务层以及持久化层。

• config/WebSecurityConfig.java: 定义 Spring Security 的过滤规则和访问控制。
• controller/AuthController.java: 处理登录和获取 JWT token 的请求。
• repository/UserRepository.java: 用户数据操作的接口，通常与数据库交互。
• service/AuthService.java: 提供认证相关的业务逻辑。
• App.java: 应用程序的主入口点，用于启动 Spring Boot。

2. 项目的启动文件介绍

在项目中，启动文件是 App.java。它继承自 SpringApplication 类，通过调用 run() 方法启动 Spring Boot 应用。

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class App {
    public static void main(String[] args) {
        SpringApplication.run(App.class, args);
    }
}

@SpringBootApplication 是一个组合注解，包含了 @SpringBootConfiguration, @EnableAutoConfiguration 和 @ComponentScan，这样就能自动配置 Spring Boot 并扫描组件，从而构建整个应用。

3. 项目的配置文件介绍

application.properties 文件位于 src/main/resources 目录下，其中定义了应用程序的基本配置和 Spring Security 相关设置。例如，数据库连接信息、JWT token 的过期时间等可能在此配置。具体的内容将取决于项目实际的配置需求，但常见的一些配置项可能包括：

server.port=8080          # 应用服务器端口
spring.datasource.url=jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=root
spring.jpa.hibernate.ddl-auto=update

# JWT 配置
jwt.secret=mysecretkey     # JWT 签名密钥
jwt.expiration=3600000    # JWT 过期时间，单位为毫秒 (1小时)

您可以根据实际情况修改这些值以适应自己的环境。

接下来，您可以克隆该项目到本地并按照 README.md 的指导进行构建和运行，以亲身体验这个 Spring Boot JWT 示例应用的工作流程。