Files
eip4-platform/tools/s3_rewriter/rewrite.py
zhengwr 252e55cff5 F2-3(规则族): 动态按钮族/comboBox深层访问族扩展,HARD 86→74,自动化率 81.1%→82.7%
规则族2(动态按钮): new Button + addClickListener + fieldVar.addButton(btnVar, N)
  → addFieldButton("FIELD", "文案", {闭包体}, N),命中 33 次,HARD→FULL_AUTO/PARTIAL -12

规则族3(深层访问): .comboBox.setValue → setFieldValue,.comboBox.removeItem → removeFieldItem
  命中 6 次,5 个 PARTIAL 模板升为 FULL_AUTO

安全约束: 三元组不完整/来源不明/vl.addComponent 型一律保留 HARD,零误改
测试: 118 单测全绿(新增 13 条),output_staging 不入库

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 21:41:16 +08:00

1144 lines
49 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""
S3 脚本正则改写器 — rewrite.py
将 Groovy S3 脚本(直接调 Vaadin API)改写为 S2 形态(facade 辅助函数调用)。
分类标签:
FULL_AUTO — 全部 S3 模式改写成功,无遗留
PARTIAL — 部分改写成功,仍有 S3 片段待人工处理
HARD — 命中硬 S3 特征(动态 Vaadin 组件/确认框),整条转人工
NO_S3 — 未检测到任何 S3 模式,原样返回
用法:
from rewrite import rewrite_script
text, details, label = rewrite_script(groovy_src)
"""
import re
from dataclasses import dataclass, field
from typing import List, Tuple
# ──────────────────────────────────────────────
# 1. 硬 S3 检测模式(命中即整条转人工)
#
# 注意: Button 已从 HARD 列表移除 ——
# 规则族2(动态按钮家族)可将"new Button + addClickListener + fieldVar.addButton"
# 整体改写为 addFieldButton(field, label, {闭包}),改写成功后不再是 HARD。
# 若改写后仍剩余 new Button(不属于可识别模式),残留检测会降级为 PARTIAL。
# ──────────────────────────────────────────────
HARD_S3_PATTERNS: List[Tuple[str, str]] = [
# 动态创建 Vaadin 组件(排除 Button,Button 由规则族2 处理)
(r"\bnew\s+(Window|ComboBox|TextField|Label|Table|Panel|"
r"VerticalLayout|HorizontalLayout|FormLayout|GridLayout|"
r"AbsoluteLayout|TabSheet|Accordion|PopupView|Upload|"
r"ProgressBar|Slider|DateField|CheckBox|OptionGroup|"
r"TwinColSelect|ListSelect|NativeSelect|PasswordField|"
r"RichTextArea|TextArea|InlineDateField|Link|Embedded|"
r"MenuBar|Tree|TreeTable|SplitPanel|HorizontalSplitPanel|"
r"VerticalSplitPanel|Notification)\b",
"动态创建 Vaadin 组件"),
# showConfirmDialog: 同步确认框,无法用规则族2改写(闭包语义需 Java 侧实现)
# 当独立出现(脚本中无 new Button)时直接 HARD;
# 当与 new Button 同时出现时,规则族2 先改写 Button,改写后
# showConfirmDialog 变成 addFieldButton 闭包体内部的普通语句,无需再 HARD。
# 因此此处只检测:不在已改写的 addFieldButton 闭包内的 showConfirmDialog。
# 实现上:在规则族2 改写之后,若文本中仍直接含 showConfirmDialog(非闭包内)才 HARD。
# 简化实现:规则族2 改写后,若仍有独立 showConfirmDialog 才列为 HARD 原因(见 5.1 逻辑)。
(r"\bshowConfirmDialog\b", "同步确认框 showConfirmDialog"),
(r"\bUI\.getCurrent\(\)", "UI.getCurrent()"),
]
# ──────────────────────────────────────────────
# 2. 数据表驱动改写规则(按优先级顺序)
# 每条规则: (规则名, 正则模式, 替换模板或替换函数)
#
# 占位符约定:
# {FIELD} — 字段名字符串(含引号),如 "PROJ_NAME"
# {ARG} — 单参数
# {ARGS} — 多参数(逗号分隔)
# {VAR} — Groovy 变量名
# ──────────────────────────────────────────────
@dataclass
class RewriteRule:
name: str
pattern: re.Pattern
replacement: str # 可含 \1 \2 等反向引用,或直接是字符串
def _make_field_rules() -> List[RewriteRule]:
"""生成字段句柄链式调用规则表(数据表驱动)。
形态说明(真实库实测,2026-06-11):
- 字段句柄链同时存在普通点 `.` 与 Groovy 安全导航 `?.`,二者语义在
facade 形态下等价(facade 内部处理空值),因此每条字段规则用 NAV 占位
统一匹配两者。真实库 266/400 字段链调用使用 `?.`,不支持则丢失约半数。
"""
# field_ref 匹配: group.getField("X") 或 group.getField('X')
# NAV 同时匹配 `.` 与 `?.`,并允许中间空白(真实库有换行/空格变体)。
fref = r'group\.getField\((["\'][^"\']+["\'])\)'
NAV = r'\s*\??\.\s*'
rules: List[RewriteRule] = []
# ── 2.1 addButton(字段内联按钮)─────────────────────────────
# group.getField("X").addButton("label", handler)
# → addFieldButton("X", "label", handler)
# 注意: 仅当首参为字符串字面量(按钮文案)时才视为字段按钮。
# 形如 addButton(group.getField("SELECT"),0) 是子表动作按钮(另规则)。
rules.append(RewriteRule(
name="addButton",
pattern=re.compile(
fref + NAV + r'addButton\(\s*(["\'][^"\']*["\'][^)]*)\)',
re.DOTALL
),
replacement=r'addFieldButton(\1, \2)',
))
# ── 2.1b addSubTableButton(子表动作按钮)────────────────────
# group.getField("LIST").addButton(group.getField("SELECT"), 0)
# → addSubTableButton("LIST", "SELECT", 0)
# 真实库子表挂载选择/新增按钮的写法,首参是另一个字段句柄。
rules.append(RewriteRule(
name="addSubTableButton",
pattern=re.compile(
fref + NAV +
r'addButton\(\s*group\.getField\((["\'][^"\']+["\'])\)\s*,\s*([^)]+)\)',
re.DOTALL
),
replacement=r'addSubTableButton(\1, \2, \3)',
))
# ── 2.2 getValue ───────────────────────────────────────────
# group.getField("X").getValue() → getFieldValue("X")
rules.append(RewriteRule(
name="getValue",
pattern=re.compile(fref + NAV + r'getValue\(\)'),
replacement=r'getFieldValue(\1)',
))
# ── 2.3 setValue ───────────────────────────────────────────
# group.getField("X").setValue(v) → setFieldValue("X", v)
rules.append(RewriteRule(
name="setValue",
pattern=re.compile(fref + NAV + r'setValue\(([^)]+)\)'),
replacement=r'setFieldValue(\1, \2)',
))
# ── 2.4 setVisible ─────────────────────────────────────────
# group.getField("X").setVisible(b) → setFieldVisible("X", b)
rules.append(RewriteRule(
name="setVisible",
pattern=re.compile(fref + NAV + r'setVisible\(([^)]+)\)'),
replacement=r'setFieldVisible(\1, \2)',
))
# ── 2.5 setCaption ─────────────────────────────────────────
# group.getField("X").setCaption(s) → setFieldCaption("X", s)
rules.append(RewriteRule(
name="setCaption",
pattern=re.compile(fref + NAV + r'setCaption\(([^)]+)\)'),
replacement=r'setFieldCaption(\1, \2)',
))
# ── 2.6 setEnabled / setReadOnly ───────────────────────────
# group.getField("X").setEnabled(b) → setFieldEnabled("X", b)
rules.append(RewriteRule(
name="setEnabled",
pattern=re.compile(fref + NAV + r'setEnabled\(([^)]+)\)'),
replacement=r'setFieldEnabled(\1, \2)',
))
# group.getField("X").getPropertyDataSource().setReadOnly(b)
# → setFieldReadOnly("X", b)
# 真实库"把字段底层属性置只读"的等价惯用写法,须先于裸 setReadOnly 规则,
# 否则中间的 getPropertyDataSource() 会阻断匹配。
rules.append(RewriteRule(
name="propertyDataSource_setReadOnly",
pattern=re.compile(
fref + NAV + r'getPropertyDataSource\(\)' + NAV + r'setReadOnly\(([^)]+)\)'),
replacement=r'setFieldReadOnly(\1, \2)',
))
# group.getField("X").setReadOnly(b) → setFieldReadOnly("X", b)
rules.append(RewriteRule(
name="setReadOnly_field",
pattern=re.compile(fref + NAV + r'setReadOnly\(([^)]+)\)'),
replacement=r'setFieldReadOnly(\1, \2)',
))
# ── 2.7 setRequired / setRequiredError ─────────────────────
# group.getField("X").setRequired(b) → setFieldRequired("X", b)
rules.append(RewriteRule(
name="setRequired",
pattern=re.compile(fref + NAV + r'setRequired\(([^)]+)\)'),
replacement=r'setFieldRequired(\1, \2)',
))
# group.getField("X").setRequiredError(msg) → setFieldRequiredError("X", msg)
rules.append(RewriteRule(
name="setRequiredError",
pattern=re.compile(fref + NAV + r'setRequiredError\(([^)]+)\)', re.DOTALL),
replacement=r'setFieldRequiredError(\1, \2)',
))
# ── 2.8 getContainerDataSource().setFilter / removeAllItems ─
# group.getField("X").getContainerDataSource().setFilter(...)
# → setFieldDataFilter("X", ...)
rules.append(RewriteRule(
name="setFilter",
pattern=re.compile(
fref + NAV + r'getContainerDataSource\(\)' + NAV + r'setFilter\(([^)]*)\)',
re.DOTALL
),
replacement=r'setFieldDataFilter(\1, \2)',
))
# group.getField("X").getContainerDataSource().removeAllItems()
# → clearFieldData("X")
rules.append(RewriteRule(
name="removeAllItems_ds",
pattern=re.compile(
fref + NAV + r'getContainerDataSource\(\)' + NAV + r'removeAllItems\(\)'
),
replacement=r'clearFieldData(\1)',
))
# group.getField("X").removeAllItems() (无中间 getContainerDataSource)
# → clearFieldData("X") — 真实库下拉清空常见简写
rules.append(RewriteRule(
name="removeAllItems",
pattern=re.compile(fref + NAV + r'removeAllItems\(\)'),
replacement=r'clearFieldData(\1)',
))
# ── 2.9 getContainerDataSource (裸取数据源) ─────────────────
# group.getField("X").getContainerDataSource()
# → getFieldDataSource("X")
rules.append(RewriteRule(
name="getContainerDataSource",
pattern=re.compile(fref + NAV + r'getContainerDataSource\(\)'),
replacement=r'getFieldDataSource(\1)',
))
# ── 2.10 getDisplay ────────────────────────────────────────
# group.getField("X").getDisplay() → getFieldDisplay("X")
rules.append(RewriteRule(
name="getDisplay",
pattern=re.compile(fref + NAV + r'getDisplay\(\)'),
replacement=r'getFieldDisplay(\1)',
))
# ── 2.10b showAddButton(子表新增按钮显隐)──────────────────
# group.getField("X").showAddButton(b) → setSubTableAddButtonVisible("X", b)
rules.append(RewriteRule(
name="showAddButton",
pattern=re.compile(fref + NAV + r'showAddButton\(([^)]+)\)'),
replacement=r'setSubTableAddButtonVisible(\1, \2)',
))
# ── 2.10c setViewWithoutEditor(只读视图无编辑器)────────────
# group.getField("X").setViewWithoutEditor(b) → setFieldViewOnly("X", b)
rules.append(RewriteRule(
name="setViewWithoutEditor",
pattern=re.compile(fref + NAV + r'setViewWithoutEditor\(([^)]+)\)'),
replacement=r'setFieldViewOnly(\1, \2)',
))
# ── 2.10d setFilter / setFilterMap(字段下拉过滤,复杂参数)─
# 直接挂在字段句柄上的 setFilter(map) / setFilterMap(map)。
# 参数常含嵌套 [..] 与函数调用,无法用 [^)]+ 安全匹配,
# 改由平衡括号预处理 _rewrite_balanced_field_calls 处理(见下)。
# 此处不注册正则规则,留空说明保持登记完整性。
# ── 2.10e focus(字段聚焦)──────────────────────────────────
# group.getField("X").focus() → focusField("X")
rules.append(RewriteRule(
name="focus",
pattern=re.compile(fref + NAV + r'focus\(\)'),
replacement=r'focusField(\1)',
))
# ── 2.10f setWidth / setHeight(字段尺寸)───────────────────
# group.getField("X").setWidth(w) → setFieldWidth("X", w)
rules.append(RewriteRule(
name="setWidth",
pattern=re.compile(fref + NAV + r'setWidth\(([^)]+)\)'),
replacement=r'setFieldWidth(\1, \2)',
))
rules.append(RewriteRule(
name="setHeight",
pattern=re.compile(fref + NAV + r'setHeight\(([^)]+)\)'),
replacement=r'setFieldHeight(\1, \2)',
))
# ── 2.10h reload(字段数据源刷新)──────────────────────────
# group.getField("X").reload() → reloadField("X")
rules.append(RewriteRule(
name="reload",
pattern=re.compile(fref + NAV + r'reload\(\)'),
replacement=r'reloadField(\1)',
))
# ── 2.10i setConvertedValue(转换后赋值)────────────────────
# group.getField("X").setConvertedValue(v) → setFieldConvertedValue("X", v)
rules.append(RewriteRule(
name="setConvertedValue",
pattern=re.compile(fref + NAV + r'setConvertedValue\(([^)]+)\)'),
replacement=r'setFieldConvertedValue(\1, \2)',
))
# ── 2.10j setNullSelectionItemId(空选项 id)────────────────
# group.getField("X").setNullSelectionItemId(v) → setFieldNullSelection("X", v)
rules.append(RewriteRule(
name="setNullSelectionItemId",
pattern=re.compile(fref + NAV + r'setNullSelectionItemId\(([^)]+)\)'),
replacement=r'setFieldNullSelection(\1, \2)',
))
# ── 2.10k removeItem(删下拉项)─────────────────────────────
# group.getField("X").removeItem(v) → removeFieldItem("X", v)
rules.append(RewriteRule(
name="removeItem",
pattern=re.compile(fref + NAV + r'removeItem\(([^)]+)\)'),
replacement=r'removeFieldItem(\1, \2)',
))
# ── 2.10l showDeleteButton(子表删除按钮显隐)───────────────
# group.getField("X").showDeleteButton(b) → setSubTableDeleteButtonVisible("X", b)
rules.append(RewriteRule(
name="showDeleteButton",
pattern=re.compile(fref + NAV + r'showDeleteButton\(([^)]+)\)'),
replacement=r'setSubTableDeleteButtonVisible(\1, \2)',
))
# ── 2.10m getModifyButton().setVisible / getDetailButton().setVisible ─
# group.getField("X").getModifyButton().setVisible(b)
# → setSubTableModifyButtonVisible("X", b)
rules.append(RewriteRule(
name="getModifyButton_setVisible",
pattern=re.compile(
fref + NAV + r'getModifyButton\(\)' + NAV + r'setVisible\(([^)]+)\)'),
replacement=r'setSubTableModifyButtonVisible(\1, \2)',
))
rules.append(RewriteRule(
name="getDetailButton_setVisible",
pattern=re.compile(
fref + NAV + r'getDetailButton\(\)' + NAV + r'setVisible\(([^)]+)\)'),
replacement=r'setSubTableDetailButtonVisible(\1, \2)',
))
# ── 2.11 group.setReadOnly (组级) ──────────────────────────
# group.setReadOnly(b) / group?.setReadOnly(b) → setGroupReadOnly(b)
rules.append(RewriteRule(
name="group_setReadOnly",
pattern=re.compile(r'\bgroup\s*\??\.\s*setReadOnly\(([^)]+)\)'),
replacement=r'setGroupReadOnly(\1)',
))
# ── 2.12 group.setEnabled (组级) ───────────────────────────
rules.append(RewriteRule(
name="group_setEnabled",
pattern=re.compile(r'\bgroup\s*\??\.\s*setEnabled\(([^)]+)\)'),
replacement=r'setGroupEnabled(\1)',
))
# ── 2.13 Notification.show ─────────────────────────────────
# Notification.show(msg) / Notification.show(msg, Type)
# → showToast(msg) / showToast(msg, type)
rules.append(RewriteRule(
name="Notification_show",
pattern=re.compile(
r'\bNotification\.show\(([^)]+)\)',
re.DOTALL
),
replacement=r'showToast(\1)',
))
# ── 2.14 enableButton ──────────────────────────────────────
# enableButton("BTN", b) — 已是 S2 形态,保持不变(作为无操作规则)
# 此处不改写,仅识别(不在 S3 剩余检测里误报)
# ── F2-3 规则族3: 深层访问家族 ─────────────────────────────
# 真实语料挖掘(2026-06-11): PARTIAL 残留 .comboBox / .table 访问共 17 处,
# 覆盖 8 个模板。能折叠到已有 facade 动词的两类:
#
# 3A. group.getField("X")?.comboBox.setValue(v) → setFieldValue("X", v)
# 语义等价:comboBox.setValue 即字段赋值,与 setFieldValue 语义相同。
# 语料命中: 7 处 / 4 模板(月度检查、季度检查系列)
# 负例保护: 仅当 .comboBox 后紧跟 .setValue( 时才改写;.comboBox.OTHER 不触发。
#
# 3B. group.getField("X")?.comboBox?.removeItem(v) → removeFieldItem("X", v)
# 语义等价: comboBox.removeItem 即字段下拉项移除,与 removeFieldItem 语义相同。
# 语料命中: 2 处 / 1 模板(季度检查整改)
# 负例保护: 仅当 .comboBox 后紧跟 ?.removeItem( 或 .removeItem( 时才改写。
#
# .table.getVisibleColumns / .table.setVisibleColumns 无 facade 等价,保留 PARTIAL。
# 3A: .comboBox.setValue → setFieldValue
rules.append(RewriteRule(
name="comboBox_setValue",
pattern=re.compile(
fref + NAV + r'comboBox\s*\??\.\s*setValue\s*\(([^)]+)\)'
),
replacement=r'setFieldValue(\1, \2)',
))
# 3B: .comboBox.removeItem → removeFieldItem
rules.append(RewriteRule(
name="comboBox_removeItem",
pattern=re.compile(
fref + NAV + r'comboBox\s*\??\.\s*removeItem\s*\(([^)]+)\)'
),
replacement=r'removeFieldItem(\1, \2)',
))
return rules
# 单例规则表(模块加载时编译一次)
REWRITE_RULES: List[RewriteRule] = _make_field_rules()
# ──────────────────────────────────────────────
# F2-3 规则族2: 动态按钮家族
#
# 目标模式(真实语料挖掘,2026-06-11,57 条 HARD new Button 脚本):
#
# 形态A(最常见,38 条):
# [final/def] fieldVar = group.getField("FIELD") -- 可能已被内联
# [final] Button btnVar = new Button("文案")
# btnVar?.addClickListener(new [Button.]ClickListener() {
# public void buttonClick([Button.]ClickEvent event) { <闭包体> }
# });
# fieldVar?.addButton(btnVar, N)
# → addFieldButton("FIELD", "文案", { <闭包体> }) -- N 对应按钮位置
# → 挂载位置参数 N 编码为 addFieldButton 第4参数(可选)
#
# 形态B(17 条):
# [final] Button btnVar = new Button("文案")
# btnVar?.addClickListener(new ClickListener() { ... })
# fieldVarOrExpr?.addButton(btnVar, N)
# 其中 fieldVar 来自 def fieldVar = group.getField("FIELD")
#
# 改写策略:
# 1. 找到 fieldVar.addButton(btnVar, N) 挂载行 → 确定 fieldName 和 btnVar
# 2. 向上找 Button btnVar = new Button("文案") 声明 → 得到文案
# 3. 找 btnVar?.addClickListener(new ClickListener(){ public void buttonClick(...){ ... }})
# 用平衡括号提取闭包体,展开为 { <体> }
# 4. 整体替换为 addFieldButton("FIELD", "文案", { <体> })
# 5. 清除原始 import 行(Button/ClickEvent/ClickListener)
#
# 安全约束(0 误改红线):
# - fieldVar 必须能追溯到 group.getField("LITERAL") 赋值,或挂载行本身含 getField
# - btnVar 必须有明确的 new Button("字面量文案") 声明(非变量文案不改)
# - addClickListener 必须用 new ClickListener()/new Button.ClickListener() 形态
# (不支持 Lambda/Groovy 闭包形态,真实库未见此形态)
# - addComponent(btn, N) 型(vl = opertor?.parent)不在此规则覆盖范围,保留 HARD
# ──────────────────────────────────────────────
# 匹配 Button/ClickListener/ClickEvent import 行(改写完成后可删除)
_BTN_IMPORT_RE = re.compile(
r'^[ \t]*import\s+com\.vaadin\.ui\.(?:Button|Button\.ClickEvent|Button\.ClickListener|'
r'Button\.ClickListener\.ClickEvent);\s*\n?',
re.MULTILINE,
)
_LISTENER_IMPORT_RE = re.compile(
r'^[ \t]*import\s+com\.vaadin\.(?:data\.Property\.ValueChangeListener|'
r'data\.Property\.ValueChangeEvent|ui\.Button\.ClickEvent|'
r'ui\.Button\.ClickListener);\s*\n?',
re.MULTILINE,
)
# 匹配: [final] Button VAR = new Button("文案") 或 [def/final] Button VAR = new Button("文案")
_BTN_DECL_RE = re.compile(
r'^[ \t]*(?:final\s+)?(?:def\s+)?Button\s+(\w+)\s*=\s*new\s+Button\((["\'][^"\']+["\'])\)\s*;?[ \t]*(?://[^\n]*)?\n?',
re.MULTILINE,
)
# 匹配: btnVar?.addClickListener(new [Button.]ClickListener() {
_CLICK_LISTENER_HEAD_RE = re.compile(
r'(\w+)\s*\??\.\s*addClickListener\s*\(\s*new\s+(?:Button\.)?ClickListener\s*\(\s*\)\s*\{'
)
# 匹配: public void buttonClick([Button.]ClickEvent event) {
_BTN_CLICK_METHOD_RE = re.compile(
r'public\s+void\s+buttonClick\s*\(\s*(?:Button\.)?ClickEvent\s+\w+\s*\)\s*\{'
)
# 匹配 fieldVar 赋值行: [def/final/Object] VAR = group.getField("FIELD") / group.getField('FIELD')
_FIELD_VAR_ASSIGN_RE = re.compile(
r'^[ \t]*(?:def\s+|final\s+|Object\s+)*(\w+)\s*=\s*group\.getField\((["\'][^"\']+["\'])\)\s*;?[ \t]*(?://[^\n]*)?\n?',
re.MULTILINE,
)
# 匹配挂载行: fieldVar?.addButton(btnVar, N[, "icon.png", ...])
# 组1=fieldVar, 组2=btnVar, 组3+=后续参数(含位置 N)
_MOUNT_LINE_RE = re.compile(
r'^([ \t]*)(\w+)\s*\??\.\s*addButton\s*\(\s*(\w+)\s*,\s*([^)]+)\)\s*;?[ \t]*\n?',
re.MULTILINE,
)
def _extract_click_body(text: str, btn_var: str) -> Tuple[str, int, int]:
"""
从 text 中找 btnVar?.addClickListener(new ClickListener() { ... })
用平衡大括号提取监听器整块(含外层 {}),返回 (闭包体内容, 整块起始索引, 整块结束索引+1)。
失败返回 ('', -1, -1)。
"""
# 找 btnVar?.addClickListener(new ClickListener() {
pat = re.compile(
re.escape(btn_var) + r'\s*\??\.\s*addClickListener\s*\(\s*new\s+(?:Button\.)?ClickListener\s*\(\s*\)\s*\{'
)
m = pat.search(text)
if not m:
return '', -1, -1
# 整块起始:btnVar 的开头
block_start = m.start()
# 大括号配平从 { 开始
brace_open = m.end() - 1 # 指向 {
depth = 0
i = brace_open
n = len(text)
while i < n:
ch = text[i]
if ch == '{':
depth += 1
elif ch == '}':
depth -= 1
if depth == 0:
break
i += 1
if depth != 0:
return '', -1, -1
outer_close = i # 位置 i 是最外层 }
# 外层 } 之后可能有 ) 和 ; -- addClickListener(...) 的闭合
j = outer_close + 1
while j < n and text[j] in ' \t':
j += 1
if j < n and text[j] == ')':
j += 1
while j < n and text[j] in ' \t':
j += 1
if j < n and text[j] == ';':
j += 1
while j < n and text[j] in ' \t\n':
j += 1
block_end = j # 整个 addClickListener 语句结束位置(含换行)
# 提取 buttonClick 方法体
inner = text[brace_open + 1:outer_close]
m2 = _BTN_CLICK_METHOD_RE.search(inner)
if not m2:
# 没找到标准 buttonClick 方法,整个 inner 作为闭包体(容错)
body = inner.strip()
else:
# 找 buttonClick { ... } 的大括号
method_brace = inner.index('{', m2.end() - 1)
depth2 = 0
k = method_brace
while k < len(inner):
ch = inner[k]
if ch == '{':
depth2 += 1
elif ch == '}':
depth2 -= 1
if depth2 == 0:
break
k += 1
body = inner[method_brace + 1:k].strip()
return body, block_start, block_end
def _rewrite_dynamic_buttons(text: str) -> Tuple[str, int]:
"""
规则族2:动态按钮家族改写。
识别并折叠 new Button + addClickListener + fieldVar.addButton 三元组,
改写为 addFieldButton("FIELD", "文案", { 闭包体 })。
返回 (新文本, 改写次数)。
安全约束:
- 只改写能静态追溯到 group.getField("LITERAL") 的 fieldVar
- btnVar 必须有 new Button("字面量") 声明
- addClickListener 必须是 new [Button.]ClickListener() { ... } 形态
- vl.addComponent(btn, N) 型(opertor?.parent)不触发
- 每次只改写能完整匹配三元组的 btnVar;无法匹配则原样保留
"""
count = 0
# 先建立 fieldVar → fieldName 映射(从赋值行)
field_var_map: dict = {}
for m in _FIELD_VAR_ASSIGN_RE.finditer(text):
var, fname = m.group(1), m.group(2)
field_var_map[var] = fname
# 找所有 Button 声明(btnVar → 文案)
btn_decls: dict = {}
for m in _BTN_DECL_RE.finditer(text):
btn_decls[m.group(1)] = m.group(2)
if not btn_decls:
return text, 0
# 逐个挂载行处理(倒序,避免偏移问题)
mounts = list(_MOUNT_LINE_RE.finditer(text))
mounts.reverse()
working = text
for mount_m in mounts:
field_var = mount_m.group(2)
btn_var = mount_m.group(3)
pos_args = mount_m.group(4).strip() # 位置参数(N 或 N, "icon.png", ...)
# 确定字段名
if field_var in field_var_map:
field_name = field_var_map[field_var]
else:
# fieldVar 不在已知映射里(可能来自外层字段句柄),跳过
continue
# 确定按钮文案
if btn_var not in btn_decls:
continue
btn_label = btn_decls[btn_var]
# 提取 addClickListener 闭包体
body, cl_start, cl_end = _extract_click_body(working, btn_var)
if cl_start == -1:
# 没有标准 addClickListener 形态,不改写
continue
# 确保 addClickListener 块在挂载行之前
mount_start = working.find(mount_m.group(0))
if mount_start == -1:
continue
if cl_start >= mount_start:
# addClickListener 在挂载之后,不是预期三元组形态
continue
# 找 Button 声明行
btn_decl_m = None
for m in _BTN_DECL_RE.finditer(working):
if m.group(1) == btn_var:
btn_decl_m = m
break
if btn_decl_m is None:
continue
# 确保 Button 声明在 addClickListener 之前
if btn_decl_m.start() >= cl_start:
continue
# 构造替换文案
indent = mount_m.group(1)
# 简化 pos_args:只取第一个数字参数(按钮位置)
pos_num_m = re.match(r'^(\d+)', pos_args)
if pos_num_m:
pos_arg = pos_num_m.group(1)
facade = f'{indent}addFieldButton({field_name}, {btn_label}, {{\n{body}\n{indent}}}, {pos_arg})'
else:
facade = f'{indent}addFieldButton({field_name}, {btn_label}, {{\n{body}\n{indent}}})'
# 执行四处删除/替换(从后向前:挂载行、addClickListener 块、Button 声明、fieldVar 赋值行)
# 先替换挂载行
mount_full = mount_m.group(0)
new_working = working[:mount_start] + facade + '\n' + working[mount_start + len(mount_full):]
# 删除 addClickListener 块(cl_start 在 mount_start 之前,偏移不受影响)
new_working = new_working[:cl_start] + new_working[cl_end:]
# 重新定位 Button 声明行(cl 删除影响偏移,但 btn_decl 在 cl 之前,不受影响)
btn_full = btn_decl_m.group(0)
btn_pos = new_working.find(btn_full)
if btn_pos != -1:
new_working = new_working[:btn_pos] + new_working[btn_pos + len(btn_full):]
# 删除 fieldVar 赋值行(仅当该变量在剩余文本中不再出现时,避免误删多用途变量)
# 用词边界检查:剩余文本不含 fieldVar 引用则安全删除
field_var_ref_re = re.compile(r'\b' + re.escape(field_var) + r'\b')
# 找赋值行位置(重新扫描,因为文本已变化)
field_assign_remaining = None
for fm in _FIELD_VAR_ASSIGN_RE.finditer(new_working):
if fm.group(1) == field_var:
field_assign_remaining = fm
break
if field_assign_remaining is not None:
# 检查赋值行之后是否还有对 fieldVar 的引用
text_after_assign = new_working[field_assign_remaining.end():]
if not field_var_ref_re.search(text_after_assign):
fa_full = field_assign_remaining.group(0)
fa_pos = field_assign_remaining.start()
new_working = new_working[:fa_pos] + new_working[fa_pos + len(fa_full):]
working = new_working
count += 1
# 同步更新 field_var_map 和 btn_decls(文本已改,重新扫描)
field_var_map = {}
for m in _FIELD_VAR_ASSIGN_RE.finditer(working):
field_var_map[m.group(1)] = m.group(2)
btn_decls = {}
for m in _BTN_DECL_RE.finditer(working):
btn_decls[m.group(1)] = m.group(2)
# 清理 Vaadin Button import(改写完成后不再需要)
if count > 0:
# 只清理 Button 相关 import,保留其他 Vaadin import(安全)
working = re.sub(
r'^[ \t]*import\s+com\.vaadin\.ui\.Button(?:\.\w+)?;\s*\n?',
'', working, flags=re.MULTILINE
)
return working, count
# ──────────────────────────────────────────────
# 2bis. 平衡括号字段调用预处理
# 处理参数含嵌套 [..]/(..) 的字段句柄方法(setFilter/setFilterMap),
# 正则的 [^)]+ 会在首个 ) 处截断,故用括号配平扫描。
# 形态: group.getField("X")[?.|.]<method>( ...balanced... )
# 映射: setFilter→setFieldFilter, setFilterMap→setFieldFilterMap
# ──────────────────────────────────────────────
_BALANCED_FIELD_VERBS = {
"setFilter": "setFieldFilter",
"setFilterMap": "setFieldFilterMap",
}
_BALANCED_HEAD_RE = re.compile(
r'group\.getField\((["\'][^"\']+["\'])\)\s*\??\.\s*(setFilter|setFilterMap)\('
)
def _match_balanced(text: str, open_idx: int) -> int:
"""从 text[open_idx]=='(' 起,返回配平的 ')' 索引;失败返回 -1。"""
depth = 0
i = open_idx
n = len(text)
while i < n:
ch = text[i]
if ch == '(':
depth += 1
elif ch == ')':
depth -= 1
if depth == 0:
return i
i += 1
return -1
def _rewrite_balanced_field_calls(text: str) -> Tuple[str, int]:
"""改写复杂参数字段调用(setFilter/setFilterMap)。返回 (新文本, 次数)。"""
count = 0
out = []
pos = 0
while True:
m = _BALANCED_HEAD_RE.search(text, pos)
if not m:
out.append(text[pos:])
break
field, verb = m.group(1), m.group(2)
open_idx = m.end() - 1 # 指向方法名后的 '('
close_idx = _match_balanced(text, open_idx)
if close_idx == -1:
# 括号不配平,放弃改写该处,原样输出并跳过
out.append(text[pos:m.end()])
pos = m.end()
continue
arg = text[open_idx + 1:close_idx]
facade = _BALANCED_FIELD_VERBS[verb]
out.append(text[pos:m.start()])
out.append(f'{facade}({field}, {arg})')
pos = close_idx + 1
count += 1
return ''.join(out), count
# ──────────────────────────────────────────────
# 2ter. 下拉选项填充 idiom → addFieldOption(平衡括号)
# 形态(改写后): getFieldDataSource("F")?.addItem(V).getItemProperty("des").setValue(D)
# 映射: addFieldOption("F", V, D)
# 说明: 真实库构造下拉选项的标准写法(250/271 形态一致,属性键恒为 "des")。
# 此为确定性 1:1 语句转换——把"向 F 字段的数据源加一个值/显示项"
# 折叠为 facade 调用,不臆测循环体,逐条安全。
# 前置: 需先把 `def ic = getFieldDataSource("F")` 句柄变量内联回字面形态
# (见 _inline_datasource_handles)。
# ──────────────────────────────────────────────
# 头: getFieldDataSource("F")?.addItem( —— 捕获字段名,定位 addItem 起始括号
_OPTION_HEAD_RE = re.compile(
r'getFieldDataSource\((["\'][^"\']+["\'])\)\s*\??\.\s*addItem\('
)
# addItem 参数闭合后紧跟: [?.|.]getItemProperty("des")[?.|.]setValue( D )
# 真实库 getItemProperty/setValue 之间同样存在 ?. 安全导航变体。
_OPTION_TAIL_RE = re.compile(
r'\s*\??\.\s*getItemProperty\(\s*["\']des["\']\s*\)\s*\??\.\s*setValue\('
)
def _rewrite_option_population(text: str) -> Tuple[str, int]:
"""改写下拉选项填充 idiom → addFieldOption。返回 (新文本, 次数)。"""
count = 0
out = []
pos = 0
while True:
m = _OPTION_HEAD_RE.search(text, pos)
if not m:
out.append(text[pos:])
break
field = m.group(1)
ai_open = m.end() - 1 # addItem 的 '('
ai_close = _match_balanced(text, ai_open)
if ai_close == -1:
out.append(text[pos:m.end()]); pos = m.end(); continue
value_arg = text[ai_open + 1:ai_close]
tail = _OPTION_TAIL_RE.match(text, ai_close + 1)
if not tail:
# 仅 addItem(...) 无 getItemProperty("des").setValue —— 不属本 idiom,跳过
out.append(text[pos:m.end()]); pos = m.end(); continue
sv_open = tail.end() - 1 # setValue 的 '('
sv_close = _match_balanced(text, sv_open)
if sv_close == -1:
out.append(text[pos:m.end()]); pos = m.end(); continue
desc_arg = text[sv_open + 1:sv_close]
out.append(text[pos:m.start()])
out.append(f'addFieldOption({field}, {value_arg}, {desc_arg})')
pos = sv_close + 1
count += 1
return ''.join(out), count
# 数据源句柄变量赋值行(改写后): def ic = getFieldDataSource("F");
_DS_ASSIGN_LINE_RE = re.compile(
r'^[ \t]*(?:def\s+|final\s+|var\s+|Object\s+)?(\w+)\s*=\s*'
r'(getFieldDataSource\(["\'][^"\']+["\']\))[ \t]*;?[ \t]*(?://[^\n]*)?$',
re.MULTILINE,
)
def _inline_datasource_handles(text: str) -> Tuple[str, List[str]]:
"""
将单赋值数据源句柄变量内联展开,使 addFieldOption 模式可匹配。
def ic = getFieldDataSource("F")
ic?.addItem(...)...
→ getFieldDataSource("F")?.addItem(...)...
复用与字段句柄内联相同的"持有者引用"语义(仅替换 var. / var?.)。
"""
inlined: List[str] = []
lines = text.split('\n')
result_lines = list(lines)
assignments: List[Tuple[int, str, str]] = []
for idx, line in enumerate(lines):
m = _DS_ASSIGN_LINE_RE.match(line)
if m:
assignments.append((idx, m.group(1), m.group(2)))
for assign_idx, var, fexpr in reversed(assignments):
ref_re = re.compile(r'\b' + re.escape(var) + r'\b(?=\s*\??\.)')
replaced_any = False
for i in range(assign_idx + 1, len(result_lines)):
cur = result_lines[i]
m2 = _DS_ASSIGN_LINE_RE.match(cur)
if m2 and m2.group(1) == var:
break
if ref_re.search(cur):
result_lines[i] = ref_re.sub(fexpr, cur)
replaced_any = True
if replaced_any:
result_lines[assign_idx] = ''
inlined.append(
f"内联数据源句柄变量 `{var}` → `{fexpr}`(原第 {assign_idx+1} 行)"
)
return '\n'.join(result_lines), inlined
# ──────────────────────────────────────────────
# 3. S3 残留检测(改写后仍有未处理的 Vaadin API)
#
# 判定原则: 凡仍能匹配 *未被改写的 Vaadin UI 句柄链* 即残留。
# - group.getField( 仍存在 → 必有未覆盖动词,残留。
# - group.setReadOnly / setEnabled(含 ?.)仍存在 → 残留。
# - 容器/Item 级数据填充 idiom(getContainerDataSource / addItem /
# getItemProperty / removeAllItems / setFilter)仍存在 → 残留。
# 这些直接操作 Vaadin Container/Item 数据模型,不在自动改写边界内,
# 诚实保留为 PARTIAL,不强行转换(避免错改)。
# 注意: facade 自身的 setFieldValue/getFieldValue 等 *不带句柄前缀* 的形态
# 不应触发残留,故这里只匹配 group.getField( 句柄链与容器/Item 链。
# ──────────────────────────────────────────────
RESIDUAL_S3_PATTERNS = [
# 任何残留的字段句柄链(含 ?.,含未覆盖动词)
re.compile(r'group\.getField\('),
# 组级残留(含安全导航)
re.compile(r'\bgroup\s*\??\.\s*setReadOnly\('),
re.compile(r'\bgroup\s*\??\.\s*setEnabled\('),
re.compile(r'\bgroup\s*\??\.\s*setVisible\('),
re.compile(r'\bNotification\.show\('),
# 容器 / Item 级数据填充 idiom(保留为人工,不自动转)
re.compile(r'\.getContainerDataSource\('),
re.compile(r'\.getPropertyDataSource\('),
re.compile(r'\.getItemProperty\('),
re.compile(r'\.addItem\('),
re.compile(r'\.removeAllItems\('),
re.compile(r'\.setFilter\('),
# 规则族2 改写后如仍残留 new Button(无法识别的挂载形态),降为 PARTIAL
re.compile(r'\bnew\s+Button\b'),
]
# ──────────────────────────────────────────────
# 4. 内联单赋值字段句柄变量(两遍处理)
#
# def f = group.getField("X") // 或 def fld = ...
# f.setVisible(true)
# →
# group.getField("X").setVisible(true)
# ──────────────────────────────────────────────
# 匹配单行字段句柄赋值:
# def f = group.getField("X")
# final fld = group.getField('Y')
# f = group.getField("Z")
# 使用 MULTILINE 在完整文本中逐行匹配,不依赖行末换行符
# 匹配字段句柄赋值行(允许行末分号 / 注释 / 普通点或安全导航不触发——仅裸取句柄)。
# 真实库 548 处赋值写成 `def isShare = group.getField("ISSHARE");`(带分号),
# 旧正则用 `$` 收尾不允许分号,导致全部漏内联。这里允许尾随 `;` 与空白。
_FIELD_ASSIGN_LINE_RE = re.compile(
r'^[ \t]*(?:def\s+|final\s+|String\s+|Object\s+|var\s+)?(\w+)\s*=\s*'
r'(group\.getField\(["\'][^"\']+["\']\))[ \t]*;?[ \t]*(?://[^\n]*)?$',
re.MULTILINE,
)
def _inline_field_handles(text: str) -> Tuple[str, List[str]]:
"""
将单赋值字段句柄变量内联展开。
返回 (展开后文本, 内联操作说明列表)。
只处理在赋值行之后、**下一个同名赋值之前**出现的引用。
引用替换同时覆盖普通点 `var.foo()` 与安全导航 `var?.foo()`:
真实库句柄变量后续多用 `?.`(如 isShare?.setReadOnly(...)),
内联时把 `var?.` 还原为 `group.getField("ISSHARE")?.`,
保留导航符交由后续字段规则统一改写。
"""
inlined: List[str] = []
lines = text.split('\n')
result_lines = list(lines)
# 收集所有赋值:(行号, 变量名, 字段表达式)
assignments: List[Tuple[int, str, str]] = []
for idx, line in enumerate(lines):
m = _FIELD_ASSIGN_LINE_RE.match(line)
if m:
assignments.append((idx, m.group(1), m.group(2)))
# 倒序处理(避免行号偏移影响索引)
for assign_idx, var, fexpr in reversed(assignments):
# 只替换作为"句柄持有者"的引用:var. 或 var?.(后面紧跟方法链),
# 不误伤把 var 当普通值用的场景(如 `if (var == null)`)。
# 替换时仅吃掉变量名,保留其后的 `.`/`?.`,故用零宽断言。
ref_re = re.compile(r'\b' + re.escape(var) + r'\b(?=\s*\??\.)')
replaced_any = False
for i in range(assign_idx + 1, len(result_lines)):
cur = result_lines[i]
# 遇到同名重赋值则停止
m2 = _FIELD_ASSIGN_LINE_RE.match(cur)
if m2 and m2.group(1) == var:
break
if ref_re.search(cur):
result_lines[i] = ref_re.sub(fexpr, cur)
replaced_any = True
if replaced_any:
# 删除赋值行(置为空行,保留行号结构)
result_lines[assign_idx] = ''
inlined.append(
f"内联字段句柄变量 `{var}` → `{fexpr}`(原第 {assign_idx+1} 行)"
)
return '\n'.join(result_lines), inlined
# ──────────────────────────────────────────────
# 5. 主改写入口
# ──────────────────────────────────────────────
@dataclass
class RewriteDetail:
rule_name: str
original: str
rewritten: str
count: int = 1
def rewrite_script(source: str) -> Tuple[str, List[RewriteDetail], str]:
"""
对输入的 Groovy 脚本文本执行 S3 改写。
返回:
(改写后文本, 改写明细列表, 分类标签)
分类标签: FULL_AUTO / PARTIAL / HARD / NO_S3
"""
details: List[RewriteDetail] = []
# ── 5.0 规则族2: 动态按钮家族(先于 HARD 检测运行)──────────
# new Button + addClickListener + fieldVar.addButton(btnVar, N)
# → addFieldButton("FIELD", "文案", {闭包体}, N)
# 改写成功后 new Button 消失,不触发下面的 HARD 检测。
# 改写失败/不匹配形态:源文本不变,继续走正常 HARD 检测路径。
btn_rewrite_count = 0
if re.search(r'\bnew\s+Button\b', source):
source_after_btn, btn_rewrite_count = _rewrite_dynamic_buttons(source)
if btn_rewrite_count > 0:
details.append(RewriteDetail(
rule_name="dynamic_button",
original=f"命中 {btn_rewrite_count} 处 new Button 三元组",
rewritten="→ addFieldButton",
count=btn_rewrite_count,
))
source = source_after_btn
# ── 5.1 硬 S3 检测 ────────────────────────────────────────
hard_reasons = []
for pattern_str, reason in HARD_S3_PATTERNS:
if re.search(pattern_str, source):
hard_reasons.append(reason)
# 规则族2 改写后如果仍残留 new Button(无法识别形态),降级为 HARD 残留特征
if re.search(r'\bnew\s+Button\b', source):
hard_reasons.append("动态创建 Vaadin Button(无法自动改写形态)")
if hard_reasons:
details.append(RewriteDetail(
rule_name="HARD_DETECTION",
original="; ".join(hard_reasons),
rewritten="[人工处理]",
count=len(hard_reasons),
))
return source, details, "HARD"
# ── 5.2 无 S3 快检 ────────────────────────────────────────
def _has_s3(text: str) -> bool:
for pat in RESIDUAL_S3_PATTERNS:
if pat.search(text):
return True
# 还检查 Notification.show
if re.search(r'\bNotification\.show\(', text):
return True
return False
# 若规则族2 已成功改写(btn_rewrite_count > 0),跳过 NO_S3 快检——
# 改写后源文本已不含 S3 特征属正常,但应归为 FULL_AUTO 而非 NO_S3。
if not _has_s3(source) and btn_rewrite_count == 0:
return source, details, "NO_S3"
# ── 5.3 内联字段句柄变量(第一遍)────────────────────────
working, inline_notes = _inline_field_handles(source)
for note in inline_notes:
details.append(RewriteDetail(
rule_name="inline_field_handle",
original=note,
rewritten="[已内联]",
))
# ── 5.4 平衡括号字段调用(setFilter/setFilterMap 复杂参数)─
working, bcount = _rewrite_balanced_field_calls(working)
if bcount > 0:
details.append(RewriteDetail(
rule_name="balanced_setFilter",
original=f"命中 {bcount} 处",
rewritten="→ 已替换",
count=bcount,
))
# ── 5.5 应用规则表(第二遍)──────────────────────────────
for rule in REWRITE_RULES:
new_text, count = _apply_rule(working, rule)
if count > 0:
details.append(RewriteDetail(
rule_name=rule.name,
original=f"命中 {count} 处",
rewritten=f"→ 已替换",
count=count,
))
working = new_text
# ── 5.6 再次内联(处理可能被改写暴露的新变量引用)─────────
working2, inline_notes2 = _inline_field_handles(working)
for note in inline_notes2:
details.append(RewriteDetail(
rule_name="inline_field_handle_pass2",
original=note,
rewritten="[已内联 pass2]",
))
working = working2
# ── 5.7 再次应用规则(处理第二遍内联暴露的模式)──────────
if inline_notes2:
working, bcount2 = _rewrite_balanced_field_calls(working)
if bcount2 > 0:
details.append(RewriteDetail(
rule_name="balanced_setFilter_pass2",
original=f"命中 {bcount2} 处",
rewritten="→ 已替换",
count=bcount2,
))
for rule in REWRITE_RULES:
new_text, count = _apply_rule(working, rule)
if count > 0:
details.append(RewriteDetail(
rule_name=rule.name + "_pass2",
original=f"命中 {count} 处",
rewritten=f"→ 已替换",
count=count,
))
working = new_text
# ── 5.8 下拉选项填充 idiom(数据源句柄内联 + addFieldOption)─
# 此时 getContainerDataSource() 已被规则改写为 getFieldDataSource(),
# 先内联数据源句柄变量,再把 addItem().getItemProperty("des").setValue()
# 链折叠为 addFieldOption。
working, ds_notes = _inline_datasource_handles(working)
for note in ds_notes:
details.append(RewriteDetail(
rule_name="inline_datasource_handle",
original=note,
rewritten="[已内联数据源]",
))
working, opt_count = _rewrite_option_population(working)
if opt_count > 0:
details.append(RewriteDetail(
rule_name="addFieldOption",
original=f"命中 {opt_count} 处",
rewritten="→ 已折叠为 addFieldOption",
count=opt_count,
))
# ── 5.9 分类 ──────────────────────────────────────────────
if not _has_s3(working):
label = "FULL_AUTO"
else:
label = "PARTIAL"
return working, details, label
def _apply_rule(text: str, rule: RewriteRule) -> Tuple[str, int]:
"""应用单条规则,返回 (新文本, 替换次数)。"""
count = 0
def replacer(m: re.Match) -> str:
nonlocal count
count += 1
return m.expand(rule.replacement)
new_text = rule.pattern.sub(replacer, text)
return new_text, count
# ──────────────────────────────────────────────
# 6. CLI 入口(便于快速测试单文件)
# ──────────────────────────────────────────────
if __name__ == "__main__":
import sys
if len(sys.argv) < 2:
print("用法: python rewrite.py <groovy文件>")
sys.exit(1)
with open(sys.argv[1], encoding="utf-8") as fh:
src = fh.read()
result, dets, lbl = rewrite_script(src)
print(f"=== 分类: {lbl} ===")
for d in dets:
print(f" [{d.rule_name}] {d.original} {d.rewritten} (×{d.count})")
print("=== 改写结果 ===")
print(result)