Flowable 核心 API 完全指南ProcessEngine 与 8 大服务逐个解析【免费下载链接】flowable-userguideFlowable最新中文文档,ai自动生成BPM体验地址http://flow.je4.cn/#/login项目地址: https://gitcode.com/gh_mirrors/fl/flowable-userguideFlowable 是一款轻量级、可嵌入的 Java 工作流与 BPM 引擎而Flowable 核心 API是与引擎交互的唯一下手点。无论你是刚接触工作流开发的新手还是想系统梳理 API 体系的进阶用户只要掌握了 ProcessEngine 这个总入口和它衍生的 8 大服务就能轻松驾驭流程部署、实例启动、任务办理、历史查询等全部核心能力。本文基于 Flowable 官方中文文档逐一拆解每个服务的作用与典型用法帮你快速建立完整清晰的 API 知识框架。为什么先要认识 ProcessEngineProcessEngine流程引擎是 Flowable API 的总入口所有服务都由它派生。它本身是线程安全的可以在服务器中保存并共用同一个引用这决定了你可以放心地在多线程环境甚至集群中共享引擎实例。获取引擎最简单的方式是ProcessEngine processEngine ProcessEngines.getDefaultProcessEngine();第一次调用时会自动初始化并构建引擎之后重复调用返回同一个实例。引擎会扫描 classpath 中的flowable.cfg.xml或flowable-context.xml配置文件完成构建也可以通过ProcessEngines.init()手动创建、ProcessEngines.destroy()妥善关闭。在 Web 应用中通常配合ServletContextListener在容器启动/关闭时进行初始化与销毁。拿到引擎后8 大服务一触即达RepositoryService repositoryService processEngine.getRepositoryService(); RuntimeService runtimeService processEngine.getRuntimeService(); TaskService taskService processEngine.getTaskService(); HistoryService historyService processEngine.getHistoryService(); IdentityService identityService processEngine.getIdentityService(); FormService formService processEngine.getFormService(); ManagementService managementService processEngine.getManagementService(); DynamicBpmnService dynamicBpmnService processEngine.getDynamicBpmnService();所有服务都是无状态的任何调用都是幂等的这也让 Flowable 在多节点集群中运行毫无压力。RepositoryService部署与流程定义管理RepositoryService 很可能是你使用 Flowable 时接触的第一个服务它负责管理部署Deployment与流程定义Process Definition。简单理解流程定义是 BPMN 2.0 流程对应的 Java 对象体现了流程每一步的结构与行为部署则是引擎的包装单元一个部署包中可以包含一个或多个 BPMN 2.0 XML 文件及关联资源比如hr-processes部署可以装下所有人力资源相关流程。部署时引擎会校验并分析所有流程之后这些流程就可以被启动了。除了部署RepositoryService 还能查询引擎中现有的部署与流程定义暂停或激活某个流程或整个部署获取部署内保存的资源文件、引擎自动生成的流程图获取流程定义的 POJO 形式用 Java 而非 XML 方式查看流程。RuntimeService启动并管理流程实例如果说 RepositoryService 提供的是静态信息不常变化那么 RuntimeService 负责的就是动态运行——启动新的流程实例、读写流程变量、查询流程实例与执行Execution即 BPMN 2.0 中 token 的指针。一个流程定义通常同时存在多个运行中的实例。流程变量是挂在流程实例上的数据排他网关常常靠它判断下一步走向。当流程停在等待状态wait state时也可以用 RuntimeService 的trigger等方法通知流程继续运行。快速上手指南runtimeService.startProcessInstanceByKey(yourKey)即可按流程定义 key 启动一个实例同时可传入变量 Map例如把订单号、金额等业务数据带进流程。TaskService任务处理的核心服务对于 BPM 引擎来说人机交互的任务是灵魂所在所有任务相关操作都组织在 TaskService 中它是日常开发中使用频率最高的服务之一。典型能力包括查询分配给某用户或组的任务创建独立运行standalone任务设置任务的办理人assignee认领claim与完成complete任务——认领是决定由我来办完成则是填写表单提交结果。一个完整的任务处理链路通常是taskService.createTaskQuery().taskAssignee(kermit).list()查到待办任务然后taskService.claim(taskId)认领最后taskService.complete(taskId)完成任务并推动流程前进。HistoryService历史数据查询利器流程跑完之后沉淀下来的数据由 HistoryService 统一暴露。引擎在执行过程中会保存大量可配置的历史数据例如流程实例启动时间、谁在执行哪个任务、完成任务耗时、每个实例的执行路径等HistoryService 就是查询这些数据的专用通道。上图是调试单元测试时用 H2 控制台查看 Flowable 数据表的效果——左侧能看到ACT_HI_*系列历史表与ACT_RU_*系列运行时表右侧展示了act_ru_task中一条任务记录。理解这些表结构有助于你更好地使用 HistoryService 做统计与分析。IdentityService用户与组的管理IdentityService 用于管理创建、更新、删除、查询用户与组。有一点要注意Flowable 在运行时并不强制校验用户是否存在——任务可以分配给任何用户。这是因为 Flowable 经常与 LDAP、Active Directory 等外部身份系统集成所以在引擎内部保持了灵活性。FormService可选但实用的表单服务FormService 是一个可选服务即使完全不用它Flowable 也能良好运行。它引入了开始表单start form与任务表单task form的概念开始表单在流程实例启动前展示任务表单在用户完成任务时展示这些表单可以在 BPMN 2.0 流程定义中直接声明FormService 负责以简单方式暴露这些数据。因为表单不一定嵌入流程定义所以该服务是可选的。ManagementService作业与数据库表管理ManagementService 在编写普通用户应用时通常用不到但它对运维和排查问题很有价值。它可以读取数据库表与表原始数据的信息查询与管理作业Job例如定时器Timer、异步延续、延时暂停/激活等都由作业机制支撑。如果你需要定位定时器为什么没触发异步任务卡住了吗这类问题ManagementService 就是你的排查入口。DynamicBpmnService免部署的动态修改DynamicBpmnService 提供了一种轻量热更新能力修改流程定义中的部分内容而不需要重新部署。例如可以动态修改某个用户任务的办理人设置或者调整服务任务中的类名。这在流程需要按租户/环境差异化配置的场景中非常实用。快速上手指南从部署到完成任务把上面 8 大服务串起来一个最小可用的流程闭环是这样的部署用 RepositoryService 部署 BPMN 文件获得流程定义启动用 RuntimeService 按 key 启动流程实例查任务用 TaskService 查询当前用户的待办任务办任务用 TaskService 认领并完成任务流程继续流转查历史流程结束后用 HistoryService 查询执行记录与耗时。结语与资料指引Flowable 核心 API 的设计非常清晰一个引擎入口 八个职责单一的服务。只要理解了每个服务的定位再配合官方文档的查询 API 与变量、表达式章节你就能快速写出稳健的工作流应用。本文内容主要整理自 Flowable 官方中文用户指南的 API 章节如果你希望进一步深入推荐阅读以下源码资料均为项目内文档API 与服务章节中文涵盖 8 大服务详解、异常策略、查询 API、变量与瞬时变量、单元测试等完整内容API 与服务章节英文原版英文原版便于对照查阅术语配置章节了解 ProcessEngine 的多种创建方式与配置项。如果你是新手建议按部署 → 启动 → 办任务 → 查历史的顺序动手实践一次很快就能把今天学到的 API 体系真正用起来。祝你上手顺利【免费下载链接】flowable-userguideFlowable最新中文文档,ai自动生成BPM体验地址http://flow.je4.cn/#/login项目地址: https://gitcode.com/gh_mirrors/fl/flowable-userguide创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考