Merge pull request #151 from codingapi/dev

xlorne · web-flow · commit 346fce1090b7 · 2026-05-30T10:12:36.000+08:00
Dev
diff --git a/docs/components/flow-engine-framework_FlowScriptContext.md b/docs/components/flow-engine-framework_FlowScriptContext.md
@@ -22,7 +22,7 @@ description: Groovy 脚本运行时的 $bind 上下文对象，为脚本提供
 <dependency>
     <groupId>com.codingapi.flow</groupId>
     <artifactId>flow-engine-framework</artifactId>
-    <version>0.0.42</version>
+    <version>0.0.43</version>
 </dependency>
 ```
 
diff --git a/docs/components/flow-engine-framework_GatewayContext.md b/docs/components/flow-engine-framework_GatewayContext.md
@@ -22,7 +22,7 @@ GatewayContext 是框架内部获取流程操作人（IFlowOperator）数据的
 <dependency>
     <groupId>com.codingapi.flow</groupId>
     <artifactId>flow-engine-framework</artifactId>
-    <version>0.0.42</version>
+    <version>0.0.43</version>
 </dependency>
 ```
 
diff --git a/docs/components/flow-engine-framework_GroovyScriptBind.md b/docs/components/flow-engine-framework_GroovyScriptBind.md
@@ -22,7 +22,7 @@ GroovyScriptBind 是脚本编写者在流程 Groovy 脚本中通过 `$bind` 变
 <dependency>
     <groupId>com.codingapi.flow</groupId>
     <artifactId>flow-engine-framework</artifactId>
-    <version>0.0.42</version>
+    <version>0.0.43</version>
 </dependency>
 ```
 
diff --git a/docs/components/flow-engine-framework_GroovyScriptRequest.md b/docs/components/flow-engine-framework_GroovyScriptRequest.md
@@ -22,7 +22,7 @@ GroovyScriptRequest 是流程 Groovy 脚本中 `request` 参数的实际类型
 <dependency>
     <groupId>com.codingapi.flow</groupId>
     <artifactId>flow-engine-framework</artifactId>
-    <version>0.0.42</version>
+    <version>0.0.43</version>
 </dependency>
 ```
 
diff --git a/docs/components/flow-engine-framework_GroovyWorkflowRequest.md b/docs/components/flow-engine-framework_GroovyWorkflowRequest.md
@@ -22,7 +22,7 @@ GroovyWorkflowRequest 用于工作流级别（非会话级别）的脚本场景
 <dependency>
     <groupId>com.codingapi.flow</groupId>
     <artifactId>flow-engine-framework</artifactId>
-    <version>0.0.42</version>
+    <version>0.0.43</version>
 </dependency>
 ```
 
diff --git a/docs/components/flow-engine-framework_IFlowOperator.md b/docs/components/flow-engine-framework_IFlowOperator.md
@@ -22,7 +22,7 @@ IFlowOperator 是流程引擎中对参与流程的用户（审批人、创建者
 <dependency>
     <groupId>com.codingapi.flow</groupId>
     <artifactId>flow-engine-framework</artifactId>
-    <version>0.0.42</version>
+    <version>0.0.43</version>
 </dependency>
 ```
 
diff --git a/docs/components/flow-engine-framework_RepositoryHolderContext.md b/docs/components/flow-engine-framework_RepositoryHolderContext.md
@@ -22,7 +22,7 @@ RepositoryHolderContext 是流程引擎运行时的基础设施注册中心。
 <dependency>
     <groupId>com.codingapi.flow</groupId>
     <artifactId>flow-engine-framework</artifactId>
-    <version>0.0.42</version>
+    <version>0.0.43</version>
 </dependency>
 ```
 
diff --git a/docs/components/flow-engine-framework_ScriptRegistryContext.md b/docs/components/flow-engine-framework_ScriptRegistryContext.md
@@ -22,7 +22,7 @@ ScriptRegistryContext 是流程引擎中所有默认 Groovy 脚本的注册中
 <dependency>
     <groupId>com.codingapi.flow</groupId>
     <artifactId>flow-engine-framework</artifactId>
-    <version>0.0.42</version>
+    <version>0.0.43</version>
 </dependency>
 ```
 
diff --git a/flow-engine-example/pom.xml b/flow-engine-example/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>com.codingapi.flow</groupId>
         <artifactId>flow-engine-parent</artifactId>
-        <version>0.0.42</version>
+        <version>0.0.43</version>
         <relativePath>../pom.xml</relativePath>
     </parent>
 
diff --git a/flow-engine-framework/pom.xml b/flow-engine-framework/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>com.codingapi.flow</groupId>
         <artifactId>flow-engine-parent</artifactId>
-        <version>0.0.42</version>
+        <version>0.0.43</version>
     </parent>
 
     <name>flow-engine-framework</name>
diff --git a/flow-engine-framework/src/main/java/com/codingapi/flow/node/nodes/ConditionBranchNode.java b/flow-engine-framework/src/main/java/com/codingapi/flow/node/nodes/ConditionBranchNode.java
@@ -41,6 +41,7 @@ public static ConditionBranchNode defaultNode(){
         conditionBranchNode.setOrder(0);
         conditionBranchNode.setActions(new ArrayList<>());
         conditionBranchNode.setStrategies(new ArrayList<>());
+        conditionBranchNode.conditionScript = ConditionScript.defaultScript();
         return conditionBranchNode;
     }
 
diff --git a/flow-engine-framework/src/main/java/com/codingapi/flow/node/nodes/InclusiveNode.java b/flow-engine-framework/src/main/java/com/codingapi/flow/node/nodes/InclusiveNode.java
@@ -41,11 +41,11 @@ public static InclusiveNode defaultNode(){
     public void addDefaultBranch(int count){
         List<IFlowNode> branches = new ArrayList<>();
         for (int i=0;i<count;i++){
-            InclusiveBranchNode branchNode = new InclusiveBranchNode();
+            InclusiveBranchNode branchNode = InclusiveBranchNode.defaultNode();
             branchNode.setOrder(i+1);
             branches.add(branchNode);
         }
-        branches.add(new InclusiveElseBranchNode());
+        branches.add(InclusiveElseBranchNode.defaultNode());
         this.setBlocks(branches);
     }
 
diff --git a/flow-engine-framework/src/main/java/com/codingapi/flow/node/nodes/ManualNode.java b/flow-engine-framework/src/main/java/com/codingapi/flow/node/nodes/ManualNode.java
@@ -56,7 +56,7 @@ public List<IFlowNode> filterBranches(List<IFlowNode> nodeList, FlowSession flow
     public void addDefaultBranch(int count) {
         List<IFlowNode> branches = new ArrayList<>();
         for (int i = 0; i < count; i++) {
-            ManualBranchNode branchNode = new ManualBranchNode();
+            ManualBranchNode branchNode = ManualBranchNode.defaultNode();
             branchNode.setOrder(i + 1);
             branches.add(branchNode);
         }
diff --git a/flow-engine-framework/src/main/java/com/codingapi/flow/node/nodes/ParallelNode.java b/flow-engine-framework/src/main/java/com/codingapi/flow/node/nodes/ParallelNode.java
@@ -38,7 +38,7 @@ public static ParallelNode defaultNode(){
     public void addDefaultBranch(int count){
         List<IFlowNode> branches = new ArrayList<>();
         for (int i=0;i<count;i++){
-            ParallelBranchNode branchNode = new ParallelBranchNode();
+            ParallelBranchNode branchNode = ParallelBranchNode.defaultNode();
             branchNode.setOrder(i+1);
             branches.add(branchNode);
         }
diff --git a/flow-engine-framework/src/main/java/com/codingapi/flow/script/factory/FlowGroovyScriptFactory.java b/flow-engine-framework/src/main/java/com/codingapi/flow/script/factory/FlowGroovyScriptFactory.java
@@ -17,9 +17,9 @@ public class FlowGroovyScriptFactory {
     public static GroovyScript createRouterScript(String script) {
         String key = FlowIDGeneratorGatewayContext.getInstance().generateFlowScriptKey();
         String description = """
-                路由触发脚本\\n
-                传入对象为GroovyScriptRequest对象，返回数据格式为String类型\\n
-                返回的是为跳转的流程节点id，即nodeId。
+                <strong>路由触发脚本</strong>
+                传入对象为 <code>GroovyScriptRequest</code> 对象，返回数据格式为 <code>String</code> 类型。
+                返回的是为跳转的流程节点 id，即 <code>nodeId</code>。
                 """;
 
         GroovyScript groovyScript = GroovyScript.builder(key)
@@ -40,9 +40,9 @@ public static GroovyScript createRouterScript(String script) {
     public static GroovyScript createNodeTitleScript(String script) {
         String key = FlowIDGeneratorGatewayContext.getInstance().generateFlowScriptKey();
         String description = """
-                节点待办标题脚本\\n
-                传入对象为GroovyScriptRequest对象，返回数据格式为String类型，即为展示的待办标题数据。\\n
-                标题数据支持html的语法格式，以适配不同的标题表现形式数据。例如 return "你好，<span style=\"color:read\">XXX</span>你有一个待办数据"
+                <strong>节点待办标题脚本</strong>
+                传入对象为 <code>GroovyScriptRequest</code> 对象，返回数据格式为 <code>String</code> 类型，即为展示的待办标题数据。
+                标题数据支持 HTML 语法格式，以适配不同的标题表现形式。例如：<br><code>return '你好，&lt;span style="color:red"&gt;XXX&lt;/span&gt;你有一个待办数据'</code>
                 """;
 
         GroovyScript groovyScript = GroovyScript.builder(key)
@@ -64,9 +64,9 @@ public static GroovyScript createNodeTitleScript(String script) {
     public static GroovyScript createConditionScript(String script) {
         String key = FlowIDGeneratorGatewayContext.getInstance().generateFlowScriptKey();
         String description = """
-                条件匹配脚本\\n
-                传入对象为GroovyScriptRequest对象，返回数据格式为Boolean类型，返回true则为满足条件，执行后续的操作，返回false则不执行后续条件。\\n
-                当所有的条件都不满足的时候，默认会执行其他情况，即else的操作逻辑。
+                <strong>条件匹配脚本</strong>
+                传入对象为 <code>GroovyScriptRequest</code> 对象，返回数据格式为 <code>Boolean</code> 类型。返回 <code>true</code> 则为满足条件，执行后续操作；返回 <code>false</code> 则不执行后续条件。
+                当所有条件都不满足时，默认会执行其他情况，即 <code>else</code> 的操作逻辑。
                 """;
 
         GroovyScript groovyScript = GroovyScript.builder(key)
@@ -87,9 +87,9 @@ public static GroovyScript createConditionScript(String script) {
     public static GroovyScript createTriggerScript(String script) {
         String key = FlowIDGeneratorGatewayContext.getInstance().generateFlowScriptKey();
         String description = """
-                触发节点脚本\\n
-                脚本说明：即用户自定义处理逻辑。\\n
-                传入对象为GroovyScriptRequest对象，返回数据格式为Void类型，即不需要返回数据。\\n
+                <strong>触发节点脚本</strong>
+                脚本说明：即用户自定义处理逻辑。
+                传入对象为 <code>GroovyScriptRequest</code> 对象，返回数据格式为 <code>Void</code> 类型，即不需要返回数据。
                 """;
 
         GroovyScript groovyScript = GroovyScript.builder(key)
@@ -111,9 +111,9 @@ public static GroovyScript createTriggerScript(String script) {
     public static GroovyScript createSubProcessScript(String script) {
         String key = FlowIDGeneratorGatewayContext.getInstance().generateFlowScriptKey();
         String description = """
-                子流程任务脚本\\n
-                传入对象为GroovyScriptRequest对象，返回数据格式为FlowCreateRequest类型\\n
-                概对象是流程发起的参数对象，通过构建该对象控制子流程触发的流程节点。
+                <strong>子流程任务脚本</strong>
+                传入对象为 <code>GroovyScriptRequest</code> 对象，返回数据格式为 <code>FlowCreateRequest</code> 类型。
+                该对象是流程发起的参数对象，通过构建该对象控制子流程触发的流程节点。
                 """;
 
 
@@ -135,9 +135,9 @@ public static GroovyScript createSubProcessScript(String script) {
     public static GroovyScript createOperatorLoadScript(String script) {
         String key = FlowIDGeneratorGatewayContext.getInstance().generateFlowScriptKey();
         String description = """
-                匹配人员列表脚本\\n
-                传入对象为GroovyScriptRequest对象，返回数据格式为List<Long>类型，即long[]数组格式，每一个long的id数据为一个人员的id，实例格式为[1,2,3]\\n
-                返回的人员id将会作为匹配人员信息，作为流程的审批者。
+                <strong>匹配人员列表脚本</strong>
+                传入对象为 <code>GroovyScriptRequest</code> 对象，返回数据格式为 <code>List&lt;Long&gt;</code> 类型，即 <code>long[]</code> 数组格式，每一个 <code>long</code> 的 id 数据为一个人员的 id，示例格式为 <code>[1,2,3]</code>。
+                返回的人员 id 将会作为匹配人员信息，作为流程的审批者。
                 """;
 
         GroovyScript groovyScript = GroovyScript.builder(key)
@@ -158,8 +158,8 @@ public static GroovyScript createOperatorLoadScript(String script) {
     public static GroovyScript createOperatorMatchScript(String script) {
         String key = FlowIDGeneratorGatewayContext.getInstance().generateFlowScriptKey();
         String description = """
-                人员匹配脚本\\n
-                传入对象为GroovyWorkflowRequest类型的request对象，返回数据为Boolean类型，返回true时表明该人拥有发起流程的权限，否则反之。
+                <strong>人员匹配脚本</strong>
+                传入对象为 <code>GroovyWorkflowRequest</code> 类型的 request 对象，返回数据为 <code>Boolean</code> 类型。返回 <code>true</code> 时表明该人拥有发起流程的权限，否则反之。
                 """;
 
         GroovyScript groovyScript = GroovyScript.builder(key)
@@ -180,13 +180,13 @@ public static GroovyScript createOperatorMatchScript(String script) {
     public static GroovyScript createErrorTriggerScript(String script) {
         String key = FlowIDGeneratorGatewayContext.getInstance().generateFlowScriptKey();
         String description = """
-                异常触发脚本\\n
-                脚本说明：所谓的异常脚本，是指流程在执行时没有匹配到审批人员时触发的情况。\\n
-                传入对象为GroovyScriptRequest对象，返回数据格式为Object类型，实际支持两种数据结构。\\n
-                一种是String格式的字符串，对应的节点Id(nodeId)。\\n
-                当返回的是字符串类型的节点id时，则会当出现异常时会跳转到对应的节点上去执行审批。\\n
-                另一种是List<Long>，即long[]格式，实例格式为return [1,2,3]\\n
-                当返回的为List<Long>格式时，代表的是指定审批人员，即当异常时将会将这个流程转交给指定的这些人员来审批。
+                <strong>异常触发脚本</strong>
+                脚本说明：所谓的异常脚本，是指流程在执行时没有匹配到审批人员时触发的情况。
+                传入对象为 <code>GroovyScriptRequest</code> 对象，返回数据格式为 <code>Object</code> 类型，实际支持两种数据结构：
+                <ul>
+                <li><strong>String 格式</strong>：对应的节点 id（<code>nodeId</code>）。当返回字符串类型的节点 id 时，出现异常时会跳转到对应的节点上执行审批。</li>
+                <li><strong>List&lt;Long&gt; 格式</strong>：即 <code>long[]</code> 格式，示例：<code>return [1,2,3]</code>。当返回 <code>List&lt;Long&gt;</code> 格式时，代表指定审批人员，即当异常时将会将这个流程转交给指定的这些人员来审批。</li>
+                </ul>
                 """;
 
 
@@ -208,10 +208,18 @@ public static GroovyScript createErrorTriggerScript(String script) {
     public static GroovyScript createActionCustomScript(String script) {
         String key = FlowIDGeneratorGatewayContext.getInstance().generateFlowScriptKey();
         String description = """
-                自定义脚本\\n
-                脚本说明：即当点击自定义按钮时的操作逻辑，在完成自定义的业务之后，需要再联动一个动作。\\n
-                传入对象为GroovyScriptRequest对象，返回数据格式为String类型，为操作类型，数据分类有SAVE、PASS、REJECT、ADD_AUDIT、DELEGATE、RETURN、TRANSFER。\\n
-                对应的业务含义分为为：保存、通过、拒绝、加签、委派、退回、转办。\\n
+                <strong>自定义脚本</strong>
+                脚本说明：即当点击自定义按钮时的操作逻辑，在完成自定义的业务之后，需要再联动一个动作。
+                传入对象为 <code>GroovyScriptRequest</code> 对象，返回数据格式为 <code>String</code> 类型，为操作类型。数据分类及对应的业务含义如下：
+                <ul>
+                <li><code>SAVE</code> — 保存</li>
+                <li><code>PASS</code> — 通过</li>
+                <li><code>REJECT</code> — 拒绝</li>
+                <li><code>ADD_AUDIT</code> — 加签</li>
+                <li><code>DELEGATE</code> — 委派</li>
+                <li><code>RETURN</code> — 退回</li>
+                <li><code>TRANSFER</code> — 转办</li>
+                </ul>
                 """;
 
         GroovyScript groovyScript = GroovyScript.builder(key)
@@ -232,11 +240,13 @@ public static GroovyScript createActionCustomScript(String script) {
     public static GroovyScript createActionRejectScript(String script) {
         String key = FlowIDGeneratorGatewayContext.getInstance().generateFlowScriptKey();
         String description = """
-                拒绝操作脚本\\n
-                脚本说明：即当用户点击拒绝时会发生的处理逻辑。\\n
-                传入对象为GroovyScriptRequest对象，返回数据格式为String类型，数据分为两种情况。\\n
-                一种是返回固定的TERMINATE字符串，TERMINATE代表的是终止流程。\\n
-                另一种是节点id，即nodeId的字符串，代表的是跳转到的指定的节点。\\n
+                <strong>拒绝操作脚本</strong>
+                脚本说明：即当用户点击拒绝时会发生的处理逻辑。
+                传入对象为 <code>GroovyScriptRequest</code> 对象，返回数据格式为 <code>String</code> 类型，数据分为两种情况：
+                <ul>
+                <li>返回固定的 <code>TERMINATE</code> 字符串，代表终止流程。</li>
+                <li>返回节点 id，即 <code>nodeId</code> 的字符串，代表跳转到指定的节点。</li>
+                </ul>
                 """;
 
         GroovyScript groovyScript = GroovyScript.builder(key)
diff --git a/flow-engine-starter-api/pom.xml b/flow-engine-starter-api/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>com.codingapi.flow</groupId>
         <artifactId>flow-engine-parent</artifactId>
-        <version>0.0.42</version>
+        <version>0.0.43</version>
     </parent>
 
     <name>flow-engine-starter-api</name>
diff --git a/flow-engine-starter-infra/pom.xml b/flow-engine-starter-infra/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>com.codingapi.flow</groupId>
         <artifactId>flow-engine-parent</artifactId>
-        <version>0.0.42</version>
+        <version>0.0.43</version>
     </parent>
 
     <name>flow-engine-starter-infra</name>
diff --git a/flow-engine-starter-query/pom.xml b/flow-engine-starter-query/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>com.codingapi.flow</groupId>
         <artifactId>flow-engine-parent</artifactId>
-        <version>0.0.42</version>
+        <version>0.0.43</version>
     </parent>
 
     <name>flow-engine-starter-query</name>
diff --git a/flow-engine-starter/pom.xml b/flow-engine-starter/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>com.codingapi.flow</groupId>
         <artifactId>flow-engine-parent</artifactId>
-        <version>0.0.42</version>
+        <version>0.0.43</version>
     </parent>
 
     <name>flow-engine-starter</name>
diff --git a/flow-frontend b/flow-frontend
@@ -1 +1 @@
-Subproject commit a5597f66b9ece0cdd8434732250fab2bae3c0c55
+Subproject commit e8c28d5c9d264d231b4c36d26aa9d8a9b9c5a7d3
diff --git a/pom.xml b/pom.xml
@@ -10,7 +10,7 @@
 	</parent>
 	<groupId>com.codingapi.flow</groupId>
 	<artifactId>flow-engine-parent</artifactId>
-	<version>0.0.42</version>
+	<version>0.0.43</version>
     <packaging>pom</packaging>
 
     <url>https://github.com/codingapi/flow-engine</url>
