JBPM表达业务流程（流程定义语言）

业务流程包括三部分:

1. 活动 Activity / 节点 Node （有很多种，不同的类型有不同的功能,必须要有一个Start Activity）
2. 连线 Transition / 转移 （从一个Activity指向另一个Activity）
3. 事件 Event

Transition

开始活动中有且只能有一个连线,并且一个流程实例启动后,会在开始活动之后的一个活动处停下,所以只能有一个开始活动和连线.结束活动不能有连线.其它的活动可以一个或多个连线.当有一个或多个连线的时候,必须使用指定的连线名称离开当前活动,不指定连线名称默认为null,最多只能有一个名称为null的连线名称.相应的语法为:

TaskService.completeTask(taskId, outcome);

指定的连线的名称一定要和流程图上的连线名称相同,包括空格.如果没有找到相应的连线,则会抛出异常。

jBPM4.4中有很多地方都要用到连线名称,其API中也有很多种叫法,比如outcome、signalName、transionName  都是表示Transition的名称.variables、parameters都是表示流程变量的集合Map。

Activity

活动分为两种:预定义活动和自定义活动. 预定义活动就是可以可以直接使用的活动.比如Start,End等.

下面就对几种常见的预定义活动进行说明:

开始活动/Start

表示流程的开始,一个流程图中有且只能有一个Start.而且Start必须要有且只能有一个Transition.不能有其他的Transition指向Start,流程实例启动后,会离开开始活动。

结束活动/End

代表流程的结束,一个流程图中可以有0个或多个End.比如:

如果没有End,则执行完没有Transition的活动后,流程就结束了。

如果有多个End,则执行到其中任意一个End,流程就结束了。

任务活动/Task

代表在这里需要有一个人来做事情,事情做完后流程才能继续向后执行。

指定任务办理人时,可以使用assignee属性来指定。

生成任务时,默认只有这个指定的人才能看到任务和办理这个任务。

判断活动/Decision

使用Decision时要指定一个DecisionHandler的实现类来处理.比如有这么一个流程实例:

如果不大于2000,则部门经理直接办理,超过2000就要找总经理.要进行这个逻辑判断就要使用Decision,建立一个类实现DecisionHandler接口:

@SuppressWarnings("serial")
public class DecisionHandlerImpl implements DecisionHandler {

    // 进行计算，得出并返回应使用的连线的名称
    @Override
    public String decide(OpenExecution execution) {
        int money = (Integer) execution.getVariable("报销金额");
        System.out.println("DecisionHandlerImpl.decide() ---> 报销金额=" + money);

        if (money > 2000) {
            return "to 总经理审批";
        } else {
            return "to end1";
        }
    }

}

我们说了流程变量的生命周期与流程实例的生命周期相同,金额由流程变量带过去.处理器类在Decision的Handler Class属性中指定。

分支/聚合 Fork/Join

Fork与Join要成对地使用.从一个Fork中分出的多个分支一定要再回到同一个Join中去.当流程执行到Fork中时,ProcessInstance会分成多个并行执行的子Execution,因为ProcessInstance继承自Execution,并且是个标记接口,所以说ProcessInstance只是一个概念,它是想表示整个Execution的执行,也就是主线的执行。

public interface ProcessInstance extends Execution {
}

跑题了，回来继续.当流程执行到Fork时，会分成多个并行执行的子Execution,当所有的分支都执行完到达Join的时候,流程才会继续向Join后执行:

上面这个流程实例就是指:当部门经理和总经理都同意的情况下,不管是谁先同意,就继续执行。

状态活动/State

状态活动可以这样理解:如果说Task是等待人来办理的话,那么State就是等待计算机来办理.因为State除了有一个Name的属性外,没有其他的属性了,而且流程执行到State这里会停住,直到你告诉它要继续的时候它才会往后执行.你唯一可以做的就是给它一个"信号".假设有这样一个流程实例:

有两个State,在流程实例启动的时候会遇到State1,然后停住,等待"信号",在上面的时候说过.outcome、signalName、transionName 都是表示Transition的名称.但是与其他活动的行为不同,其他的活动,比如Task,在没有找到相应的Transition时,会抛异常,而State则什么也不做:

// 让流程向后执行一步
@Test
public void singal() {
    // 让指定的Execution离开当前所在的节点，继续向后执行
    String executionId = "test.380007";

    // 当只有一条Transition时，会使用这个Transition离开当前活动
    // 如果有多条Transition，但没有指定要用哪一个，则不会离开节点，也不报错。
    // processEngine.getExecutionService().signalExecutionById(executionId);

    // 当有多条Transition时，必须要指下要使用的Transition的名称。
    processEngine.getExecutionService().signalExecutionById(executionId, "to state2");
}

上面预定义活动中可以做的任何事情,都可以通过自定义活动来完成。

自定义活动只有两个属性,一个Name,一个Class的全路径名,给它的类要实现ExternalActivityBehaviour接口,假设我要在这个活动中发送邮件,可以这样做:

@SuppressWarnings("serial")
public class ExternalActivityBehaviourImpl implements ExternalActivityBehaviour {

    // 当流程执到当前活动时要做的事。
    @Override
    public void execute(ActivityExecution execution) throws Exception {
        // 通过流程变量获取要通知的人和要通知的信息
        String subject = (String) execution.getVariable("subject");
        String[] users = (String[]) execution.getVariable("users");

        // 模拟进行通知
        for (String user : users) {
            System.out.println(user + "，今天下午5点有个会议，会议主题为：" + subject + "。");
        }

        //  执行完后不要离开，等到调用singal方法时才离开。
        // execution.waitForSignal();

        //  使用指定名称的连线离开当前活动。
        // execution.take(transitionName);

        //  使用默认的（配置中的第1个）Transition离开当前活动。
        execution.takeDefaultTransition();

        // 如果以上的方法都没有调用，默认是执行完后离开当前活动。
    }

    // 在外部明确的调用signal方法真正离开当前活动之前要做的事
    @Override
    public void signal(ActivityExecution execution, String signalName, Map parameters) throws Exception {
        System.out.println("---> ExternalActivityBehaviourImpl.signal()");
    }
}

我们只需要在随意覆写execute()方法,就能做自己想做的事情.里面需要用到的数据还是要通过流程变量带过去。

Task的分配方式

方式一:

Task可以通过assignee属性设置办理人,是具体的某人,也可以指定一个流程变量,会使用计算出的结果(结果要是String类型)表示办理人.

方式二:

利用建立一个类实现AssignmentHandler接口,比如:

@SuppressWarnings("serial")
public class AssignmentHandlerImpl implements AssignmentHandler {

    @Override
    public void assign(Assignable assignable, OpenExecution execution) throws Exception {
        // 计算出任务的办理人（可能是获取流程变量，也可能是查询数据库，也可以是其他）
        // execution.getVariable(key);
        String userId = "赵六";

        // 指定任务的办理人
        assignable.setAssignee(userId);

        System.out.println("----> AssignmentHandlerImpl.assign()");
    }

}

把最后的结果(String类型)用setAssignee()方法设置办理人.这需要先在xml文件中加上assignment-handler标签,写上全类路径名:

<task name="task1" g="86,175,92,52">
    <assignment-handler class="cn.zhangao.AssignmentHandlerImpl">assignment-handler>
    <transition name="to end1" to="end1" g="-47,-17" />
task>

方式三:

直接在程序中指定,userId的类型为字符串:

processEngine.getTaskService().assignTask(taskId, userId);

这三种方式都只能分配给个人,下面三种方式可能分配给组:

方式一:

指定candidate-users属性,可以指定为具体的String(多个人之间用英文的逗号隔开),也可以指定一个流程变量,会使用计算出的结果(要是String类型,多个人之间用逗号隔开)表示候选人.

方式二:

实现AssignmentHandler接口,用assignable.addCandidateUser(userId)方法添加一个组成员（候选人）

方式三:

程序中指定:

processEngine.getTaskService().addTaskParticipatingUser(taskId, userId, Participation.CANDIDATE);

注意,组任务必须要查询组的任务列表才能看到:

// 查询某人的组任务列表（以组的名义去查询）
@Test
public void findGroupTasks() {
    // String userId = "张3";
    String userId = "王5";

    // 查询
    // List list = processEngine.getTaskService().findGroupTasks(userId);
    List list = processEngine.getTaskService()//
            .createTaskQuery()//
            .candidate(userId)//
            .list();

    // 显示
    System.out.println("=========== [" + userId + "]的组任务列表 ==========");
    for (Task t : list) {
        System.out.println("id=" + t.getId()//
                + ", name=" + t.getName()// 任务的名称
                + ", assignee=" + t.getAssignee()// 任务的办理人
                + ", createTime=" + t.getCreateTime() // 任务的创建时间
                + ", executionId=" + t.getExecutionId()); // 任务所属的Execution的id
    }
}

在个人里面是看不到的,找到自己的组任务后,可以通过"拾取"任务把任务变为个人任务,这样自己就能办理了:

// 拾取任务
@Test
public void takeTask() {
    String taskId = "450008";
    String userId = "王5";

    processEngine.getTaskService().takeTask(taskId, userId);
}

变为个人任务后,在组任务查询中就查不到了.

事件/Event

事件只能自己手动在xml文件中添加.

1. 在根元素中，或在节点元素中，使用元素指定事件，其中event属性代表事件的类型。
2. 在中用子元素，指定处理的类，要求指定的类要实现EventListener接口

事件类型：

• 元素放在根元素（）中，可以指定event为start或end，表示流程的开始与结束。
• 元素放在节点元素中，可以指定event为start或end，表示节点的进入与离开
• 在Start节点中只有end事件，在End节点中只有start事件。
• 在元素中直接写，就是配置事件。（因为在这里只有一个事件，所以不用写on与类型）
• 在元素中还可以配置assign事件，是在分配任务时触发的。

本文转自：http://blog.csdn.net/zhangao0086/article/details/6327406