script.md

name	flow-engine-framework/script
module	flow-engine-framework
description	Groovy 脚本运行时，包含脚本注册表、脚本类型封装和脚本执行上下文
status	已实现
scope	后端
source	项目自有
import	com.codingapi.flow:flow-engine-framework
symbols	IScriptRegistry DefaultScriptRegistry ScriptRegistryContext FlowGroovyScriptFactory ScriptDefaultConstants ActionCustomScript ActionRejectScript ConditionScript ErrorTriggerScript NodeTitleScript OperatorLoadScript OperatorMatchScript RouterNodeScript SubProcessScript TriggerScript GroovyScriptBind GroovyScriptRequest GroovyWorkflowRequest FlowScriptContext IBeanFactory
content_hash	42b4c00cdcb8aac4c1695f7d503b1ec953ab4ea3b3f92067e2312c31ea9d4a69

解决什么问题

提供流程引擎的 Groovy 脚本运行时能力，解决以下问题：

• 脚本注册表：通过 ScriptRegistryContext 单例管理各类默认脚本，支持替换默认实现
• 脚本类型封装：将各种脚本场景封装为强类型类（如 RouterNodeScript、ConditionScript 等）
• 脚本执行上下文：FlowScriptContext 提供脚本执行时的上下文环境，包括 Spring Bean 注入
• 脚本请求封装：GroovyScriptRequest / GroovyWorkflowRequest 封装脚本执行所需的参数

如何使用

脚本注册表

ScriptRegistryContext.getInstance() 提供获取各类默认脚本的能力：

方法	脚本类型
getRouterScript()	路由脚本 — 决定下一节点走向
getConditionScript()	条件脚本 — 条件分支判断
getNodeTitleScript()	节点标题脚本 — 动态生成节点标题
getTriggerScript()	触发器脚本 — 自动触发条件
getSubProcessScript()	子流程脚本 — 子流程触发规则
getOperatorLoadScript()	操作者加载脚本 — 加载节点操作者
getOperatorMatchScript()	操作者匹配脚本 — 匹配操作者
getErrorTriggerScript()	错误触发脚本 — 异常处理规则
getActionCustomScript()	自定义动作脚本 — 自定义动作行为
getActionRejectScript()	拒绝动作脚本 — 拒绝动作行为

自定义脚本注册

// 替换默认脚本注册实现
ScriptRegistryContext.getInstance().setRegistry(new IScriptRegistry() {
    @Override
    public String getRouterScript() {
        return "return customRouterLogic;";
    }
    // ... 其他方法
});

脚本执行上下文

FlowScriptContext 实现 IBeanFactory，允许 Groovy 脚本访问 Spring 容器中的 Bean。

使用实例

// 获取默认路由脚本
String routerScript = ScriptRegistryContext.getInstance().getRouterScript();

// 创建路由脚本实例
RouterNodeScript script = new RouterNodeScript(routerScript);

// 使用 GroovyScriptRequest 构建执行请求
GroovyScriptRequest request = GroovyScriptRequest.builder()
    .script(script)
    .bind(new GroovyScriptBind()
        .add("session", flowSession)
        .add("context", applicationContext))
    .build();

// 执行脚本
Object result = FlowScriptContext.execute(request);

// 替换默认脚本注册
ScriptRegistryContext.getInstance().setRegistry(customRegistry);