jbpm学习笔记（八） task活动讲解之任务分配，候选，自定义任务分配处理器

   本来是要写end活动的，感觉比较简单，就直接进入task活动。
    Task活动是一个重难点。
    定义：在jbpm中，task活动一般用来处理涉及人机交互的活动。我们可以使用task活动的assignee属性将一个任务分配给指定的用户。

  示例一：熟练一下基本功能
  对应的jpdl如下：

<?xml version="1.0" encoding="UTF-8"?>
<process name="TaskAssignee" xmlns="http://jbpm.org/4.4/jpdl">
	<start>
	<transition to="review"/>
	</start>
    <!-- EL表达式 "#{order.owner}"的值在这里表示分配者ID -->
    <task name="review" assignee="#{order.owner}">
      <transition to="wait" />
    </task>
    <state name="wait" />
</process>

  对应的order代码如下：

package org.test;

import java.io.Serializable;

public class Order implements Serializable{

	private String owner;
	
	public Order(){
	}
	
	public Order(String owner){
		this.owner=owner;
	}

	public String getOwner() {
		return owner;
	}

	public void setOwner(String owner) {
		this.owner = owner;
	}
	
}

注意：假如不实现Serializable的话，会给你报错。

测试代码如下：

package org.test;

import java.util.HashMap;
import java.util.List;
import java.util.Map;

import org.jbpm.api.ProcessInstance;
import org.jbpm.api.task.Task;
import org.jbpm.test.JbpmTestCase;

public class TestTask extends JbpmTestCase {

	String deploymentId;

	@Override
	public void setUp() throws Exception {
		super.setUp();
		deploymentId = repositoryService.createDeployment()
				.addResourceFromClasspath("org/test/task.jpdl.xml").deploy();
		System.out.println("启动成功");
	}

	@Override
	public void tearDown() throws Exception {
		repositoryService.deleteDeploymentCascade(deploymentId);
		super.tearDown();
		System.out.println("销毁成功");
	}

	public void testTask() {
		Map<String, Object> variables = new HashMap<String, Object>();

		// 用户ID为afei
		variables.put("order", new Order("afei"));
		ProcessInstance pi = executionService.startProcessInstanceByKey(
				"TaskAssignee", variables);
		List<Task> taskList=taskService.findPersonalTasks("afei");
		Task task=taskList.get(0);
		System.out.println("task.getActivityName()"+task.getActivityName());

	}

}

  Jbpm支持将任务分配给一组候选用户，组中的一个用户可以接受这个任务并完成它，这就是任务的候选者机制。Task活动的候选者属性有：candidate-groups和candidate-users。


示例二：用户组概念
对应的jpdl如下：

<?xml version="1.0" encoding="UTF-8"?>

<process name="TaskAssignee" xmlns="http://jbpm.org/4.4/jpdl">
	<start>
		<transition to="review" />
	</start>
	<!-- 在这里用字符串应用了一个用户组：sales-dept -->
	<task name="review" candidate-groups="sales-dept">
		<transition to="wait" />
	</task>
	<state name="wait" />
</process>

   流程实例发起后，任务review会被创建。这个任务不会显示在任何人的个人任务列表中，因为还没有创建sales-dept组。因此下面获取的个人任务列表将是空（empty）的：

  taskService.getAssignedTasks(“afei”);
  taskService.getAssignedTasks(“angel”);
 

   但是此任务会显示在sales-dept组成员的分组任务列表，可以通过service Api的taskService.findGroupTasks获取。
接下来，我们就将afei和angel这两个用户创建并加入sales-dept住，这需要使用到IdentiryService服务：

ProcessInstance pi=executionService.startProcessInstanceByKey("TaskAssignee");
		// 首先创建sales-dept组
		String groupName = "sales-dept";
		identityService.createGroup(groupName);

		// 创建用户afei
		identityService.createUser("afei", "afei", "du", "[e-mail]");

		// 将afei加入sales-dept组
		identityService.createMembership("afei", groupName);

		// 创建用户angel
		identityService.createUser("angel", "angel", "peng", "[e-mail]");

		// 将angel加入sales-dept组
		identityService.createMembership("angel", groupName);

		/* 此时，在流程实例发起后，review任务就会出现在用户afei和angel的分组任务列表中，即一下代码的执行结果非空 */
		List<Task> afeiTasks = taskService.findGroupTasks("afei");
		List<Task> angelTasks = taskService.findGroupTasks("angel");
		
		System.out.println(afeiTasks.size());
		
		Task afeiTask = afeiTasks.get(0);

		// afei接受任务操作
		taskService.takeTask(afeiTask.getId(), "afei");
		assertNull(taskService.findGroupTasks("afei"));

   与candidate-groups属性类似的，candidate-users属性可以用来处理逗号分隔的系列用户ID，candidate-users属性可以和其他任务分配属性结合使用。
但是，如果我们需要在分配任务时加入一些复杂的业务逻辑计算呢。显示我们得找出另外的解决方案。“任务分配处理器”是个很不错的选择。
首先，得实现AssignmentHandler接口。

package org.test;

import org.jbpm.api.model.OpenExecution;
import org.jbpm.api.task.Assignable;
import org.jbpm.api.task.AssignmentHandler;

public class AssignTask implements AssignmentHandler {

	private String assignee;

	@Override
	public void assign(Assignable assignable, OpenExecution execution)
			throws Exception {
		assignable.setAssignee(assignee);
		System.out.println("assignee: "+assignee);
	}

}

Jpdl如下：

<?xml version="1.0" encoding="UTF-8"?>

<process name="TaskAssignee" xmlns="http://jbpm.org/4.4/jpdl">
	<start>
		<transition to="review" />
	</start>

	<task name="review">

		<!-- 在这里的类就是实现了AssignmentHandler接口的 -->
		<assignment-handler class="org.test.AssignTask">
			<!-- field元素为任务分配处理器的assignee域注入值。这种注入方式对于jbpm的用户代码都是通用的 -->
			<field name="assignee" >
				<string value="afei" />
			</field>
		</assignment-handler>

		<transition to="wait" />
	</task>
	<state name="wait" />
</process>

Ok，单元测试如下：

Map<String,Object> vals=new HashMap<String, Object>();
		vals.put("order",new Order("afei"));
		ProcessInstance pi = executionService
				.startProcessInstanceByKey("TaskAssignee",vals);

		// afei是通过jpdl定义注入的任务分配者
		List<Task> taskList = taskService.findPersonalTasks("afei");

		// 断言afei有一个任务
		assertEquals(1, taskList.size());

		Task task = taskList.get(0);

		// 断言任务名称如定义的 "review"
		assertEquals("review", task.getName());

		// 断言任务的分配者如预期
		assertEquals("afei", task.getAssignee());

当然   就像你看到的，AssignmentHandler提供的execution对象可以获得流程上下文和变量，可以结合其他任何API来计算出任务的分配者和候选者，单个用户和用户组。比如你可以这样做：
在启动流程实例时候，加一个参数：
  

Map<String,Object> vals=new HashMap<String, Object>();
   vals.put("order",new Order("angel"));

然后在你的任务分配处理器实现类中加入：

Order order=(Order)execution.getVariable("order");
assignable.setAssignee(order.getOwner());

就可以自动控制分配人了。

下一篇继续task活动其他内容！！！