Solon Flow 是一个轻量级流程编排框架（采用 yaml 或 json 偏平式编排格式）

• 支持无状态流程
  • 可用于计算（或任务）的编排场景
  • 可用于业务规则和决策处理型的编排场景
• 支持有状态流程
  • 可用于办公审批型（有状态、可中断，人员参与）的编排场景
  • 可用于长时间流程（结合自动前进，等待介入）的编排场景

有可视化的设计器：

• https://solon.noear.org/flow/designer/

嵌入第三方框架的示例：

• https://gitee.com/solonlab/solon-flow-embedded-examples
• https://gitcode.com/solonlab/solon-flow-embedded-examples
• https://github.com/solonlab/solon-flow-embedded-examples

同时兼容 java8 ~ java24。也可嵌入到 SpringBoot、jFinal、Vert.x 等框架中使用。

一、最近更新了什么？

• 调整 solon-flow stateful 相关概念（提交活动状态，改为提交操作）
• 调整 solon-flow StateType 拆分为：StateType 和 Operation
• 调整 solon-flow StatefulFlowEngine:postActivityState 更名为 postOperation
• 调整 solon-flow StatefulFlowEngine:postActivityStateIfWaiting 更名为 postOperationIfWaiting
• 调整 solon-flow StatefulFlowEngine:getActivity 更名为 getTask
• 调整 solon-flow StatefulFlowEngine:getActivitys 更名为 getTasks
• 调整 solon-flow StatefulFlowEngine 更名为 FlowStatefulService（确保引擎的单一性）
• 添加 solon-flow FlowStatefulService 接口，替换 StatefulFlowEngine（确保引擎的单一性）
• 添加 solon-flow FlowEngine:statefulService() 方法
• 添加 solon-flow FlowEngine:getDriverAs() 方法

方法名称调整：

状态类型拆解后的对应关系（之前状态与操作混一起，不合理）

二、特色展示

1、采用 yaml 或 json 偏平式编排格式

偏平式编排，没有深度结构（所有节点平铺，使用 link 描述连接关系）。配置简洁，关系清晰

# c1.yml
id: "c1"
layout: 
  - { id: "n1", type: "start", link: "n2"}
  - { id: "n2", type: "activity", link: "n3"}
  - { id: "n3", type: "end"}

还支持简化模式（能自动推断的，都会自动处理），具体参考相关说明

# c1.yml
id: "c1"
layout: 
  - { type: "start"}
  - { task: ""}
  - { type: "end"}

2、表达式与脚本自由

# c2.yml
id: "c2"
layout: 
  - { type: "start"}
  - { when: "order.getAmount() >= 100", task: "order.setScore(0);"}
  - { when: "order.getAmount() > 100 && order.getAmount() <= 500", task: "order.setScore(100);"}
  - { when: "order.getAmount() > 500 && order.getAmount() <= 1000", task: "order.setScore(500);"}
  - { type: "end"}

3、元数据配置，为扩展提供了无限空间

元数据主要有两个作用：（1）为任务运行提供配置支持（2）为视图编辑提供配置支持

# c3.yml
id: "c3"
layout: 
  - { id: "n1", type: "start", link: "n2"}
  - { id: "n2", type: "activity", link: "n3", meta: {cc: "demo@noear.org"}, task: "@MetaProcessCom"}
  - { id: "n3", type: "end"}

通过组件方式，实现元数据的抄送配置效果

@Component("MetaProcessCom")
public class MetaProcessCom implements TaskComponent {
    @Override
    public void run(FlowContext context, Node node) throws Throwable {
       String cc = node.getMeta("cc");
       if(Utils.isNotEmpty(cc)){
           //发送邮件...
       }
    }
}

4、事件广播与回调支持

广播（即只需要发送），回调（即发送后要求给答复）

id: f4
layout:
  - task: |
      //只发送
      context.<String,String>eventBus().send("demo.topic", "hello");  //支持泛型（类型按需指定，不指定时为 object）
  - task: |
      //发送并要求响应（就是要给答复）
      String rst = context.<String,String>eventBus().sendAndRequest("demo.topic.get", "hello");
      System.out.println(rst);

5、支持无状态、有状态两种应用

支持丰富的应用场景：

• 无状态流程
  • 可用于计算（或任务）的编排场景
  • 可用于业务规则和决策处理型的编排场景
• 有状态流程
  • 可用于办公审批型（有状态、可中断，人员参与）的编排场景
  • 可用于长时间流程（结合自动前进，等待介入）的编排场景

自身也相当于一个低代码的运行引擎（单个配置文件，也可满足所有的执行需求）。

6、驱动定制（是像 JDBC 有 MySql, PostgreSQL，还可能有 Elasticsearch）

这是一个定制后的，支持基于有状态驱动的流程引擎效果（比如支持行政审批）。

FlowEngine flowEngine = FlowEngine.newInstance(StatefulSimpleFlowDriver.builder()
                .stateOperator(new MetaStateOperator("actor"))
                .stateRepository(new InMemoryStateRepository())
                .build());
FlowStatefulService statefulService =  flowEngine.statefulService();
                
var context = new FlowContext("i1").put("actor", "陈鑫");

//获取上下文用户的任务
var task = statefulService.getTask("f1", context);

assert "step2".equals(task.getNode().getId());
assert StateType.UNKNOWN == task.getState(); //没有权限启动任务（因为没有配置操作员）

//提交操作
statefulService.postOperation(context, task.getNode(), Operation.COMPLETED);

流程配置样例：

id: f1
layout:
  - {id: step1, title: "发起审批", type: "start"}
  - {id: step2, title: "抄送", meta: {cc: "吕方"}, task: "@OaMetaProcessCom"}
  - {id: step3, title: "审批", meta: {actor: "陈鑫", cc: "吕方"}, task: "@OaMetaProcessCom"}
  - {id: step4, title: "审批", type: "parallel", link: [step4_1, step4_2]}
  - {id: step4_1, meta: {actor: "陈宇"}, link: step4_end}
  - {id: step4_2, meta: {actor: "吕方"}, link: step4_end}
  - {id: step4_end, type: "parallel"}
  - {id: step5, title: "抄送", meta: {cc: "吕方"}, task: "@OaMetaProcessCom"}
  - {id: step6, title: "结束", type: "end"}

对于驱动器的定制，我们还可以：定制（或选择）不同的脚本执行器、组件容器实现等。