Liên kết mô hình với mã thực thi bằng Properties Panel

1. Properties Panel: Cầu nối giữa Sơ đồ và Mã nguồn

Hãy bắt đầu bằng cách xác lập lại vai trò của Properties Panel. Với kinh nghiệm là một developer, bạn có thể coi đây là "bảng điều khiển API" cho mỗi phần tử trên sơ đồ BPMN. Nó không chỉ dùng để đặt tên hay viết mô tả. Đây là nơi bạn định nghĩa hành vi thực thi (execution behavior) của quy trình.

Mỗi thuộc tính bạn cấu hình trong panel này—từ Implementation của một Service Task đến Condition của một luồng đi—chính là chỉ thị để Camunda Process Engine biết phải làm gì, gọi đoạn mã nào, hay đưa ra quyết định ra sao tại mỗi bước.

2. Cách 1: Kết nối trực tiếp với Java Class

Đây là phương pháp cơ bản nhất để thực thi mã Java. Bạn sẽ tạo một lớp Java implement interface org.camunda.bpm.engine.delegate.JavaDelegate và sau đó chỉ định tên đầy đủ (fully qualified name) của lớp này trong Properties Panel.

Hãy xem một video hướng dẫn chi tiết từ Camunda để hình dung rõ hơn.

Tóm tắt các bước:

1. Viết một lớp Java implement JavaDelegate. Phương thức execute(DelegateExecution execution) là nơi bạn đặt logic nghiệp vụ của mình.
2. Trong Camunda Modeler, chọn Service Task.
3. Trong Properties Panel, tab General, mục Implementation, chọn Java Class.
4. Dán tên đầy đủ của lớp Java (bao gồm cả package) vào trường Java Class.

• Ưu điểm: Đơn giản, dễ hiểu.
• Nhược điểm: Rất "giòn" (brittle). Nếu bạn tái cấu trúc (refactor) code và di chuyển lớp Java đó sang một package khác, liên kết này sẽ bị hỏng và quy trình của bạn sẽ không chạy được. Điều này dẫn chúng ta đến một phương pháp tốt hơn.

3. Cách 2 (Khuyên dùng): Delegate Expression với Spring

Trong một ứng dụng Spring Boot hiện đại, bạn không quản lý các đối tượng một cách thủ công. Thay vào đó, bạn để Spring container quản lý chúng dưới dạng các beans. Delegate Expression là cách để Camunda tận dụng cơ chế này.

Thay vì chỉ định một đường dẫn lớp cứng, bạn chỉ cần cung cấp một biểu thức trỏ đến một Spring Bean.

Tại sao đây là cách tốt hơn?

• Tính linh hoạt: Bạn có thể đổi tên package của lớp delegate thoải mái, miễn là tên bean không đổi, quy trình vẫn hoạt động bình thường.
• Tận dụng sức mạnh của Spring: Lớp delegate của bạn giờ là một Spring Bean, nghĩa là bạn có thể tiêm (inject) các bean khác (như services, repositories) vào nó bằng @Autowired. Điều này làm cho việc tích hợp logic nghiệp vụ trở nên cực kỳ mạnh mẽ và sạch sẽ.

4. Cách 3: Sử dụng Expression cho Logic Đơn giản và Điều kiện

Biểu thức (Expression) là một công cụ cực kỳ linh hoạt, không chỉ dùng cho Service Task. Chúng sử dụng Ngôn ngữ Biểu thức Hợp nhất (JUEL - Java Unified Expression Language).

a) Điều khiển luồng đi với Gateway

Một trong những ứng dụng phổ biến nhất của Expression là để định nghĩa các điều kiện rẽ nhánh sau một Gateway (ví dụ: Exclusive Gateway).

Khi quy trình đến Gateway, Camunda engine sẽ duyệt qua từng biểu thức trên các luồng đi ra. Luồng đầu tiên có biểu thức trả về true sẽ được chọn để đi tiếp.

b) Gọi phương thức trực tiếp trong Service Task

Nếu logic nghiệp vụ của bạn chỉ đơn giản là một lời gọi phương thức, bạn có thể dùng Expression ngay trong Service Task thay vì phải tạo một lớp JavaDelegate riêng.

• Cấu hình:
  1. Chọn Implementation là Expression.
  2. Viết biểu thức gọi đến phương thức của một Spring Bean, ví dụ: ${paymentService.chargeCard(orderId)}.

Trong đó, paymentService là tên của Spring Bean và chargeCard là phương thức bạn muốn gọi. Bạn thậm chí có thể truyền các biến quy trình (orderId) làm tham số.

5. Mở rộng: Liên kết Model với việc Xử lý Lỗi

Để thấy rõ hơn sức mạnh của Properties Panel, hãy xem một ví dụ nâng cao: liên kết một sự kiện trên sơ đồ với việc xử lý lỗi trong mã Java.

Giả sử trong JavaDelegate của bạn, có một trường hợp lỗi nghiệp vụ xảy ra (ví dụ: "khách hàng không đủ tiền"). Bạn có thể ném ra một BPMNError đặc biệt từ code Java:

// Bên trong phương thức execute() của một Java Delegate
if (customer.getBalance() < amount) {
    throw new org.camunda.bpm.engine.delegate.BpmNError("INSUFFICIENT_FUNDS");
}

Bây giờ, làm thế nào để sơ đồ BPMN của bạn "bắt" được lỗi này và chuyển hướng quy trình sang một nhánh xử lý khác (ví dụ: gửi email thông báo cho khách hàng)? Câu trả lời lại nằm trong Properties Panel.

Bạn có thể gắn một Error Boundary Event vào Service Task. Sau đó, trong Properties Panel của sự kiện này, bạn cấu hình:

• Error Code: INSUFFICIENT_FUNDS
• Error Message Variable: errorMessage (tên một biến để lưu thông điệp lỗi)

Chuỗi INSUFFICIENT_FUNDS chính là "sợi dây" liên kết. Khi mã Java ném ra lỗi có mã này, Camunda engine sẽ tìm kiếm trên sơ đồ xem có sự kiện nào đang "lắng nghe" mã lỗi đó không và sẽ kích hoạt nó.

Tổng kết bài học

Hôm nay, bạn đã học được cách sử dụng Properties Panel như một chuyên gia để tạo ra mối liên kết chặt chẽ giữa mô hình BPMN và mã nguồn thực thi. Hãy cùng điểm lại những ý chính:

• Properties Panel là trung tâm chỉ huy để định nghĩa hành vi thực thi của quy trình.
• Java Class: Cách liên kết trực tiếp nhưng kém linh hoạt. Chỉ nên dùng trong các trường hợp đơn giản nhất.
• Delegate Expression: Cách liên kết linh hoạt và mạnh mẽ, tận dụng hệ sinh thái Spring. Đây là phương pháp được khuyến khích cho các dự án Camunda + Spring Boot.
• Expression: Công cụ đa năng để định nghĩa các điều kiện rẽ nhánh trên Sequence Flow và thực thi các logic đơn giản trong Service Task.
• Việc liên kết này không chỉ giới hạn ở Service Task mà còn áp dụng cho Events, Gateways và nhiều thành phần khác để tạo ra các quy trình tự động hóa phức tạp và đáng tin cậy.

Xem trước bài học tiếp theo

Chúng ta đã thiết kế quy trình, thêm các tác vụ, và học cách liên kết chúng với logic nghiệp vụ. Bước tiếp theo một cách tự nhiên là gì? Đó chính là triển khai (deploy) mô hình này lên Camunda engine để nó thực sự "sống".

Trong bài học cuối cùng của module này, bạn sẽ học cách "Deploy một quy trình lên Camunda engine trực tiếp từ Camunda Modeler". Đây là một tính năng tiện lợi giúp bạn nhanh chóng kiểm thử những thay đổi trên mô hình của mình mà không cần phải đóng gói và triển khai lại toàn bộ ứng dụng.