Camunda 服务任务（Service Task）的 5 种实现方式详解

2. Java class（Java 类）

填写规则

• Implementation 选 Java class
• 下方 Java Class 输入框：填写完整类名（包名 + 类名），类必须实现 org.camunda.bpm.engine.delegate.JavaDelegate 接口
• 要求：该类必须在 Camunda 引擎的类路径下（Spring Boot 项目中需加 @Component 或手动注册到 Spring 容器）

示例

• 完整类名填写：com.example.camunda.service.LeaveApprovalService
• 对应代码类：

package com.example.camunda.service; // 包名必须和配置的一致

import org.camunda.bpm.engine.delegate.DelegateExecution;
import org.camunda.bpm.engine.delegate.JavaDelegate;
import org.springframework.stereotype.Component;

@Component // 交给 Spring 管理
public class LeaveApprovalService implements JavaDelegate {
    @Override
    public void execute(DelegateExecution execution) throws Exception {
        // 业务逻辑
    }
}

适用场景

• 简单的同步业务逻辑，代码和流程引擎耦合度可接受
• 不需要灵活调用方法，仅需执行固定的 execute 方法

3. Expression（表达式）

填写规则

• Implementation 选 Expression
• 下方 Expression 输入框：填写 Spring EL 表达式，格式为 ${bean 名称。方法名 (参数 1, 参数 2,...)}
  • bean 名称：Spring 容器中的 Bean 名（默认类名首字母小写，或 @Service("自定义名") 指定）
  • 方法名：Bean 中的具体方法名
  • 参数：可填流程变量名（直接写变量名）、常量（字符串加引号，数字直接写）
• 可选：Result Variable 输入框：填写变量名，用于接收方法返回值（回写到流程变量）

示例

场景 1：调用无参方法

• Expression：${leaveService.checkDefaultRule()}
• 对应代码：

@Service("leaveService")
public class LeaveService {
    public boolean checkDefaultRule() {
        return true;
    }
}

场景 2：调用带流程变量参数的方法

• Expression：${leaveService.checkLeaveLimit(applicant, leaveDays)}
  • applicant、leaveDays 是流程变量名，会自动传入方法
• Result Variable：checkResult（方法返回值会存到这个流程变量中）
• 对应代码：

@Service("leaveService")
public class LeaveService {
    public boolean checkLeaveLimit(String applicant, Integer leaveDays) {
        System.out.println("校验" + applicant + "的请假天数：" + leaveDays);
        return leaveDays <= 5;
    }
}

场景 3：调用带常量 + 流程变量的方法

• Expression：${leaveService.calcLeaveDays(leaveDays, "2026-01-20")}
  • leaveDays 是流程变量，"2026-01-20" 是常量字符串

适用场景

• 需要灵活调用 Bean 的任意方法（而非固定的 execute 方法）
• 方法有明确的参数和返回值，需直接映射到流程变量

4. Delegate expression（委托表达式）

填写规则

• Implementation 选 Delegate expression
• 下方 Delegate Expression 输入框：填写 Spring EL 表达式，格式为 ${bean 名称}
  • bean 名称：Spring 容器中的 Bean 名，该 Bean 必须实现 JavaDelegate 或 ActivityBehavior 接口
• 核心：表达式只指定 Bean 名，引擎会自动调用该 Bean 的 execute 方法

示例

• Delegate Expression：${leaveApprovalService}
• 对应代码（和 Java class 的类结构一致，仅配置方式不同）：

@Component("leaveApprovalService") // Bean 名必须和表达式中的一致
public class LeaveApprovalService implements JavaDelegate {
    @Override
    public void execute(DelegateExecution execution) throws Exception {
        // 业务逻辑
    }
}

适用场景

• 推荐！Spring Boot 集成 Camunda 的首选方式，比 Java class 更灵活（支持 Spring 依赖注入）
• 代码复用性高（同一个 Bean 可被多个服务节点调用）
• 便于单元测试（可通过 Spring 上下文注入 Mock Bean）

5. Connector（连接器）

填写规则

• Implementation 选 Connector
• 下方 Connector Id 输入框：填写内置/自定义连接器 ID（Camunda 内置了部分连接器，如 http-connector、email-connector）
• 点击 Edit 按钮：在弹出的面板中配置连接器参数（键值对，不同连接器参数不同）

示例（最常用的 HTTP 连接器）

步骤 1：填写 Connector Id

• Connector Id：http-connector

步骤 2：配置参数（Edit 面板中）

适用场景

• 无需编写 Java 代码，直接调用外部 HTTP 接口、发送邮件、操作数据库
• 简单的集成场景（如调用第三方 API、发送通知）
• 非定制化的通用操作（避免重复编写 HTTP 调用、邮件发送代码）

注意

• 内置连接器需引入对应依赖（如 HTTP 连接器需 camunda-connect-http-client）
• 复杂的业务逻辑不适合用 Connector，仍需用 Java 代码实现

总结

核心建议：日常开发优先用 Delegate expression（简单、适配 Spring），耗时任务用 External，无代码集成用 Connector，Expression 用于灵活调用特定方法，Java class 仅做兼容使用。