11 KiB
11 KiB
v13 Java Builder ↔ JNPF Web 代码 速查对照表
用途: 后续 v14 维护/扩展时, 找 Java builder 对应的前端 Rxxx.vue / componentMap.ts 行号 生成: 2026-06-12 (v13.25 完成 53 FieldBuilder + 5 menu builder + 4 特殊 builder) 状态: 100% 覆盖 (53 控件 + 7 特殊 builder 全部映射到前端 source)
1. 目录结构总览
boot/ssw-dacli/src/main/java/ssw/dacli/
├── form/builder/
│ ├── FieldBuilder.java (接口)
│ ├── FieldBuilderFactory.java (SPI 工厂)
│ ├── FieldBuildContext.java (字段定义上下文)
│ ├── field/ (53 FieldBuilder)
│ ├── column/ (ColumnDataBuilder)
│ ├── table/ (SubTableFieldBuilder)
│ ├── flow/ (FlowTemplateJsonBuilder)
│ ├── system/ (SystemColumnBuilder)
│ └── reverse/ (FormReverseDebugger + Report)
└── menu/builder/
├── MenuBuilder.java (接口)
├── MenuBuilderFactory.java (SPI 工厂)
├── MenuBuildContext.java
├── PropertyJsonBuilder.java (共享)
├── AuthorizeFieldsBuilder.java (共享)
├── WebMenuBuilder.java
├── NoSpaMenuBuilder.java
├── DataReportMenuBuilder.java
├── LinkMenuBuilder.java
├── ButtonMenuBuilder.java
└── reverse/ (MenuReverseDebugger + Report)
2. Java FieldBuilder ↔ JNPF Rxxx.vue 完整对照 (53 个)
命名规则:
<Xxx>FieldBuilder↔R<Xxx>.vue(PascalCase) 字段源: 优先Rxxx.vue(运行时真实 schema), 次选componentMap.ts(设计器 schema)
2.1 v13.1-13.22 (28 P0/P1/P2 字段集)
| # | Java FieldBuilder | jnpfKey | 前端 Rxxx.vue | componentMap.ts 行号 | 字段统计 |
|---|---|---|---|---|---|
| 1 | InputFieldBuilder |
input | RInput.vue |
line 1130+ | 43 字段 (21+22) |
| 2 | InputNumberFieldBuilder |
inputNumber | RInputNumber.vue |
line 1220+ | 33 字段 |
| 3 | TextareaFieldBuilder |
textarea | RTextarea.vue |
line 2080+ | 29 字段 |
| 4 | DatePickerFieldBuilder |
datePicker | RDatePicker.vue |
line 1840+ | 37 字段 |
| 5 | TimePickerFieldBuilder |
timePicker | RTimePicker.vue |
line 2030+ | 37 字段 |
| 6 | UploadFileFieldBuilder |
uploadFile | RUploadFile.vue |
line 2165+ | 36 字段 |
| 7 | UploadImgFieldBuilder |
uploadImg | RUploadImg.vue |
line 2200+ | 36 字段 |
| 8 | RelationFormFieldBuilder |
relationForm | RRelationForm/ |
line 1175+ | 44 字段 (两阶段) |
| 9 | PopupTableFieldBuilder |
popupTable | Jnpf/popupTable/ |
line 1400+ | 45 字段 (两阶段) |
| 10 | PopupSelectFieldBuilder |
popupSelect | RPopupSelect.vue |
line 1440+ | 中 |
| 11 | PopupAttrFieldBuilder |
popupAttr | RPopupAttr.vue |
line 1480+ | 中 |
| 12 | RelationFormAttrFieldBuilder |
relationFormAttr | RRelationFormAttr.vue |
line 1280+ | 中 |
| 13 | RelationQueryFieldBuilder |
relationQuery | RRelationQuery/ |
line 1320+ | 中 |
| 14 | AutoCompleteFieldBuilder |
autoComplete | RAutoComplete.vue |
line 1240+ | 32 字段 |
| 15 | InputTableFieldBuilder |
inputTable | Jnpf/InputTable/ |
line 1380+ | 40 字段 |
| 16 | OrganizeFieldBuilder |
organize | Jnpf/organize/ |
line 1450+ | 中 |
| 17 | LocationFieldBuilder |
location | Jnpf/location/ |
line 1340+ | 中 |
| 18 | AreaSelectFieldBuilder |
areaSelect | RAreaSelect.vue |
line 1610+ | 中 |
| 19 | SignatureFieldBuilder |
signature | Jnpf/signature/ |
line 1800+ | 中 |
| 20 | SignFieldBuilder |
sign | Jnpf/sign/ |
line 1820+ | 中 |
| 21 | OcrFieldBuilder |
ocr | Jnpf/ocr/ |
line 1680+ | 中 |
| 22 | CalculateFieldBuilder |
calculate | Jnpf/calculate/ |
line 1650+ | 中 |
| 23 | DateCalculateFieldBuilder |
dateCalculate | Jnpf/dateCalculate/ |
line 1740+ | 中 |
| 24 | I18nInputFieldBuilder |
i18nInput | Jnpf/i18nInput/ |
line 1270+ | 中 |
| 25 | CarouselFieldBuilder |
carousel | Jnpf/carousel/ |
line 887+ | 中 (4 P2 装饰) |
| 26 | ColorPickerFieldBuilder |
colorPicker | RColorPicker.vue |
line 604+ | 中 |
| 27 | RateFieldBuilder |
rate | RRate.vue |
line 631+ | 低 |
| 28 | SliderFieldBuilder |
slider | RSlider.vue |
line 661+ | 低 |
2.2 v13.23 P0 7 盲点 (完整字段集)
| # | Java FieldBuilder | jnpfKey | 前端 Rxxx.vue | componentMap.ts 行号 | 字段统计 |
|---|---|---|---|---|---|
| 29 | SelectFieldBuilder |
select | RSelect.vue |
line 324 | 44 字段 (19+25) |
| 30 | UserSelectFieldBuilder |
userSelect | Jnpf/userSelect/ |
line 1026 | 35 字段 (15+20) |
| 31 | GroupTitleFieldBuilder |
groupTitle | RGroupTitle.vue |
line 1910 | 18 字段 (5+13) |
| 32 | RadioFieldBuilder |
radio | RRadio.vue |
line 221 | 47 字段 (18+29) |
| 33 | DividerFieldBuilder |
divider | RDivider.vue |
line 1931 | 16 字段 (4+12) |
| 34 | TableGridFieldBuilder |
tableGrid | RTableGrid.vue + RTableGridTd.vue |
line 2114 | 17+ 字段 (嵌套 tr/td) |
| 35 | CascaderFieldBuilder |
cascader | RCascader.vue |
line 377 | 44 字段 (18+26) |
2.3 v13.24 P1 11 控件 (完整字段集)
| # | Java FieldBuilder | jnpfKey | 前端 Rxxx.vue | componentMap.ts 行号 | 字段统计 |
|---|---|---|---|---|---|
| 36 | CheckboxFieldBuilder |
checkbox | RCheckbox.vue |
line 274 | 40 字段 (14+26) |
| 37 | SwitchFieldBuilder |
switch | RSwitch.vue |
line 189 | 29 字段 (6+23) |
| 38 | EditorFieldBuilder |
editor | REditor.vue |
line 692 | 28 字段 (5+23) |
| 39 | TreeSelectFieldBuilder |
treeSelect | RTreeSelect.vue |
line 1190 | 47 字段 (22+25) |
| 40 | IframeFieldBuilder |
iframe | RIframe.vue |
line 1596 | 24 字段 (5+19) |
| 41 | StepsFieldBuilder |
steps | RSteps.vue |
line 2032 | 24 字段 (5+19) |
| 42 | RowFieldBuilder |
row | RRow.vue |
line 2074 | 16 字段 (3+13) |
| 43 | TabFieldBuilder |
tab | RTab.vue |
line 1992 | 19 字段 (5+14) |
| 44 | OrgRightFieldBuilder |
orgRight | ROrgRight.vue |
line 954 | 38 字段 (16+22) |
| 45 | LinkFieldBuilder |
link | RLink.vue |
line 719 | 21 字段 (7+14) |
| 46 | QrcodeFieldBuilder |
qrcode | RQrcode.vue |
line 831 | 23 字段 (9+14) |
2.4 v13.25 P2 7 装饰 (layout="rowFormItem")
| # | Java FieldBuilder | jnpfKey | 前端 Rxxx.vue | componentMap.ts 行号 | 字段统计 |
|---|---|---|---|---|---|
| 47 | AlertFieldBuilder |
alert | RAlert.vue |
line 806 | 20 字段 (6+14) |
| 48 | BarcodeFieldBuilder |
barcode | RBarcode.vue |
line 858 | 21 字段 (7+14) |
| 49 | BillRuleFieldBuilder |
billRule | RBillRule.vue |
line 1876 | 21 字段 (3+18, tag='JnpfInput') |
| 50 | ButtonFieldBuilder |
button | RButton.vue |
line 747 | 21 字段 (4+17) |
| 51 | CardFieldBuilder |
card | RCard.vue |
line 2093 | 15 字段 (2+13, tag='ACard') |
| 52 | CollapseFieldBuilder |
collapse | RCollapse.vue |
line 1951 | 18 字段 (4+14, tag='ACollapse') |
| 53 | TextFieldBuilder |
text | RText.vue |
line 776 | 18 字段 (2+16, textStyle 7 字段) |
3. Java 特殊 Builder ↔ JNPF 后端 (4 个)
这些是辅助 builder, 不是 SPI 注册的 FieldBuilder
| # | Java Builder | 用途 | 字段源 | 字段统计 |
|---|---|---|---|---|
| S1 | ColumnDataBuilder |
列表列 50+ 字段 | jnpf/前端/jnpf-web-apps-main/src/components/FormGenerator/src/helper/componentMap.ts 60 项 jnpfKey→tag 对照 |
53 字段 (31+22) |
| S2 | SubTableFieldBuilder |
主子表 (form.items.children) | RTableGrid.vue + RTableGridTd.vue (子表布局) |
25+ 字段 |
| S3 | FlowTemplateJsonBuilder |
工作流模板 (formData.flowTemplateJson) | Flowable BPMN 简化 (start+userTask+end) | 14 字段 |
| S4 | SystemColumnBuilder |
11 系统列 (dm create 自动补) | jnpf/后端/.../visualdev/VisualDevInfoVO.java + DmCommand.ensureRuntimeColumns |
11 字段 (枚举) |
| S5 | FormReverseDebugger |
form info 反向调试器 | 解析 formData, 定位未打磨 jnpfKey | (无 builder 字段, 仅分析) |
| S6 | MenuReverseDebugger |
menu info 反向调试器 | 解析 menu JSON, 6 维度校验 | (无 builder 字段, 仅分析) |
4. Java Menu Builder ↔ JNPF Web 完整对照 (5 个)
Menu Builder 处理
category/type字段, 对应 JNPF 后端permission/.../Menu表
| # | Java MenuBuilder | category | type | 前端对应 | JNPF 后端 model |
|---|---|---|---|---|---|
| M1 | WebMenuBuilder |
Web | 1/2/3 | jnpf/前端/jnpf-web-apps-main/src/views/menu/components/FormMenu/index.vue |
VisualDevMenuModel.java (type 字段) |
| M2 | NoSpaMenuBuilder |
Web | 7 | 同上 + linkTarget=_self |
同上 (type=7) |
| M3 | DataReportMenuBuilder |
Web/App | 10/8 | DataReport/portal 路由 |
DataReportModel.java |
| M4 | LinkMenuBuilder |
Web | 7 (外链) | linkTarget=_blank |
同 WebMenu |
| M5 | ButtonMenuBuilder |
Web | 0 | 无 urlAddress | 同 WebMenu |
共享 builder:
PropertyJsonBuilder↔FormMenu/index.vue字段 3-4 字段 (moduleId/iconBackgroundColor/isTree/webType)AuthorizeFieldsBuilder↔jnpf/后端/.../permission/...Menu.java4 字段 (isButtonAuthorize/isColumnAuthorize/isDataAuthorize/isFormAuthorize)
5. 字段源优先级 (重要)
v13.1-13.22 builder (28 个) 字段集来自:
- baseline (40 form JSON): 真实实例 (出现频率高的值)
- Rxxx.vue: 设计器 schema (字段名/类型)
- componentMap.ts: jnpfKey→tag 对照 + 部分 schema
v13.23-13.25 builder (25 个) 字段集来自:
- componentMap.ts (主源): 设计器 schema 100% 真实
- Rxxx.vue: 运行时真实 schema (event handlers, props, 字典)
- baseline (辅助): 出现次数标注
v14 维护建议:
- 改 builder 字段集时, 先看 Rxxx.vue (运行时真实) → componentMap.ts (设计器 schema) → baseline (实例) 三层
- 不要直接用 v13 简化版字段集 (会导致 v14 补完后, 老 builder 字段集不准)
6. 速查命令
# 1. 找 Java builder 对应 Rxxx.vue
ls boot/ssw-dacli/src/main/java/ssw/dacli/form/builder/field/ | grep "Select"
# → SelectFieldBuilder.java
# 2. 找 Rxxx.vue 对应 componentMap.ts 行号
grep -A 1 "jnpfKey.*'select'\|jnpfKey.*'userSelect'" jnpf/前端/jnpf-web-apps-main/src/components/FormGenerator/src/helper/componentMap.ts
# 3. mvn test 全集
mvn test -pl ssw-dacli -q
# → 261/261 PASS (v13.25 完成)
# 4. 浏览器层 E2E 验证
python3 .claude/skills/ssw-e2e-test/scripts/jnpf_browser_e2e.py verify-form \
--app=tds --form-id=835013439305819013 \
--menu-name="数据资产管理" \
--session=/tmp/v13-tds-session.json \
--expected-labels=资产编码,资产名称
# → 7/7 label 0 误差 PASS
7. 总结
| 维度 | 数量 | 状态 |
|---|---|---|
| Java FieldBuilder | 53 | ✅ 100% 映射 Rxxx.vue / componentMap.ts |
| Java 特殊 Builder | 6 | ✅ ColumnData/SubTable/Flow/System + 2 Reverse |
| Java MenuBuilder | 5 | ✅ Web/NoSpa/DataReport/Link/Button + 2 共享 |
| 总 builder 文件 | 64 | ✅ 100% 覆盖 JNPF 设计器右栏 50 控件 + Jnpf/ 目录 20 子控件 |
| mvn test | 261/261 PASS | ✅ |
| tds 浏览器层 0 误差 | 7/7 label | ✅ |
| baseline 覆盖率 | 90% → 100% (v13.25) | ✅ |
v14 候选:
- 补 7 字段未覆盖 (worktree 拼装, 离线表等)
- 修 v13.25 冲突遗留 (UserSelectFieldBuilder-output.json)
- 跑 tds 真实业务 E2E (Playwright CRUD 5 forms)