JBPM4 常用表结构及其说明

首先我想说，这不一篇原创博文。这里设置成原创，主要是为了分享，因为它对于jbpm的初学者，真的值得一看。原作者的博文地址并没有查到，我是在另一位转载此文的博主那儿获得的，地址在这儿。

本文从表结构、操作时表的变化以及jbpm4.4各个包的作用来介绍jbpm的。

第一部分：表结构说明

Jbpm4 共有18张表，如下，其中红色的表为经常使用的表

一：资源库与运行时表结构

1. JBPM4_DEPLOYMENT 流程定义表

2. JBPM4_DEPLOYPROP 流程定义属性表

3. JBPM4_EXECUTION 流程实例表

4. JBPM4_PROPERTY 流程引擎表

5. JBPM4_TASK 任务表

6. JBPM4_VARIABLE 上下文表

7. JBPM4_JOB 定时表

8. JBPM4_LOB 存储表

9. JBPM4_SWIMLANE泳道表

10. JBPM4_PARTICIPATION 参与者表

二： 历史数据表

11. JBPM4_HIST_ACTINST 流程活动(节点)实例表

12. JBPM4_HIST_DETAIL 流程历史详细表

13. JBPM4_HIST_PROCINST 流程实例历史表

14. JBPM4_HIST_TASK 流程任务实例历史表

15. JBPM4_HIST_VAR 流程变量（上下文）历史表

三：身份认证表结构

16. JBPM4_ID_GROUP 组表

17. JBPM4_ID_MEMBERSHIP 用户角色表

18. JBPM4_ID_USER 用户表

这三张表很常见，基本的权限控制，关于用户认证方面建议还是自己开发一套，组件自带的功能太简单，使用中有很多需求难以满足

第二部分:表结构描述

1. JBPM4_DEPLOYMENT 流程定义表

2. JBPM4_DEPLOYPROP 流程定义属性表

3. JBPM4_EXECUTION 流程实例表

主要是存放JBPM4的执行信息，Execution机制代替了JBPM3的Token机制。

4. JBPM4_PROPERTY 流程引擎表

5. JBPM4_TASK 任务表

存放需要人来完成的Activities，需要人来参与完成的Activity 被称为Task

6. JBPM4_VARIABLE 上下文表 存的是进行时的临时变量

7. JBPM4_JOB 定时表 存放的是Timer的定义

8. JBPM4_LOB 存储表

9. JBPM4_SWIMLANE泳道表

Swim Lane是一种Runtime Process Role。通过Swim Lane，多个Task可以一次分配到同一Actor身上。

10. JBPM4_PARTICIPATION 参与者表

存放 Participation的信息，Participation的种类有Candidate、Client、Owner、 Replaced Assignee和Viewer。而具体的Participation既可以是单一用户，也可以是用户组。

二： 历史数据表

11. JBPM4_HIST_ACTINST 流程活动(节点)实例表 存放Activity Instance的历史记录

12. JBPM4_HIST_DETAIL 流程历史详细表 保存Variable的变更记录

13. JBPM4_HIST_PROCINST 流程实例历史表 存放Process Instance的历史信息

14. JBPM4_HIST_TASK 流程任务实例历史表 Task的历史信息。

15. JBPM4_HIST_VAR 流程变量（上下文）历史表 保存历史的变量

第三部分：操作信息变化

注意：以下操作步骤向表中增加记录的顺序（经过测试）

发布一个流程deploy后

Ø jbpm4_deployment(流程定义)：新增一条记录

Ø jbpm4_lob(存储表)： 新增一条记录

Ø jbpm4_deployprop(流程定义属性表)：新增四条记录

上传一个zip包（包含png和jpdl.xml）后

Ø JBPM4_DEPLOYMENT多一条记录

Ø JBPM4_DEPLOYPROP 多三条

Ø JBPM4_LOB多两条。

开始一个流程startProcessInstanceByKey后

Ø jbpm4_execution(流程实例表)：新增一条记录

Ø jbpm4_hist_procinst(流程实例历史表)：新增一条记录

Ø jbpm4_variable (上下表)：新增一条记录

Ø jbpm4_task (任务表)：新增一条记录

Ø jbpm4_hist_task(任务历史表)：新增一条记录

Ø jbpm4_hist_actinst (活动节点实例表)：新增一条记录

填写申请信息

Ø jbpm4_variable(上下表) ： 新增N条记录,根据表单信息决定

Ø jbpm4_task (任务表)：新增一条记录

Ø jbpm4_hist_task(任务历史表)：新增一条记录

Ø jbpm4_hist_actinst (活动节点实例表)：新增一条记录

审批申请信息

1.同意：

Ø jbpm4_hist_actinst (活动节点实例表)：新增一条记录

2.驳回：

Ø jbpm4_task (任务表)：新增一条记录

Ø jbpm4_hist_task(任务历史表)：新增一条记录

Ø jbpm4_hist_actinst (活动节点实例表)：新增一条记录

审批结束
Ø jbpm4_hist_actinst (活动节点实例表)：新增一条记录

第四部分：JBMP4.4包作用

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.pvm.internal.xml
主要用于解析xml的，主要解析jbpm.cfg.xml和流程定义文件
org.jbpm.pvm.internal.util
包含常用工具
org.jbpm.pvm.internal.wire
用来在ioc里进行依赖绑定。子包包含binding, descriptor, operation和xml,而且默认的绑定方式是使用field，而不是常见的setter绑定方式。
org.jbpm.pvm.internal.type
用来进行类型转换，主要是加载jbpm.cfg.xml对流程引擎进行初始化时，还有就是发布流程的时候进行类型转换。子包包括converter，matcher和variable，类型转换器，类型匹配器和变量。
org.jbpm.pvm.internal.tx
其中负责处理事务，JtaTransaction啦，SpringTransationInterceptor 啦，StandardTransaction啦，这些需要根据实际环境具体选择。jta的实现部分已经单独放到子包jta中了。希望spring中的事务也能这样处理就好了。
org.jbpm.pvm.internal.test
包下放了一个JobTestHelper，显然是可以帮助在测试环境下运行job的，。
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泳道。暂时没有发现三者之间与任务的联系

JBPM4 常用表结构

第一部分：表结构说明

Jbpm4 共有18张表，如下，其中红色的表为经常使用的表

一：资源库与运行时表结构

1. JBPM4_DEPLOYMENT 流程定义表

2. JBPM4_DEPLOYPROP 流程定义属性表

3. JBPM4_EXECUTION 流程实例表

4. JBPM4_PROPERTY 流程引擎表

5. JBPM4_TASK 任务表

6. JBPM4_VARIABLE 上下文表

7. JBPM4_JOB 定时表

8. JBPM4_LOB 存储表

9. JBPM4_SWIMLANE泳道表

10. JBPM4_PARTICIPATION 参与者表

二： 历史数据表

11. JBPM4_HIST_ACTINST 流程活动(节点)实例表

12. JBPM4_HIST_DETAIL 流程历史详细表

13. JBPM4_HIST_PROCINST 流程实例历史表

14. JBPM4_HIST_TASK 流程任务实例历史表

15. JBPM4_HIST_VAR 流程变量（上下文）历史表

三：身份认证表结构

16. JBPM4_ID_GROUP 组表

17. JBPM4_ID_MEMBERSHIP 用户角色表

18. JBPM4_ID_USER 用户表

这三张表很常见，基本的权限控制，关于用户认证方面建议还是自己开发一套，组件自带的功能太简单，使用中有很多需求难以满足

第二部分:表结构描述

1. JBPM4_DEPLOYMENT 流程定义表

2. JBPM4_DEPLOYPROP 流程定义属性表

3. JBPM4_EXECUTION 流程实例表

主要是存放JBPM4的执行信息，Execution机制代替了JBPM3的Token机制。

4. JBPM4_PROPERTY 流程引擎表

5. JBPM4_TASK 任务表

存放需要人来完成的Activities，需要人来参与完成的Activity 被称为Task

6. JBPM4_VARIABLE 上下文表 存的是进行时的临时变量

7. JBPM4_JOB 定时表 存放的是Timer的定义

8. JBPM4_LOB 存储表

9. JBPM4_SWIMLANE泳道表

Swim Lane是一种Runtime Process Role。通过Swim Lane，多个Task可以一次分配到同一Actor身上。

10. JBPM4_PARTICIPATION 参与者表

存放 Participation的信息，Participation的种类有Candidate、Client、Owner、 Replaced Assignee和Viewer。而具体的Participation既可以是单一用户，也可以是用户组。

二： 历史数据表

11. JBPM4_HIST_ACTINST 流程活动(节点)实例表 存放Activity Instance的历史记录

12. JBPM4_HIST_DETAIL 流程历史详细表 保存Variable的变更记录

13. JBPM4_HIST_PROCINST 流程实例历史表 存放Process Instance的历史信息

14. JBPM4_HIST_TASK 流程任务实例历史表 Task的历史信息。

15. JBPM4_HIST_VAR 流程变量（上下文）历史表 保存历史的变量

第三部分：操作信息变化

注意：以下操作步骤向表中增加记录的顺序（经过测试）

发布一个流程deploy后

Ø jbpm4_deployment(流程定义)：新增一条记录

Ø jbpm4_lob(存储表)： 新增一条记录

Ø jbpm4_deployprop(流程定义属性表)：新增四条记录

上传一个zip包（包含png和jpdl.xml）后

Ø JBPM4_DEPLOYMENT多一条记录

Ø JBPM4_DEPLOYPROP 多三条

Ø JBPM4_LOB多两条。

开始一个流程startProcessInstanceByKey后

Ø jbpm4_execution(流程实例表)：新增一条记录

Ø jbpm4_hist_procinst(流程实例历史表)：新增一条记录

Ø jbpm4_variable (上下表)：新增一条记录

Ø jbpm4_task (任务表)：新增一条记录

Ø jbpm4_hist_task(任务历史表)：新增一条记录

Ø jbpm4_hist_actinst (活动节点实例表)：新增一条记录

填写申请信息

Ø jbpm4_variable(上下表) ： 新增N条记录,根据表单信息决定

Ø jbpm4_task (任务表)：新增一条记录

Ø jbpm4_hist_task(任务历史表)：新增一条记录

Ø jbpm4_hist_actinst (活动节点实例表)：新增一条记录

审批申请信息

1.同意：

Ø jbpm4_hist_actinst (活动节点实例表)：新增一条记录

2.驳回：

Ø jbpm4_task (任务表)：新增一条记录

Ø jbpm4_hist_task(任务历史表)：新增一条记录

Ø jbpm4_hist_actinst (活动节点实例表)：新增一条记录

审批结束
Ø jbpm4_hist_actinst (活动节点实例表)：新增一条记录
jbpm4.4最核心的包
1.antlr.jar
2.commons-collections.jar
3.commons-logging.jar
4.dom4j.jar
5.hibernate-core.jar
6.javassist.jar
7.jbpm.jar
8.jta.jar
9.mail.jar
10.slf4j-api.jar
11.slf4j-jdk14.jar
12.slf4j-log4j12.jar
配置文件
jbpm.execution.hbm.xml, jbpm.history.hbm.xml, jbpm.identity.hbm.xml, jbpm.repository.hbm.xml, jbpm.task.hbm.xml五个hibernate映射文件
jbpm.default.cfg.xml ----> 流程引擎的默认配置文件
jbpm.identity.cfg.xml ----> 身份验证配置文件
jbpm.jbossremote.cfg.xml ----> 远程调用jboss实现命令模式
jbpm.jobexecutor.cfg.xml ----> 任务执行器的配置
jbpm.task.lifecycle.xml ----> 任务生命周期,包括启动，暂停，继续，完成，取消之类
jbpm.tx.hibernate.cfg.xml----> 默认的hibernate事务配置
jbpm.tx.jta.cfg.xml ----> jta的事务配置
jbpm.variable.types.xml ----> 配置变量类型映射
jbpm.wire.bindings.xml ----> 依赖绑定映射
jbpm4.4包作用
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.pvm.internal.xml
主要用于解析xml的，主要解析jbpm.cfg.xml和流程定义文件
org.jbpm.pvm.internal.util
包含常用工具
org.jbpm.pvm.internal.wire
用来在ioc里进行依赖绑定。子包包含binding, descriptor, operation和xml,而且默认的绑定方式是使用field，而不是常见的setter绑定方式。
org.jbpm.pvm.internal.type
用来进行类型转换，主要是加载jbpm.cfg.xml对流程引擎进行初始化时，还有就是发布流程的时候进行类型转换。子包包括converter，matcher和variable，类型转换器，类型匹配器和变量。
org.jbpm.pvm.internal.tx
其中负责处理事务，JtaTransaction啦，SpringTransationInterceptor 啦，StandardTransaction啦，这些需要根据实际环境具体选择。jta的实现部分已经单独放到子包jta中了。希望spring中的事务也能这样处理就好了。
org.jbpm.pvm.internal.test
包下放了一个JobTestHelper，显然是可以帮助在测试环境下运行job的，。
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泳道。暂时没有发现三者之间与任务的联系

版权声明：本文为博主原创文章，未经博主允许不得转载。