主题
代码生成
INF-CODEGEN-01 | 模块
infra| 把数据库表一键变成 Controller/Service/Mapper/VO 与前端页面,是本项目扩张功能的主要手段。
1. 使用角色与场景
角色:开发者
- 导入新表并生成后端 CRUD
- 选择 Vue3 + Element Plus 模板生成管理页面
- 主子表结构生成级联保存代码
2. 接口与权限点
| 方法 | 路径 | 权限点 | 摘要 | 代码行 |
|---|---|---|---|---|
| GET | /infra/codegen/db/table/list | infra:codegen:query | 获得数据库自带的表定义列表 | CodegenController#L49 |
| GET | /infra/codegen/table/list | infra:codegen:query | 获得表定义列表 | CodegenController#L64 |
| GET | /infra/codegen/table/page | infra:codegen:query | 获得表定义分页 | CodegenController#L73 |
| GET | /infra/codegen/detail | infra:codegen:query | 获得表和字段的明细 | CodegenController#L81 |
| POST | /infra/codegen/create-list | infra:codegen:create | CodegenController#L93 | |
| PUT | /infra/codegen/update | infra:codegen:update | CodegenController#L100 | |
| PUT | /infra/codegen/sync-from-db | infra:codegen:update | CodegenController#L108 | |
| DELETE | /infra/codegen/delete | infra:codegen:delete | CodegenController#L117 | |
| DELETE | /infra/codegen/delete-list | infra:codegen:delete | CodegenController#L126 | |
| GET | /infra/codegen/preview | infra:codegen:preview | CodegenController#L135 | |
| GET | /infra/codegen/download | infra:codegen:download | CodegenController#L144 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/infra/src/main/java/com/pmforge/module/infra/controller/admin/codegen/CodegenController.java#L49 |
| DO | modules/infra/src/main/java/com/pmforge/module/infra/dal/dataobject/codegen/CodegenTableDO.java |
| DO | modules/infra/src/main/java/com/pmforge/module/infra/dal/dataobject/codegen/CodegenColumnDO.java |
4. 数据表
| 表 | DO |
|---|---|
infra_codegen_table | CodegenTableDO |
infra_codegen_column | CodegenColumnDO |
5. 机制与配置
- 读 information_schema 得到表与字段;模板用 Velocity 渲染
- 模板类型覆盖单表/树/主子表,前端模板 10 套
6. 常见问题与排查
- 表注释与字段注释会直接进代码注释,中文乱码先查连接字符集
- 生成前改包名与模块名,否则会落到默认路径
7. 关联
- 需求原件:02-01-代码生成
- 相关卡片:INF-DEMO-01
- 相关卡片:INF-DEMO-02
- 相关卡片:INF-DEMO-03