JBPM4.4学习API

一、流程引擎API 
org.jbpm.api.ProcessEngine是jbpm4所有的Service API 之源。 
既所有的Service API（服务接口）都从ProcessEngine中获取。 
ProcessEngine由配置文件获取

ProcessEngine processEngine = Configuration.getProcessEngine();  

并且是线程安全的，可以保存在静态变量中。所有的线程和请求都可以使用同一个ProcessEngine对象。 
二、其余API 
1.那么在看看其他6个api是如何获取的：

RepositoryService  repositoryService = processEngine.getRepositoryService();
ExecutionService executionService = processEngine.getExecutionService();
TaskService taskService = processEngine.getTaskService();
HistoryService historyService = processEngine.getHistoryService();
ManagementService managementService = processEngine.getManagementService();
IdentityService identityService = processEngine.getIdentityService();

2.RepositoryService  了解 
流程资源服务接口，提供对流程定义的部署，查询，删除等操作。 
我的通俗理解：流程资源服务接口就是提供流程定义接口。 
真的不喜欢官方文档的专业‘文字游戏’术语 
如：

/***
 * test deploy
 */
public void testDeploy(){
    RepositoryService repository = processEngine.getRepositoryService();
    //发布流程定义
    String deploymentId = repository.createDeployment().addResourceFromClasspath("helloword.jpdl.xml").deploy();  

    //查看流程定义
    List<ProcessDefinition> list = repository.createProcessDefinitionQuery().list();
    for(ProcessDefinition pd:list){
        System.out.println(pd.getId());
    }
    //删除流程定义
    repository.deleteDeploymentCascade(deploymentId);
    System.out.println(repository.createProcessDefinitionQuery().list().size());
}  

3.ExecutionService了解 
流程执行服务接口，提供启动流程实例，执行推进，设置流程变量等操作 
我的通俗理解：流程执行服务接口就是提供操作流程实例接口。 
启动流程实例根据ID

String id = request.getParameter("id");
ExecutionService executionService = processEngine
            .getExecutionService();
ProcessInstance processInstance = executionService
            .findProcessInstanceById(id);  

设置流程变量操作:

Map map = new HashMap();
    map.put("owner", session.getAttribute("username"));
    executionService.startProcessInstanceById(request
            .getParameter("id"), map);  

查看流程实例：

List<ProcessInstance> piList = executionService.createProcessInstanceQuery().list();  

4.TaskService 了解 
人工任务服务接口。提供对任务的创建，提交，查询，保存，删除等操作 
使用TaskService 对已经启动的流程查看任务列表（个人）

TaskService taskService = processEngine.getTaskService();
String username = (String) session.getAttribute("username");
List<Task> taskList = taskService.findPersonalTasks(username);  

使用TaskService完成任务

ProcessEngine processEngine = Configuration.getProcessEngine();
      TaskService taskService = processEngine.getTaskService();
Map map = new HashMap();
map.put("day", day);
map.put("reason", reason);
taskService.completeTask(taskId, map);  

说明：

//根据指定的任务ID完成任务。
taskService.completeTask(taskId)
//根据指定的任务ID,同时设定变量来完成任务。
taskService.completeTask(taskId, map)
//指定outcome,下一步转移路径，完成任务。
taskService.completeTask(taskId,outcome)
//指定outcome,下一步转移路径，,同时设定变量来完成任务。
taskService.completeTask(taskId, out,map)  

API允许设置变量,这里可以是MAP或者其他变量，这些在任务完成前将作为流程变量同步到流程实例中， 
可以根据TaskId，和在MAP设置的KEY获取变量

eg:

taskService.getVariable(taskId, "owner")  

5.HistoryService 了解 
流程历史服务的借口，提供对流程历史库（已完成 的流程实例归档）中历史流程，历史活动实例等记录的查询操作

6.ManagementService 了解 
流程管理控制服务接口

7.IdentityService 了解 
身份认证服务接口，提供对流程用户，用户组，成员关系的服务。

本文转自：http://jc-dreaming.iteye.com/blog/904016