Flowable16信号事件----------------持续更新中

1.定义

信号事件就像一个公共广播系统。当一个信号被“抛出”（Throw）时，它不是发给某一个特定的流程实例，而是向整个 Flowable 引擎广播一个通知。所有正在等待这个信号的流程实例（们）都会同时“捕获”（Catch）到它，并继续执行。这是一种 一对多 (One-to-many) 的通信模式。

2. 关键特性

全局性 (Global)：信号的作用域是整个流程引擎，而不是单个流程实例。
基于名称 (Name-based)：信号的识别完全依赖于它的名称。例如，一个名为 user-cancelled 的信号会被所有监听 user-cancelled 的事件捕获。
解耦 (Decoupled)：发送信号的实体（可以是另一个流程，也可以是外部的 Java 代码）与接收信号的流程实例之间是完全解耦的。发送者不需要知道谁在监听，监听者也不需要知道是谁发送的。
同步或异步：信号的发送可以是同步的，也可以是异步的，这取决于你的配置和使用场景。

3. 信号事件的类型和用法

信号事件可以在流程的多个地方使用：
信号启动事件 (Signal Start Event)
图标：一个圆圈，中间有一个三角形。
作用：用一个全局信号来启动一个新的流程实例。
场景：当一个外部系统完成了一项重要的初始化任务（如“日终结算完成”），它就可以发送一个信号，所有以此信号为起点的流程（如“生成日报表”、“数据归档”等）都会被启动。
中间信号捕获事件 (Intermediate Signal Catching Event)
图标：双层圆圈，中间有一个空心三角形。
作用：流程执行到这个节点时会暂停，进入等待状态，直到它所定义的信号被广播出来。
场景：一个订单流程在“等待付款”后，进入了“备货”环节。此时如果收到一个全局的 warehouse-maintenance (仓库维护) 信号，流程可以捕获它并进入一个“暂停备货”的路径。
中间信号抛出事件 (Intermediate Signal Throwing Event)
图标：双层圆圈，中间有一个实心三角形。
作用：流程执行到这个节点时，会主动向外广播一个信号。
场景：一个“新员工入职”流程成功完成后，它会抛出一个 new-employee-onboarded 信号，通知所有相关的其他流程（如“权限分配流程”、“资产申领流程”）可以开始了。
信号边界事件 (Signal Boundary Event)
图标：附加在活动（如用户任务）边框上的一个圆圈，中间有一个三角形。
作用：当它所附加的活动正在执行时，如果捕获到指定的信号，它会中断（或不中断，可配置）该活动，并将流程引向另一条路径。
场景：在一个“经理审批”的用户任务上，附加一个 order-cancelled-by-user 信号边界事件。如果经理还没审批，但用户通过另一个系统取消了订单，该系统发送一个取消信号，审批任务就会被立即中断，流程直接走向“关闭订单”的路径。

4. 在 Flowable 中如何触发信号

你主要通过 RuntimeService 来发送一个全局信号：

// 注入 RuntimeService
@Autowired
private RuntimeService runtimeService;

public void sendGlobalSignal() {
   
   
    // 发送一个名为 "my-signal" 的信号
    // 所有等待这个信号的流程实例都会被激活
    runtimeService.signalEventReceived("my-signal");

    // 你也可以在发送信号的同时传递一些流程变量
    Map<String, Object> variables = new HashMap<>();
    variables.put("reason", "Urgent escalation");
    runtimeService.signalEventReceived("my-signal", variables);
}

信号事件 vs. 消息事件 (Signal vs. Message)

这是理解这两种事件的关键部分。如果你把信号理解为“广播”，那么请把消息理解为**“点对点通信”，就像发送一封指定收件人的电子邮件**。

特性	信号事件 (Signal Event)	消息事件 (Message Event)
核心思想	广播 (Broadcast)	单点投递 (Point-to-Point)
目标	一对多 (One-to-Many)。 发送给所有正在监听此信号的流程实例	一对一 (One-to-One)。 明确发送给某一个特定的流程实例
标识方式	仅通过信号名称 (signalName)。	通过消息名称 (messageName) + 实例关联信息。 引擎需要知道把消息送给哪个实例，通常通过流程实例ID或业务标识（Business Key）来关联。
典型用途	1. 系统级状态同步（如系统维护）。 2. 触发多个相关流程（如入职成功后触发多个后续流程）。 3. 跨流程的全局取消或通知。	1. 两个流程实例之间的直接通信。 2. 外部系统回调（如支付成功后，支付网关回调通知那笔订单的流程）。 3. 启动一个与特定业务数据关联的新流程。
Flowable API (触发方式)	runtimeService.signalEventReceived(signalName, …)	runtimeService.messageEventReceived(messageName, executionId, …) 注意：这里需要一个 executionId 来定位到具体的执行实例。
类比	公共广播 / AM/FM 电台 电台只管广播，所有调到这个频道的收音机都能收到。	电子邮件 / 快递 必须有明确的收件人地址，才能准确投递。

何时使用信号事件？
当你需要通知多个流程实例某个事件发生了。
当发送方不关心也不需要知道谁是接收方时。
用于实现全局的、跨流程的协调。
例子：一个管理员按下“系统紧急暂停”按钮，所有正在处理的订单流程都应该暂停。
何时使用消息事件？
当你需要与某个特定的流程实例进行交互时。
当一个流程需要等待来自外部系统的、针对它自己的回调时。
当一个流程需要向另一个已知的流程发送指令时。
例子：一个订单流程调用了支付接口，然后等待支付网关返回“支付成功”的消息。这个消息只应该继续这一个订单的流程，而不是其他订单的。

业务场景

我们将设计一个非常贴合实际业务的场景：电商平台的订单履行流程，与IT部门的系统维护流程之间的交互。
这个场景完美地诠释了信号事件的“广播”和“解耦”特性。
主流程：订单履行流程 (Order Fulfillment Process)
一个客户下单后，系统启动此流程。
流程中有一个关键步骤是“与WMS（仓库管理系统）同步，分配库存”。这是一个自动化的服务任务。
正常情况下，分配库存后，流程继续走向“打包发货”。
触发流程：IT系统维护流程 (IT System Maintenance Process)
当IT部门需要对WMS进行维护时，他们会启动一个维护流程。
这个流程首先会向整个系统广播一个“维护开始”的信号。
在维护工作完成后，它会再次广播一个“维护结束”的信号。
核心交互逻辑
当“订单履行流程”正好执行到“分配库存”这一步时，如果IT部门发出了“维护开始”的信号，订单流程应该能捕获到这个信号。
捕获到信号后，订单流程应该中断当前的“分配库存”任务，并进入一个“等待维护结束”的状态。
当IT部门完成维护并发出“维护结束”的信号后，订单流程应该能再次捕获到这个新信号，然后重新尝试“分配库存”任务。
这里，信号事件是最佳选择，因为IT部门不需要知道当前有多少个订单正在运行，它只需要发出一个全局通知，所有相关的流程都应该能响应。
文件一：订单履行流程 (orderFulfillmentProcess.bpmn20.xml)
作用：这是主业务流程。它处理单个订单，并且能够响应外部的系统维护信号。
核心逻辑：
在“与WMS同步分配库存”任务上，附加了一个边界信号事件，用于捕获“维护开始”信号 (wmsMaintenanceStart)。
如果捕获到信号，流程会中断同步任务，进入等待状态。
在等待状态，一个中间信号捕获事件会等待“维护结束”信号 (wmsMaintenanceEnd)。
收到结束信号后，流程会重新尝试同步库存。

<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL"
             xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI"
             xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC"
             xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI"
             xmlns:flowable="http://flowable.org/bpmn"
             targetNamespace="http://www.flowable.org/processdef">

  <!-- 
    定义此流程关心（监听）的信号。
    即使信号由其他流程抛出，在这里定义可以使模型自描述。
  -->
  <signal id="wmsMaintenanceStartSignal" name="wmsMaintenanceStart"></signal>
  <signal id="wmsMaintenanceEndSignal" name="wmsMaintenanceEnd"></signal>

  <process id="orderFulfillmentProcess" name="E-commerce Order Fulfillment Process" isExecutable="true">
    
    <startEvent id="startOrder" name="订单已创建"></startEvent>
    <sequenceFlow id="flow_to_review" sourceRef="startOrder" targetRef="reviewOrder"></sequenceFlow>
    
    <userTask id="reviewOrder" name="审核订单"></userTask>
    <sequenceFlow id="flow_to_sync" sourceRef="reviewOrder" targetRef="syncWmsTask"></sequenceFlow>
    
    <serviceTask id="syncWmsTask" name="与WMS同步分配库存" flowable:class="com.example.flowable.delegate.SyncWmsDelegate"></serviceTask>
    <sequenceFlow id="flow_to_ship" sourceRef="syncWmsTask" targetRef="shipOrder"></sequenceFlow>
    
    <!