快速开始
项目结构详解:五个模块各管什么
eladmin-common、system、logging、tools、generator 五个模块职责划分,以及一次请求从 Controller 到持久层的调用路径。
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。保持这个分层,项目久了也不会乱。
