SYSTEM
整体架构概览
src/content/notes/blog-dev/整体架构概览.md 1. 整体架构概览
项目采用经典的三层架构,分层职责如下:
┌─────────────────────────────────────────────────┐
│ 客户端 (Vue 3) │
│ 发送 HTTP 请求,携带 JWT Token │
└──────────────────────┬──────────────────────────┘
│ HTTP / HTTPS
┌──────────────────────▼──────────────────────────┐
│ Spring Security Filter Chain │
│ ┌─────────────────────────────────────────────┐ │
│ │ JwtAuthenticationFilter │ │
│ │ 1. 提取 Authorization 头 │ │
│ │ 2. 去除 Bearer 前缀 │ │
│ │ 3. 验证 Token 有效性 │ │
│ │ 4. 解析 userId + role → SecurityContext │ │
│ └─────────────────────────────────────────────┘ │
└──────────────────────┬──────────────────────────┘
│
┌──────────────────────▼──────────────────────────┐
│ Controller 层 (接口层) │
│ 接收请求,参数校验,调用 Service,返回 Result<T> │
└──────────────────────┬──────────────────────────┘
│
┌──────────────────────▼──────────────────────────┐
│ Service 层 (业务逻辑层) │
│ 核心业务逻辑,缓存策略,分布式锁,布隆过滤器 │
└──────────────────────┬──────────────────────────┘
│
┌──────────┬───────────▼────────────┬──────────────┐
│ MySQL │ Redis │ Redisson │
│ 持久化 │ 缓存/分布式锁/空值 │ 布隆过滤器 │
└──────────┴────────────────────────┴──────────────┘
分层职责表
| 层级 | 包路径 | 职责 | 关键类 |
|---|---|---|---|
| Entity | entity |
数据模型,与数据库表映射 | User, Article, Category, Comment, Notice, SiteConfig |
| Repository | repository |
数据访问,继承 JpaRepository | UserRepository, ArticleRepository 等 |
| Service | service/impl |
业务逻辑,事务管理 | UserServiceImpl, ArticleServiceImpl 等 |
| Controller | controller |
接口定义,权限控制 | UserController, ArticleController 等 |
| Common | common |
工具类,统一封装 | Result, JwtUtil, RedisUtil, BloomFilterUtil, UserPrincipal |
| Config | config |
安全与中间件配置 | SecurityConfig, JwtAuthenticationFilter, RedisConfig, RedissonConfig |