refactor: 重构 Groovy Request 类架构

- 新增 BaseGroovyRequest 基类，统一获取 FlowSession 的方式
- 新增 TitleGroovyRequest、ConditionGroovyRequest、OperatorLoadGroovyRequest
- 删除旧的 TitleGroovyRequest 类（从 runtime 目录移至 request 目录）
- 修改脚本节点使用新的 Request 类

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: xlorne

flow-engine-framework/src/main/java/com/codingapi/flow/script/node/ConditionScript.java

@@ -1,5 +1,6 @@
 package com.codingapi.flow.script.node;
 
+import com.codingapi.flow.script.request.ConditionGroovyRequest;
 import com.codingapi.flow.script.runtime.ScriptRuntimeContext;
 import com.codingapi.flow.session.FlowSession;
 import lombok.AllArgsConstructor;
@@ -8,12 +9,13 @@
 @AllArgsConstructor
 public class ConditionScript {
 
-    public static final String SCRIPT_DEFAULT = "def run(session){return true}";
+    public static final String SCRIPT_DEFAULT = "def run(request){return true}";
 
     @Getter
     private final String script;
 
-    public boolean execute(FlowSession request) {
+    public boolean execute(FlowSession session) {
+        ConditionGroovyRequest request = new ConditionGroovyRequest(session);
         return ScriptRuntimeContext.getInstance().run(script, Boolean.class, request);
     }
 

flow-engine-framework/src/main/java/com/codingapi/flow/script/node/NodeTitleScript.java

@@ -1,7 +1,7 @@
 package com.codingapi.flow.script.node;
 
 import com.codingapi.flow.script.runtime.ScriptRuntimeContext;
-import com.codingapi.flow.script.runtime.TitleGroovyRequest;
+import com.codingapi.flow.script.request.TitleGroovyRequest;
 import com.codingapi.flow.session.FlowSession;
 import lombok.AllArgsConstructor;
 import lombok.Getter;
@@ -18,16 +18,7 @@ public class NodeTitleScript {
     private final String script;
 
     public String execute(FlowSession session) {
-        TitleGroovyRequest request = session.createTitleRequest();
-        return execute(request);
-    }
-
-    /**
-     * 执行标题脚本（直接使用TitleGroovyRequest）
-     * @param request 标题请求对象
-     * @return 标题字符串
-     */
-    public String execute(TitleGroovyRequest request) {
+        TitleGroovyRequest request = new TitleGroovyRequest(session);
         return ScriptRuntimeContext.getInstance().run(script, String.class, request);
     }
 

flow-engine-framework/src/main/java/com/codingapi/flow/script/node/OperatorLoadScript.java

@@ -1,6 +1,7 @@
 package com.codingapi.flow.script.node;
 
 import com.codingapi.flow.operator.IFlowOperator;
+import com.codingapi.flow.script.request.OperatorLoadGroovyRequest;
 import com.codingapi.flow.script.runtime.ScriptRuntimeContext;
 import com.codingapi.flow.session.FlowSession;
 import lombok.AllArgsConstructor;
@@ -20,7 +21,8 @@ public class OperatorLoadScript {
     private final String script;
 
     @SuppressWarnings("unchecked")
-    public List<IFlowOperator> execute(FlowSession request) {
+    public List<IFlowOperator> execute(FlowSession session) {
+        OperatorLoadGroovyRequest request = new OperatorLoadGroovyRequest(session);
         return ScriptRuntimeContext.getInstance().run(script, List.class, request);
     }
 

flow-engine-framework/src/main/java/com/codingapi/flow/script/request/BaseGroovyRequest.java

@@ -0,0 +1,95 @@
+package com.codingapi.flow.script.request;
+
+import com.codingapi.flow.session.FlowSession;
+import lombok.Getter;
+import lombok.Setter;
+
+import java.util.Map;
+
+/**
+ * Groovy脚本请求对象抽象基类
+ * 从FlowSession中提取数据供脚本使用
+ */
+@Getter
+@Setter
+public abstract class BaseGroovyRequest {
+
+    /**
+     * 当前操作人姓名
+     */
+    protected String operatorName;
+
+    /**
+     * 当前操作人ID
+     */
+    protected Integer operatorId;
+
+    /**
+     * 是否流程管理员
+     */
+    protected Boolean isFlowManager;
+
+    /**
+     * 流程标题
+     */
+    protected String workflowTitle;
+
+    /**
+     * 流程编码
+     */
+    protected String workflowCode;
+
+    /**
+     * 流程编号
+     */
+    protected String workCode;
+
+    /**
+     * 流程创建人姓名
+     */
+    protected String creatorName;
+
+    /**
+     * 表单字段值
+     */
+    protected Map<String, Object> formData;
+
+    /**
+     * 从FlowSession构建请求对象（模板方法模式）
+     * @param session 流程会话（不能为null）
+     */
+    public BaseGroovyRequest(FlowSession session) {
+        // 提取操作人信息
+        if (session.getCurrentOperator() != null) {
+            this.operatorName = session.getCurrentOperator().getName();
+            this.operatorId = (int) session.getCurrentOperator().getUserId();
+            this.isFlowManager = session.getCurrentOperator().isFlowManager();
+        }
+
+        // 提取流程信息
+        if (session.getWorkflow() != null) {
+            this.workflowTitle = session.getWorkflow().getTitle();
+            this.workflowCode = session.getWorkflow().getCode();
+            if (session.getWorkflow().getCreatedOperator() != null) {
+                this.creatorName = session.getWorkflow().getCreatedOperator().getName();
+            }
+        }
+
+        // 提取表单数据
+        if (session.getFormData() != null) {
+            this.formData = session.getFormData().toMapData();
+        }
+    }
+
+    /**
+     * 获取表单字段值（Groovy脚本调用）
+     * @param key 字段key
+     * @return 字段值
+     */
+    public Object getFormData(String key) {
+        if (formData == null) {
+            return null;
+        }
+        return formData.get(key);
+    }
+}

flow-engine-framework/src/main/java/com/codingapi/flow/script/request/ConditionGroovyRequest.java

@@ -0,0 +1,32 @@
+package com.codingapi.flow.script.request;
+
+import com.codingapi.flow.session.FlowSession;
+import lombok.Getter;
+import lombok.Setter;
+
+/**
+ * 条件表达式Groovy脚本请求对象
+ * 提供给ConditionScript使用的上下文数据
+ * 继承BaseGroovyRequest，从FlowSession自动提取通用数据
+ */
+@Getter
+@Setter
+public class ConditionGroovyRequest extends BaseGroovyRequest {
+
+    /**
+     * 当前节点名称
+     */
+    private String nodeName;
+
+    /**
+     * 从FlowSession构建ConditionGroovyRequest
+     * @param session 流程会话（不能为null）
+     */
+    public ConditionGroovyRequest(FlowSession session) {
+        super(session);
+        // 提取节点信息
+        if (session.getCurrentNode() != null) {
+            this.nodeName = session.getCurrentNode().getName();
+        }
+    }
+}

flow-engine-framework/src/main/java/com/codingapi/flow/script/request/OperatorLoadGroovyRequest.java

@@ -0,0 +1,33 @@
+package com.codingapi.flow.script.request;
+
+import com.codingapi.flow.operator.IFlowOperator;
+import com.codingapi.flow.session.FlowSession;
+import lombok.Getter;
+import lombok.Setter;
+
+/**
+ * 人员加载Groovy脚本请求对象
+ * 提供给OperatorLoadScript使用的上下文数据
+ * 继承BaseGroovyRequest，从FlowSession自动提取通用数据
+ */
+@Getter
+@Setter
+public class OperatorLoadGroovyRequest extends BaseGroovyRequest {
+
+    /**
+     * 流程创建人
+     */
+    private IFlowOperator createdOperator;
+
+    /**
+     * 从FlowSession构建OperatorLoadGroovyRequest
+     * @param session 流程会话（不能为null）
+     */
+    public OperatorLoadGroovyRequest(FlowSession session) {
+        super(session);
+        // 提取创建人信息
+        if (session.getWorkflow() != null && session.getWorkflow().getCreatedOperator() != null) {
+            this.createdOperator = session.getWorkflow().getCreatedOperator();
+        }
+    }
+}

flow-engine-framework/src/main/java/com/codingapi/flow/script/request/TitleGroovyRequest.java

@@ -0,0 +1,42 @@
+package com.codingapi.flow.script.request;
+
+import com.codingapi.flow.session.FlowSession;
+import lombok.Getter;
+import lombok.Setter;
+
+/**
+ * 标题表达式Groovy脚本请求对象
+ * 提供给NodeTitleScript使用的上下文数据
+ * 继承BaseGroovyRequest，从FlowSession自动提取通用数据
+ */
+@Getter
+@Setter
+public class TitleGroovyRequest extends BaseGroovyRequest {
+
+    /**
+     * 当前节点名称
+     */
+    private String nodeName;
+
+    /**
+     * 当前节点类型
+     */
+    private String nodeType;
+
+    /**
+     * 从FlowSession构建TitleGroovyRequest
+     * @param session 流程会话
+     */
+    public TitleGroovyRequest(FlowSession session) {
+        super(session);
+        // 提取节点信息
+        if (session != null && session.getCurrentNode() != null) {
+            this.nodeName = session.getCurrentNode().getName();
+            this.nodeType = session.getCurrentNode().getType();
+        }
+        // 提取流程编号（从record获取）
+        if (session != null && session.getCurrentRecord() != null) {
+            this.workCode = session.getCurrentRecord().getWorkCode();
+        }
+    }
+}