jbpm4.4学习总结（三）常用接口使用说明

在jbpm4.4开发过程中，我们需要使用其提供的接口来完成任务，为什么我们要心甘情愿的被jbpm绑架呢？主要是因为它简单呗……

1.AssignmentHandler

AssignmentHandler是jbpm为我们提供的一个绑定用户，分配任务的接口，我们可以通过实现这个接口来指定Task 的执行者，必须配合jpdl.xml下的标签和程序来使用，web环境下一般都是session中的用户。

举个例子：

一个员工提交一个请假申请，如果我们给这个Task添加一个AssignmentHandler，把员工的姓名绑定进去，那么jbpm就会知道，这个流程是这个员工创建的……

 按正常逻辑请假单已经提交到了领导那，我们可以通过再实现一个AssignmentHandler接口，通过AssignmentHandler动态的对流程实例定义Actor，将领导设置成task的执行者。这样做的好处就是灵活……

当领导登录时，session中是领导的姓名，领导查自己的任务列表就会看到那份员工提交的请假单了。

• jpdl.xml的一部分（主要是<assignment-handler > 和<decision >两个标签）

   <task assignee="${name}" g="235,146,92,52" name="LeaveApplication">
      <assignment-handler class="com.mtf.jbpm.handler.NewApplicationAssignmentHandler"/> //创建请假单前绑定用户，员工
      <transition g="-113,-17" name="SubmitApply" to="ManagerApprove"/>
   task>
   <task assignee="${name}" g="244,235,92,52" name="ManagerApprove">
    <assignment-handler class="com.mtf.jbpm.handler.ManagerApproveAssignmentHandler"/>//当请假单流转到manager那时触发，领导
      <transition g="-46,-23" name="ManagerApproved" to="DaysCheck"/>
      <transition g="-15,-35" name="ManagerDisApproved" to="end"/>
   task>
    <decision g="67,240,48,48" name="DaysCheck">
   <handler class="com.mtf.jbpm.handler.DaysCheckHandler" />   //分支流程
      <transition g="-20,-2" name="LessThan3Days" to="HrMakeSure"/>
      <transition g="-49,-11" name="MoreThan3Days" to="ExecutiveApprove"/>
   decision>

• 申请请假单的AssignmentHandler

public class NewApplicationAssignmentHandler implements AssignmentHandler{

    @Override
    public void assign(Assignable assignable, OpenExecution execution)
            throws Exception {
        System.out.println("pxj 创建一leave");
        String name =(String) execution.getVariable("name");
        System.out.println(name);
        assignable.setAssignee(name);
    }
}

• 领导的AssignmentHandler

public class ManagerApproveAssignmentHandler implements AssignmentHandler{

    @Override
    public void assign(Assignable assignable, OpenExecution execution)
            throws Exception {
        System.out.println("经理 开始审批");
        String id = (String) execution.getVariable("parentId");
        int managerId = Integer.parseInt(id);
        EmployeeDao employeeDao = new EmployeeDaoImpl();
        Employee  e= employeeDao.findEmployeeById(managerId);
        assignable.setAssignee(e.getE_name_cn());
    }
}

其中parentId是请假单提交的时候设定的，解释一下：员工提交请假单当然是提交到自己领导那了，于是我在提交请假单的方法中查找了一下自己领导的id，存在这个parentId中，到这里面在寻找这个人的姓名（领导的名字）通过assignable.setAssignee(e.getE_name_cn());  将这个Task的执行者设置成领导……于是乎当领导查自己的任务列表时，就能查到自己下属提交的请假单了

• 这个方法就是提交请假单的方法，应该写在前面才对，思路有些混乱……

/**
 * submitApplication 2012-7-9
 */
@Override
public void submitApplication(String actorId, float days,
        ProcessInstance pi, int id) {
    String taskId = processEngine.getTaskService().createTaskQuery()
            .processInstanceId(pi.getId()).uniqueResult().getId();
    // 绑定流程
    // 寻找上级
    LeaveDao dao = new LeaveDaoImpl();
    Leaves leaves = null;
    try {
        List all = dao.queryParentById(id, 1);
        for (int i = 0; i < all.size(); i++) {
            leaves = all.get(i);
        }
    } catch (Exception e) {
    }
    System.out.println("TaskId" + taskId);
    Task tasks = processEngine.getTaskService().getTask(taskId);
    String executionId = tasks.getExecutionId();
    processEngine.getExecutionService().setVariable(executionId,
            "parentId",new String(leaves.getL_emp_id()+""));
    processEngine.getExecutionService().setVariable(executionId, "days",
            days);
    processEngine.getTaskService().completeTask(taskId);
}

主要接收：流程实例id，创建人姓名，请假人id，本次总结我只想把jbpm的接口总结一下，关于流程的部分请看下部分。

• 实际上任务的分配方式有很多种

任务的分类与分配方式
        任务的分类：
            个人任务
                方式一：指定assignee属性
                    可以指定为具体的某个String（具体某人）；
                    也可以指定一个流程变量，会使用计算出的结果（结果要是String型）表示办理人。
                方式二：
                    AssignmentHandler中
                    assignable.setAssignee(userId);
                方式三：
                    processEngine.getTaskService().assignTask(taskId, userId);
            组任务
                方式一：指定candidate-users属性
                    可以指定为具体的String（多个人之间用英文的逗号隔开）；
                    也可以指定一个流程变量，会使用计算出的结果（结果要是String型，多个人之间用英文的逗号隔开）表示候选人。
                方式二：
                    AssignmentHandler中
                    assignable.addCandidateUser(userId); // 添加一个组成员（候选人）
                方式三：
                    processEngine.getTaskService().addTaskParticipatingUser(taskId, userId, Participation.CANDIDATE);

到这里，有关AssignmentHandler的问题都差不多了

2.DecisionHandler

DecisionHandler接口的作用就是根据你给传入的条件进行判断，然后返回一条让你往下继续执行的线，就跟做决定一样。

public class DaysCheckHandler implements DecisionHandler {

    @Override
    public String decide(OpenExecution execution) {
        //加入判断天数的逻辑
        String days =execution.getProcessInstance().getVariable("days").toString();
        float day = Float.parseFloat(days);
        if(day>3){
            return "MoreThan3Days";
        }else{
            return "LessThan3Days";
        }
    }
}

获取前面流过来的"days" 然后返回那条线的名字就OK，XML配置见上文，so easy

这两个接口还是比较常用的，我用的方式是比较简单的，但是jbpm比我们想象的灵活多了，尤其是AssignmentHandler，可以加上权限等等，一个实现服务多个用户我觉得应该也是能实现的，唉~~设计模式没学好，晚上继续看！！！