jBPM handlers code examples

Actions are a mechanism to bind your custom java code into a jBPM process. Actions can be associated with its own nodes (if they are relevant in the graphical representation of the process). Or actions can be placed on events like e.g. taking a transition, leaving a node or entering a node. In that case, the actions are not part of the graphical representation, but they are executed when execution fires the events in a runtime process execution.

ActionHandler example

    <state name="GetFromStock">
        <event type="node-enter">
            <action class="com.sample.action.GetFromStockActionHandler"
        <transition name="checkAvailability" to="CheckAvailability"></transition>


package com.sample.action;

import org.jbpm.graph.def.ActionHandler;
import org.jbpm.graph.exe.ExecutionContext;

public class GetFromStockActionHandler implements ActionHandler {

    public void execute(ExecutionContext context) throws Exception {
        System.out.println("Getting goods from factory!");

        setVariable("goodsInStock", new Integer(300));



AssignmentHandler example

An assignment handler implementation is called when a task instance is created. At that time, the task instance can be assigned to one or more actors.

<task-node name="In Carico">
        <task name="InizioLavorazione">
        <assignment class="it.wind.mobile.process.handler.LavorazioneAssignmentHandler" />
        <transition to="In Lavorazione" name="to In Lavorazione"></transition>


public class LavorazioneAssignmentHandler implements AssignmentHandler {
    private final static Logger logger = LoggerFactory.getLogger( MobileProcessManagerImpl.class );
    public void assign(Assignable assignable, ExecutionContext executionContext)
            throws Exception {
        Node task = executionContext.getToken().getNode();
        String actor = (String) executionContext.getVariable("actor");
        logger.info(task.getName()+" assigned to "+actor);


DecisionHandler example

jBPM decision nodes are very useful to create some alternative path along the process.
You can implement the decision condition either in the jPDL file:

    <decision name="WO Accettato">
            <transition to="In Carico">
             <condition>#{workorderAccepted == 0}</condition>
            <transition to="Chiusa" name="to Chiusa">
            <condition>#{workorderAccepted == 1}</condition>

Or you can leave the path decision to an handler which implements org.jbpm.graph.node.DecisionHandler

<decision name="Someone approved?">
   <handler class="com.sample.DecisionSample">
     <leaveReject>applicant rejected</leaveReject>
     <leaveOk>applicant approved</leaveOk>
   <transition name="applicant approved" to="HP approve"></transition>
   <transition name="applicant rejected" to="rejected"></transition>
 public  class DecisionSample implements org.jbpm.graph.node.DecisionHandler {
   //will be set with the name of the transition to go if user rejects
   private String leaveReject;
   //will be set with the name of the transition to go if user approves
   private String leaveOk;
   public String decide(ExecutionContext executionContext) throws Exception {
     log.debug(logPrefix +"DecisionOnEnd: leaveReject: "+ leaveReject);
     log.debug(logPrefix +"DecisionOnEnd: leaveOk:     "+ leaveOk);
     //which way to go, as default we reject
      String exitTransition = leaveReject;
     try {
       //fetch input data from the processInstance variables (see WorkManagerBean for more info)    
       String varName="inputdataActivity";
       ContextInstance contextInstance = executionContext.getContextInstance();
       Activity myActivity = (Activity) contextInstance.getVariable(varName);
       if(myActivity != null) {
         log.debug(logPrefix +"DecisionOnEnd: Reading processInstance variable to determine if approved or not. \""+ varName
                   + "\", value="+ myActivity.bApproved);          
         //if approved we go to the transition defined in leaveOk
             exitTransition = leaveOk;
         log.error(logPrefix +"DecisionOnEnd: there data regarding if the task was approved or rejected is null! (i.e. "+ varName
                   + "=null). The task is rejected since we have to do something");
     } catch (Exception e) {
       log.error(logPrefix +"DecisionOnEnd: Catched exception when trying to read variable, " +
               "the task is rejected since we have to do something  e="+e);
     log.debug(logPrefix +"DecisionOnEnd: Attempt to leave on the transition: " + exitTransition );
     return exitTransition;

Related articles available on mastertheboss.com

JBPM tutorial

JBoss jBPM 3 is a flexible, extensible framework for process lang

How do I fire an action every time a JBPM Node enters?

JBoss recipe of the day

JBoss Jbpm superstates

What is a superstate ? a Superstate is a group of nodes. Supersta

Jbpm Mail delivery

Almost every workflow needs a notification of the process activit

How do you embed Java code in your JPDL ?

  You can use a BeanShell expression to add a Java script in you

JBPM best practices

There's no perfect rule to model your workflow, it depends on the

Follow us on Twitter