docs(codegen): 加 ssw-{appCode} 多模块结构 + POM 依赖层级文档
references/commands.md §1.11: - 表格加 --flat / --multi-module-pom 行 - 加 '多模块结构' 段 (完整目录树 + 归类规则表 + POM 依赖层级) - 加 '完整推荐流程' 段 (一个命令搞定多模块 Java 项目)
This commit is contained in:
1 parent
7c6321707a
commit
2084bd4ef8
1 file changed
+54
@@ -247,6 +247,8 @@ dacli form codegen <formId> [options]
|
||||
| `--dbLinkId <id>` | - | token.dbLinkId | 数据源 ID(BS-48 `default` → token.dbLinkId) |
|
||||
| `--enableFlow <0\|1>` | - | `0` | 是否启用流程 |
|
||||
| `--out <path>` | - | `./generated/${company}-${module}/` | 输出目录 |
|
||||
| `--flat` | - | `false` | **关闭多模块归类**(旧版兼容:文件直接写到 outDir 根)。默认开启多模块归类 |
|
||||
| `--multi-module-pom` | - | `false` | 生成 4 个 pom.xml 占位(parent + entity/biz/controller,严格按 aibridge §POM 依赖规则;与 `--flat` 互斥) |
|
||||
| **`--auto-alias`** ⭐ | - | `false` | **推荐**:从 `form.tables` 自动推导主表别名,写 `base_visual_alias` 表。CodePreview 直接用别名生成代码,无 post-fix |
|
||||
| `--alias-file <path>` | - | - | 从 JSON 文件读 alias 表(格式:`[{table, aliasName, fields?}]`) |
|
||||
| `--alias <json>` | - | - | 直接传 alias JSON 字符串 |
|
||||
@@ -302,6 +304,58 @@ dacli form codegen 808986025610185477 --module=tds --auto-fix-names --mainClassN
|
||||
dacli form codegen 808986025610185477 --module=tds --enable-flow=1 --auto-alias --mainClassName=tdsBilling
|
||||
```
|
||||
|
||||
**多模块结构**(v0.10+ 默认开启,按 aibridge docs/code-rule.md §POM 依赖规则组织):
|
||||
|
||||
```
|
||||
ssw-tds/ # parent (--multi-module-pom 时生成 pom.xml)
|
||||
├── ssw-tds-entity/ # Entity + Model/Form/VO
|
||||
│ ├── pom.xml # (--multi-module-pom 时生成)
|
||||
│ └── src/main/java/ssw/tds/
|
||||
│ ├── entity/{Model}Entity.java
|
||||
│ └── model/{Model}Form.java
|
||||
├── ssw-tds-biz/ # Service + ServiceImpl + Mapper
|
||||
│ ├── pom.xml
|
||||
│ └── src/main/java/
|
||||
│ ├── ssw/tds/service/{Model}Service.java
|
||||
│ ├── ssw/tds/service/impl/{Model}ServiceImpl.java
|
||||
│ └── jnpf/mapper/{Model}Mapper.java # 固定包名 jnpf.mapper
|
||||
└── ssw-tds-controller/ # Controller
|
||||
├── pom.xml
|
||||
└── src/main/java/ssw/tds/controller/{Model}Controller.java
|
||||
```
|
||||
|
||||
**归类规则**(`pathToModule()` 函数):
|
||||
|
||||
| 文件路径特征 | 归到 Maven 模块 |
|
||||
|--------------|-----------------|
|
||||
| `/controller/` 目录 或 `*Controller.java` | `ssw-tds-controller` |
|
||||
| `/service/` 目录 或 `*Service*.java` | `ssw-tds-biz` |
|
||||
| `/mapper/` 目录 或 `*Mapper.{java,xml}` | `ssw-tds-biz` |
|
||||
| `/entity/` 目录 或 `*Entity.java` | `ssw-tds-entity` |
|
||||
| `/model/` 目录 或 `*Form.java` | `ssw-tds-entity` |
|
||||
| 其他 `.xml` 资源 | `ssw-tds-biz`(与 mapper.xml 同目录) |
|
||||
| `.vue`/`.ts`/`.js` 前端文件 | 不归 Maven 模块,写到 outDir 根 |
|
||||
|
||||
**POM 依赖层级**(严格按 aibridge §依赖层级图):
|
||||
|
||||
```
|
||||
controller (ssw-tds-controller) → biz + jnpf-common-all
|
||||
biz (ssw-tds-biz) → entity + fastjson + commons-lang3 + jnpf-common-all
|
||||
entity (ssw-tds-entity) → jnpf-common-all + jnpf-generater-base
|
||||
```
|
||||
|
||||
**完整推荐流程**(一个命令搞定):
|
||||
|
||||
```bash
|
||||
dacli form codegen <formId> \
|
||||
--company=ssw --module=tds \
|
||||
--auto-alias --mainClassName=tdsBilling \
|
||||
--multi-module-pom \
|
||||
--enable-flow=0
|
||||
# 输出到 ./generated/ssw-tds/, 含 4 个 pom.xml + 完整多模块 Java 结构
|
||||
# 直接 mvn package 即可编译
|
||||
```
|
||||
|
||||
**JNPF alias 系统与 aibridge 命名约定的差异**:
|
||||
|
||||
| 维度 | aibridge docs/code-rule.md | JNPF `base_visual_alias` |
|
||||
|
||||
Reference in new issue
Block a user