← 返回学习路线

SYSTEM

整体架构概览

博客系统工程1. 整体架构概览blog-dev
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