快速开始

项目结构详解:五个模块各管什么

eladmin-common、system、logging、tools、generator 五个模块职责划分,以及一次请求从 Controller 到持久层的调用路径。

约 2 分钟616 字

eladmin 采用按功能分模块的开发方式。理解每个模块的边界,二次开发时才知道代码该放哪里。

五个核心模块

  • eladmin-common:公共模块。工具类、通用配置、自定义注解与切面、异常处理、基类 Entity/DTO,其他模块都会依赖它。
  • eladmin-system:系统核心模块,也是启动入口。登录授权、系统监控、定时任务、用户/角色/菜单等业务都在这里。
  • eladmin-logging:日志模块,记录操作日志与异常日志,需要时由其他模块引入。
  • eladmin-tools:第三方工具模块,邮件、Amazon S3 云存储、本地存储、支付宝支付。
  • eladmin-generator:代码生成模块,支持生成前后端 CRUD 代码。

一次请求的调用路径

以「查询用户列表」为例:前端 Axios 发请求 → Spring Security 过滤器校验 JWT → Controller 接收 DTO 参数 → Service 处理业务逻辑 → Repository(JPA) 查询数据库 → 统一 Result 包装返回。途中若抛异常,由 common 模块的全局异常处理器拦截,输出统一格式。

在哪里写自己的业务

多数情况下,你在 eladmin-system 下新增业务包,或新建独立模块并在父 pom.xml 里注册。通用能力沉淀到 common,第三方对接放 tools。保持这个分层,项目久了也不会乱。