一个流程定义式对过程的步骤的描述。 比如，一个保险公司可以有一个 贷款 流程定义 描述公司如何处理贷款请求 的步骤的描述。

流程实例代表着流程定义的特殊执行例子， 例如：上周五John Doe提出贷款买船， 代表着一个贷款流程定义的流程实例。

一个流程实例包括了所有运行阶段， 其中最典型的属性就是跟踪当前节点的指针。

假设汇款和存档可以同时执行， 那么主流程实例就包含了2个 用来跟踪状态的子节点：

一般情况下，一个流程实例是一个执行树的根节点， 当一个新的流程实例启动时，实际上流程实例就处于根节点的位置， 这时只有它的"子节点"才可以被激活。

使用树状结构的原因在于， 这一概念只有一条执行路径， 使用起来更简单。 业务API不需要了解流程实例和执行之间功能的区别。 因此， API里只有一个执行类型来引用流程实例和执行。

在jBPM内部通过各种服务相互作用。 服务接口可以从 ProcessEngine 中获得， 它是从 Configuration 构建的。

流程引擎是线程安全的，它可以保存在静态变量中， 甚至JNDI中或者其他重要位置。 在应用中，所有线程和请求都可以使用同一个流程引擎对象， 现在就告诉你怎么获得流程引擎。

这章中涉及到的代码和下一章中关于流程部署的代码， 都来自 org.jbpm.examples.services.ServicesTest 例子。

ProcessEngine processEngine = new Configuration()      .buildProcessEngine();

上面的代码演示了如何通过classpath根目录下 默认的配置文件jbpm.cfg.xml创建一个ProcessService。 如果你要指定其他位置的配置文件， 请使用setResource()方法：

ProcessEngine processEngine = new Configuration()      .setResource("my-own-configuration-file.xml")      .buildProcessEngine();

还有其他setXxxx()方法可以获得配置内容， 例如：从InputStream中、 从xml字符串中、从InputSource中、 从URL中或者从文件（File）中。

我们可以根据流程引擎得到 下面的服务：

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

在配置中定义的这些流程引擎（ProcessEngine）对象， 也可以根据类型processEngine.get(Class<T>) 或者根据名字processEngine.get(String)来获得。

RepositoryService 包含了用来管理发布资源的所有方法。 在第一个例子中，我们会使用 RepositoryService 从classpath中部署一个流程资源。

String deploymentid = repositoryService.createDeployment()    .addResourceFromClasspath("org/jbpm/examples/services/Order.jpdl.xml")    .deploy();

通过上面的 addResourceFromClass 方法， 流程定义XML的内容可以从文件， 网址，字符串，输入流或zip输入流中获得。

每次部署都包含了一系列资源。每个资源的内容都是一个字节数组。 jPDL流程文件都是以 .jpdl.xml 作为扩展名的。 其他资源是任务表单和java类。

部署时要用到一系列资源， 默认会获得多种流程定义和其他的归档类型。 jPDL发布器会自动识别后缀名是 .jpdl.xml 的流程文件。

在部署过程中，会把一个 id 分配给流程定义。 这个 id 的格式为 {key}-{version} ， key和version之间使用连字符连接。

如果没有提供key， 会在名字的基础自动生成。 生成的key会把所有不是字母和数字的字符替换成下划线。

同一个名称只能关联到一个key， 反之亦然。

如果没有为流程文件提供版本号， jBPM会自动为它分配一个版本号。 请特别注意那些已经部署了的名字 相同的流程文件的版本号。 它会比已经部署的同一个key的流程定义 里最大的版本号还大。 没有部署相同key的流程定义的版本号会分配为1。

在下面第1个例子里，我们只提供了流程的名字，没有提供其他信息：

<process name="Insurance claim">...</process>

假设这个流程是第一次部署， 下面就是它的属性：

第2个例子我们将演示如何通过设置流程的key 来获得更短的id。

<process name="Insurance claim" key="ICL">...</process>

这个流程定义的属性就会像下面这样：

删除一个流程定义会把它从数据库中删除。

repositoryService.deleteDeployment(deploymentId);

如果在发布中的流程定义还存在活动的流程实例， 这个方法就会抛出异常。

如果希望级联删除一个发布中流程定义的 所有流程实例， 可以使用 deleteDeploymentCascade 。

当使用一个 state 活动时，执行（或流程实例） 会在到达state的时候进行等待，直到一个signal（也叫外部触发器）出现。 signalExecution 方法可以被用作这种情况。 执行通过一个执行id（字符串）来引用。

在一些情况下，到达state的执行会是流程实例本身。 但是这不是一直会出现的情况。在定时器和同步的情况， 流程是执行树形的根节点。所以我们必须确认你的signal 作用在正确的流程路径上。

获得正确的执行的比较好的方法是给state活动分配一个事件监听器， 像这样：

<state name="wait">  <on event="start">    <event-listener class="org.jbpm.examples.StartExternalWork" />  </on>  ...</state>

在事件监听器 StartExternalWork 中，你可以执行那些需要额外完成的部分。 在这个时间监听器里，你也可以通过 execution.getId() 获得确切的流程id。 那个流程id，在额外的工作完成后， 你会需要它来提供给signal操作的：

executionService.signalExecutionById(executionId);

这里有一个可选的（不是太推荐的）方式，来获得流程id， 当流程到达 state 活动的时候。 只可能通过这种方式获得执行id，如果你知道哪个jBPM API调用了之后， 流程会进入 state 活动：

// assume that we know that after the next call// the process instance will arrive in state external workProcessInstance processInstance =  executionService.startProcessInstanceById(processDefinitionId);// or ProcessInstance processInstance =//  executionService.signalProcessInstanceById(executionId);Execution execution = processInstance.findActiveExecutionIn("external work");String executionId = execution.getId();

TaskService的主要目的是提供对任务列表的访问途径。 例子代码会展示出如何为id为 johndoe 的用户获得任务列表

List<Task> taskList = taskService.findPersonalTasks("johndoe");

一般来说，任务会对应一个表单，然后显示在一些用户接口中。 表单需要可以读写与任务相关的数据。

long taskId = task.getId();Set<String> variableNames = taskService.getVariableNames(taskId);variables = taskService.getVariables(taskId, variableNames);variables = new HashMap<String, Object>();variables.put("category", "small");variables.put("lires", 923874893);taskService.setVariables(taskId, variables);

taskSerice也用来完成任务。

taskService.completeTask(taskId);taskService.completeTask(taskId, variables);taskService.completeTask(taskId, outcome);taskService.completeTask(taskId, outcome, variables);

这些API允许提供一个变量map，它在任务完成之前作为流程变量添加到流程里。 它也可能提供一个“外出outcome”，这会用来决定哪个外出转移会被选中。 逻辑如下所示：

如果一个任务拥有一个没用名称的外向转移：

如果一个任务拥有一个有名字的外向转移：

如果一个任务拥有多个外向转移，其中一个转移没有名称，其他转移都有名称：

如果一个任务拥有多个外向转移，每个转移都拥有唯一的名字：

任务可以拥有一批候选人。候选人可以是用户也可以是用户组。 用户可以接收自己是候选人的任务。 接收任务的意思是用户会被设置为被分配给任务的人。 在那之后，其他用户就不能接收这个任务了。

人们不应该在任务做工作， 除非他们被分配到这个任务上。 用户界面应该显示表单，并允许用户完成任务， 如果他们被分配到这个任务上。对于有了候选人，但是还没有分配的任务， 唯一应该暴露的操作就是“接收任务”。

更多的任务见 第 6.2.6 节 “ task ” 。

在流程实例执行的过程中，会不断触发事件。 从那些事件中，运行和完成流程的历史信息会被收集到历史表中。 HistoryService 提供了 对那些信息的访问功能。

如果想查找某一特定流程定义的所有流程实例， 可以像这样操作：

List<HistoryProcessInstance> historyProcessInstances = historyService  .createHistoryProcessInstanceQuery()  .processDefinitionId("ICL-1")  .orderAsc(HistoryProcessInstanceQuery.PROPERTY_STARTTIME)  .list();

单独的活动流程也可以作为 HistoryActivityInstance 保存到历史信息中。

List<HistoryActivityInstance> histActInsts = historyService    .createHistoryActivityInstanceQuery()    .processDefinitionId("ICL-1")    .activityName("a")    .list();

也可以使用简易方法 avgDurationPerActivity 和 choiceDistribution 。 可以通过javadocs获得这些方法的更多信息。

管理服务通常用来管理job。可以通过javadocs获得这些方法的更多信息。 这个功能也是通过控制台暴露出来。

从jBPM 4.0开始，一个新的API被介绍使用查询系统， 可以覆盖大多数你可以想到的查询。开发者需要编写企业特定查询时 当然也可以使用Hibenrate。但是对大多数用例来说， 查询API是不足够的。 查询可以写成同ideas方式，用于主要的jBPM概念： 流程实例，任务，发布，历史流程，等等。

比如：

List<ProcessInstance> results = executionService.createProcessInstanceQuery()                                       .processDefinitionId("my_process_definition")                                       .notSuspended()                                       .page(0, 50)                                       .list();    

这个例子返回指定流程定义的所有流程实例， 流程定义不是暂停的。结果支持分页，第一页的前50条数据 会被我们获得。

查询任务也可以使用相同的方式完成：

List<Task> myTasks = taskService.createTaskQuery()    .processInstanceId(piId)    .assignee("John")    .page(100, 120)    .orderDesc(TaskQuery.PROPERTY_DUEDATE)    .list();

这个查询会获得指定流程实例，分配给John的所有任务，也使用分页，对duedate进行逆序查询。

每个服务拥有操作这些统一查询的功能（比如，查询job通过 ManagementService ，查询完成的 流程实例通过 HistoryService 。 可以参考服务的javadoc了解这些查询API的所有细节。）