Files
boot/docs/dacli/2/java-web-cross-ref.md
T

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.java 4 字段 (isButtonAuthorize/isColumnAuthorize/isDataAuthorize/isFormAuthorize)

5. 字段源优先级 (重要)

v13.1-13.22 builder (28 个) 字段集来自:

  1. baseline (40 form JSON): 真实实例 (出现频率高的值)
  2. Rxxx.vue: 设计器 schema (字段名/类型)
  3. componentMap.ts: jnpfKey→tag 对照 + 部分 schema

v13.23-13.25 builder (25 个) 字段集来自:

  1. componentMap.ts (主源): 设计器 schema 100% 真实
  2. Rxxx.vue: 运行时真实 schema (event handlers, props, 字典)
  3. 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)