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