一、98KB 的引擎，依赖了什么？

打开 jeeflow-core 的 pom.xml运行时依赖只有一行：

org.slf4j
slf4j-api
provided

provided 代表着连 slf4j 都不打包——由集成方提供。怎么说呢，junit、jackson、slf4j-simple 全部是 test scope。不进 JAR，

jeeflow-core 编译产物：零框架依赖。 不碰 Spring、不碰 MyBatis、不碰 Jackson、不碰任何 ORM。

痛点：    你是否因为引擎绑定了大量框架而导致集成成本高、升级困难？这款引擎可让你自由选择框架。

一个工作流引擎，不依赖 JSON 库怎么解析流程定义？不依赖 ORM 怎么持久化？不依赖 Spring 怎么管理事务？答案这方面，SPI. 引擎只定义接口。实现交给集成方，说起来，

二、SPI 全景图

jeeflow 定义了 X个 SPI 接口。按必须/可选分为两档：

SPI	必须/可选	职责	不注册的后果
IProcessRepository	MUST 聚合仓储 – 引擎读写数据的唯一通道，引擎无法启动。怎么说呢，

IJsonProviderMUST JSON 序列化/反序列化 – 流程定义无法解析。

IUserProviderSOME 使用者信息提供者 – u_* 变量缺失，主要流转不受影响。

IOrgUserProviderSOME 组织维度使用者提供者 – 部门领导/角色取人不可用。

IExpressionEvaluatorSOME 条件表达式求值器 – 决策节点只能走默认分支。

IIdGeneratorSOME ID 生成器 – 内置时间戳+序号方案。

ITransactionTemplateSOME 事务模板裸执行 – 适合内存测试。

d>

IActionPermissionProvider权限码映射使用内置默认规则。

设计原则：仅 “换不掉” 的才做必选 SPI。IProcessRepository 是引擎与持久化的唯一边界，必须注册；按理说，其余全部可选 — 不注册就用默认行为，引擎照跑。 

IProcessRepository —— 面向聚合。不面向表

java public interface IProcessRepository { // 流程定义 CRUD ProcessDefine findDefineById;void saveDefine;void updateDefine;// 聚合根操作 ProcessInstance findInstanceById;void saveInstance;void updateInstance;// 任务操作 ProcessTask findTaskById;List findDoingTasks;List findDoneTasks;// 参与者操作 void addTaskActor;List findTaskActors;按理说，// 抄送 void createCcInstance;// 前端分页查询 PageResult pageTodoTasks;PageResult pageInstances;// ...}

• 关键设计： 
• 面向聚合而非表——saveInstance 保存的是整个聚合根，不是单张表的一行。引擎不知道底层有几张表，
• 读方法返回完整聚合——findInstanceById 返回的 ProcessInstance 包含所有子任务和参与者，引擎拿到就能直接操作。
• 分页方法返回轻量 DTO——TaskRow / InstanceRow 是扁平的行对象，不是领域实体。前端列表不需要加载完整聚合。
• 内存仓储验证接口——jeeflow-core 的测试包里有一个 MemoryProcessRepository。如果内存实现能跑通全部测试，说明接口没有设计过度。
•   如果你想使用自己的数据库或 NoSQL。需要自己实现此接口，否则只能使用默认内存实现，这对生产环境可能不可接受。

IJsonProvider —— 引擎不绑定 JSON 库

java public interface IJsonProvider { String toJson;T fromJson;T fromJson;boolean isJson;}

• 用途： 
• 解析流程定义 JSON.
• 序列化/反序列化流程变量。
• 持久化时的变量存储。

为什么不让引擎直接依赖 Jackson？ 

• NoSQL 集成可能更喜欢 Fastjson 或 Gson；GoFrame 用 Go 标准库 encoding/json；PHP 用 jsonencode/jsondecode。

> 把解析逻辑留给集成方可以避免版本冲突和多余依赖。

: 产生兼容性问题；不过，通过 SPI 可随时切换。怎么说呢，

IUserProvider —— 可选的使用者信息注入

java public interface IUserProvider { /** 一次返回使用者全部信息 */ UserInfo getUser;public static final class UserInfo { public final String userId;public final String realName;public final String deptId;老实说，public final String deptName;老实说，public final String postId;public final String postName;

 public static UserInfo of { …}

} }

当流程启动时 Engine 调用 FlowUtil.addUserInfoToArgs。 把使用者信息注入到流程变量中：

java // 注入后流程变量里有： // u_userid = "admin" // u_realName = "蒙立东" // u_deptid = "dept_rnd" // u_deptname = "研发部"

该方式使决策表达式可以直接引用 u_* 变量，例如 u_deptid == 'dept_finance'。

: 若未注册 IUserProvider。则所有 u_* 变量缺失，你可能需要手动补全或 业务规则。

java public interface IExpressionEvaluator { Object eval;怎么说呢，}

决策节点 的边上挂着条件表达式：

json { "sourceNode":"decision1"。"targetNode":"task_manager","properties":{ "expr"这方面，"amount>= limit" } }

Engine 调用 evaluator.eval 判断走哪条边。

Spring Boot 集成示例：

java public class SpelExpressionEvaluator implements IExpressionEvaluator { public Object eval { ExpressionParser parser = new SpelExpressionParser;StandardEvaluationContext ctx = new StandardEvaluationContext;ctx.setVariables;return parser.parseExpression.getValue;} }

若未注册。则决策节点只能走默认分支，简单审批流程无大碍。

: 对于复杂业务，你可能需要自定义表达式语言来支持更多运算符或函数；SPI 给你完全控制权，但也代表着要自行实现或集成第三方求值器。

java public interface IIdGenerator { long nextID;}

若未注册。则采用时间戳 + 序号方案，简单可靠，但在分布式场景下可能冲突。

Spring Boot 默认用雪花算法：

java public class SnowflakeIDGenerator implements IIDGenerator { @Override long nextID { …} }

业务方也可以替换为数据库序列、UUID 或自定义方案。按理说，

: 在高并发或跨机房环境下默认方案可能导致 ID 冲突。需要自行实现更健壮的生成器。

java public interface ITransactionTemplate { T execute;default void execute{…} interface Supplier{ T get throws Exception;} }

Engine 内部不带事务注解，用 runInTx 包裹需要事务的操作：

java privateT runInTx{ ITransactionTemplate tx = ServiceContext.find;ifreturn tx.execute;//有事务包事务 return action.get;//无事务裸执行 }

java public class SpringTransactionTemplate implements ITransactionTemplate{ @Autowired PlatformTransactionManager txManager;@Override T execute{ return new TransactionTemplate.execute;}catch{throw new RuntimeException;} })，} }

只调用 execute；具体怎么做由集成层决定，

: 若你所在项目已经有自研事务管理或使用其他框架。你需要自行提供相应实现，否则 Engine 将以无事务方式运行。说起来，

Jeeflow 并未使用 Spring DI。而是自己实现轻量级服务定位器。

java interface Context { void put;void put，T find;findList;}

java class SimpleContext implements Context{ private final ConcurrentHashMap objects=new ConcurrentHashMap<>;private final ConcurrentHashMap classes=new ConcurrentHashMap<>;publicT find { for){ if))return o;} return null;} }

一个 ConcurrentHashMap。即按类型查找，无反射开销。

java finalclass ServiceContext{ private static volatile Context context;public staticT find { T result=context.find;if throw new JeeflowException);老实说，return result;} }

全局静态访问点，使 Engine 任意地方通过 ServiceContext.find 拿到对应 SPI 实现。怎么说呢，

java @Configuration @ConditionalOnClass class JeeflowAutoConfiguration{ @Bean @ConditionalOnMissingBean IJsonProvider jeeflowJson{return new JacksonJsonProvider;老实说，}

@Bean @ConditionalOnMissingBean IIDGenerator jeeflowGen{return new SnowflakeIDGenerator;}

@Bean @ConditionalOnMissingBean ITransactionTemplate jeeflowTx{return new SpringTx;}

@Bean JeeflowEngine engine{ PRepo.ifAvailable);，/* 所有 SPI via ServiceContext.put */ } } @ConditionalOnMissingBean 的魔力让业务方只需声明同名 Bean 即覆盖任意 SPI 默认实现，实现零配置

除了上述基础设施 SPI 外还有业务层面的 AssignmentHandler：

java interface AssignmentHandler{ String assign;其实，} 它决定“这个任务该分配给谁”。Engine 内置 X 个实现，如 OperatorAssignmentHandler、ApplicantDeptLeaderAssignmentHandler 等。

关键设计是组织维度 handler 如 DeptLeaderAssignmentHandler 等仅通过 IOrgUserProvider 获取部门领导列表，而非直连组织服务；业务方只需实现几个方法即可复用多种 handler，无需重复编码。

有人问为何不用插件行业市场，让社区贡献 SPI 实现？

原因是 jeeflow 的目标不是“可 ”，而是 “可替换”。不过，* 插件是在引擎之上加功能；* SPI 把外部依赖暴露出来让集成方用自己的实现替换。

Jeeflow 覆盖了所有外部依赖： * 数据存储 → IProcessRepository * JSON → IJsonProvider * 使用者 → IUserProvider * 表达式 → IExpressionEvaluator * ID → IIDGenerator * 事务 → ITransactionTemplate

这样 Engine 可以跑在 Spring Boot / GoFrame / FastAPI / Laravel 等不同技术栈上—换框架不换引擎。

98KB 的 engine。零框架依赖，通过 X 个 SPI 撬动五语言环境。

SPI 并非纯粹架构洁癖，而是工程刚需——同构前提是主要不绑定任何语言特定框架；Java 引擎无需 Spring。Go 引擎无需 Gin，Python 一样如此。

至于下一篇预告，第 N 页 · 会签三兄弟：并行/串行/按比例如何组合出三种模式？一票否决级联废弃怎么做，

• {@link https://github.com/jmichaelxue/jeeflow}
• {@link https://jeeffow.io/docs/spi}
• {@link https://demo.jeeffow.io}
• {@link https://demo.jeeffow.io/admin}
• {@link https://github.com/jmichaelxue/jeeffow/blob/main/src/main/java/com/xuejin/sdk/core/IProcessRepository.java}
• {@link https://github.com/jmichaelxue/jeeffow/blob/main/src/main/java/com/xuejin/sdk/core/configuration/JeeeAutoConfiguration.java}

---

。

---