JBPM 4.3 java 源代码包详解

最近项目中用JBoss开源jBPM4.3流程引擎实现了几个流程。使用上感觉比jBPM3更简单，但是对PVM流程虚拟机如何工作的一头雾水，今天开始终于有时间可以看看PVM的源码，但是对个包机构不熟悉，因此参考了http://www.family168.com/jbpm4/pvm.html的简介很详细。粘贴过来以便学习之用。以下是PVM各包的作用：

流程虚拟机，我们对它的期望是它可以为所有流程提供一套通用平台，之后无论我们是需要对原有流程语言进行扩展，或者重新实现一套自定义的流程语言，都可以很简单的使用pvm实现了。现在我们要来看看pvm到底有没有这个本领实现我们的期望。

实际上，jBoss已经在PVM的基础上完成jPDL, BPEL和基于Seam的PageFlow三个实现，对于我们来说最常见的就是jPDL了，它是jBPM-4中默认使用的流程语言的实现。

java源代码分包详解

org.jbpm.pvm.internal.ant提供使用ant发布流程，辅助启动jboss的任务。

org.jbpm.pvm.internal.builder用来构造各种模型，包括活动，活动行为，事件，事件处理器，流程定义，变量，任务，等等。

org.jbpm.pvm.internal.cal提供日历，包括日期，时间段，持续时间，节假日。

org.jbpm.pvm.internal.cfg中的JbpmConfiguration和SpringConfiguration实现了org.jbpm.api.Configuration，用来从配置文件构造ProcessEngine。

org.jbpm.api.client这部分包含ClientExecution, ClientProcessDefinition, ClientProcessInstance。ClientExecution继承了OpenExecution，声明了end(), signal(), suspend(), resume()之类的方法。ClientProcessDefintion继承了OpenProcessDefintion，其中的功能主要是createProcessInstance和startProcessInstance。

org.jbpm.pvm.internal.cmd包含Command和CommandService，这是命令设计模式的基础。其中放着所有的命令，所有的流程操作都可以在这里找到。

org.jbpm.pvm.internal.email下面有两个子包impl和spi，只要注意spi下的AddressResolver, MailProducer和MailSession就可以实现自定义的实现了。

org.jbpm.pvm.internal.env包含Context, Environment, EnvironmentFactory, Transaction, WireObject。其中Context, Environment和EnvironmentFactory组成了jBPM4里的IoC系统。Transaction定义了通用事务。WireObject用来做依赖绑定。下面保存着环境有关的实现类。包括Authentication权限认证，Environment与context相关的各个类。

org.jbpm.pvm.internal.hibernate下面的类是专门与hibernate进行交互的类，包含类型转换，命名策略和最主要的DbSessionImpl，所有与数据库的操作都来源于此。

org.jbpm.pvm.internal.history下面是历史操作所需要的部分，其下还包含events和model包。

org.jbpm.pvm.internal.identity包主要负责身份认证的操作。包含三个子包cmd, impl和spi，cmd下定义所用到的命令，impl下是实现类，spi下放着IdentitySession。

org.jbpm.pvm.internal.jms包括JmsMessageSession和JmsMessageUtil，应该是用来处理jms的，JmsMessageSession与org.jbpm.api.job.Message相关联。说明job下的Message是依靠jms发送异步消息的。

org.jbpm.pvm.internal.job中提供了对job, message和timer的实现

org.jbpm.pvm.internal.jobexecutor提供了任务执行器，包括JobExecutorServlet和对应的线程池，以及一系列的命令和处理器。无论是job, message或是timer，最终都会被这里执行。

org.jbpm.pvm.internal.lob主要用来处理流程发布时的文件内容，需要把jpdl.xml文件和图片，甚至是以后可能把class文件都以附件形式保存到数据库中，以备后用。

org.jbpm.pvm.internal.model这个模型包中包含了很多很多类，包括Activity, CompositeElement, Condition, ObservableElement, OpenProcessDefinitionTransition。简单分类一下。最底层的是ObservableElement，它是可以被事件监听的元素，并且可以继承，CompositeElement继承了 ObservableElement，它里面可以装填多个活动。再加上Event中定义了多个事件，这些就构成了最基本的事件模型。Activity和ActivityCoordinates分别定义了活动类和活动位置。以这些为基础，OpenProcessDefinition继承了ProcessDefinition和CompositeElement。最终，我们还有一个Condition类，它只有一个evaluate方法，接受OpenExecution作为参数返回boolean值，Condition和Activity组合成了Transition，这个转移包含了起点，终点，以及条件判断。最庞大的模型部分，活动，转移，流程定义，流程实例的实现类都放在这里。在它的op子包中包含的是流程进行中的各项操作。

org.jbpm.pvm.internal.query中放的是History, Job, ProcessDefintion, ProcessInstance这四个query类的实现，还提供了一个Page类，但是其中只有firstResult和maxResults，所以没啥大用。

org.jbpm.pvm.internal.repository负责的是流程的发布，主要有Deployment和Repository对应的service, session和cache，这里使用的缓存，所以每次使用流程定义的时候可以利用缓存提高效率。

org.jbpm.pvm.internal.script包含对脚本的支持，默认支持了JuelScriptEngine。

org.jbpm.pvm.internal.session中支持各种会话，DbSession, MessageSession, RepositorySession和TimerSession。

org.jbpm.pvm.internal.spring这里只有一个CommandTransactionCallback用来实现从spring中获得事务，并用其执行jbpm中定义的各种命令。

org.jbpm.pvm.internal.stream用于从各种途径读取资源，无论是jbpm配置文件和流程资源都要通过这些来转换成流的形式，以供给jbpm处理。

org.jbpm.pvm.internal.svc其中svc或许是service的缩写。这个包中除了包括org.jbpm.api包下定义的所有service接口的实现，还包括commandService的实现和认证拦截器。

org.jbpm.pvm.internal.task这里代表了所有与任务，任务参与者相关的信息，包括Assignable, AssignmentHandler, OpenTask, Participation, Swimlane, Task, TaskDefinition。简单划分后，主要有任务，任务定义任务处理。剩下的都是与任务分配有关了。TaskDefinition从字面上来看是指任务定义，里边只有一个getName()。Task中保存了任务相关的一些内容，OpenTask主要用来处理历史事件。参与者部分基本分成三个部分，以Assignable和AssignmentHandler组成的自定义分配部分，Participation参与者和swimlane泳道。暂时没有发现三者之间与任务的联系。

org.jbpm.pvm.internal.test包下放了一个JobTestHelper，显然是可以帮助在测试环境下运行job的，个人认为它放在pvm中似乎有点儿不妥。

org.jbpm.pvm.internal.tx其中负责处理事务，JtaTransaction啦，SpringTransationInterceptor啦，StandardTransaction啦，这些需要根据实际环境具体选择。jta的实现部分已经单独放到子包jta中了。希望spring中的事务也能这样处理就好了。

org.jbpm.pvm.internal.type用来进行类型转换，主要是加载jbpm.cfg.xml对流程引擎进行初始化时，还有就是发布流程的时候进行类型转换。子包包括converter，matcher和variable，类型转换器，类型匹配器和变量。

org.jbpm.pvm.internal.util包含常用工具。

org.jbpm.pvm.internal.wire用来在ioc里进行依赖绑定。子包包含binding, descriptor, operation和xml，个人认为这是很麻烦的绑定方式，而且默认的绑定方式是使用field，而不是常见的setter绑定方式。

org.jbpm.pvm.internal.xml包主要用于解析xml的，主要解析jbpm.cfg.xml和流程定义文件。

配置文件

jbpm配置jbpm.default.cfg.xml，流程引擎的默认配置文件。jbpm.identity.cfg.xml, jbpm.jboss.idm.cfg.xml身份验证配置文件。jbpm.jbossremote.cfg.xml远程调用jboss实现命令模式。jbpm.jobexecutor.cfg.xml任务执行器的配置。

hibernate映射jbpm.execution.hbm.xml, jbpm.history.hbm.xml, jbpm.identity.hbm.xml, jbpm.repository.hbm.xml, jbpm.task.hbm.xml这五个是hibernate映射文件。

任务生命周期jbpm.task.lifecycle.xml任务的生命周期，包括启动，暂停，继续，完成，取消之类。

事务配置jbpm.tx.hibernate.cfg.xml默认的hibernate事务配置。jbpm.tx.jta.cfg.xml使用jta的事务配置。

IoC配置jbpm.variable.types.xml变量类型映射。jbpm.wire.bindings.xml依赖绑定映射。