工作流--JBPM核心服务及表结构

一、      使用JBPM开发工作流的一般流程

1.       jBPM的运行需要数据库的支持，因此系统设计时要选定所用数据库。只要是Hibernate支持的数据库，jBPM就支持。数据库的初始化可以由jBPM自动完成，也可以通过ant generate.ddl任务生成SQL语句，在jBPM外部自己创建所需的表。

2.       使用jPdl定义工作流，生成processdinination.xml文件。可以采用GUI工具gpdl，但目前只支持jBPM1.0，而且bug很多。XML的DTD定义文件在jBPM下载包中。

3.       Antcreate.pde生成pde包的工作目录。将processdinination.xml文件和其它需要的文件放在指定的目录下，使用ant build.precess.archives生成pde包。pde包的格式采用jar。

4.       更改pde工作目录/src/config/jbpm.properties的相关属性，主要是设定相关的数据库连接信息。注意要将数据库的JDBC驱动放在pde工作目录的lib目录下。

5.       Antdeploy.process.archives将刚才生成的pde部署到数据库。实际上就是向数据库插入一些相关数据。

6.       利用jBPM API函数开发相应的工作流程。

二、提供的服务

JBPM为了支持相应的开发，提供了一组服务，如下图：

-管理流程定义

-部署流程定义

-删除流程定义

-查询流程定义

public class HelloTest extends TestCase {  

    ProcessEngine processEngine;      

    public setup() {
        processEngine = Configuration.getProcessEngine();
    }  

    public void testDeploy(){
        RepositoryService rs = processEngine.getRepositoryService();  

        //发布流程定义
        String deploymentId=rs.createDeployment().
        addResourceFromClasspath("helloworld.jpdl.xml").deploy();  

        //获得流程定义
        List<ProcessDefinition> list=rs.createProcessDefinitionQuery().list();
        System.out.println("list.size():"+list.size());
        for (ProcessDefinition pd : list) {
            System.out.println("pd.id:"+pd.getId());
        }  

        System.out.println("deploymentId:"+deploymentId);
        //删除流程定义
        rs.deleteDeploymentCascade(deploymentId);
        //删除后查询流程定义
        System.out.println("after del list count:" + rs.createProcessDefinitionQuery().list().size());
    }
}  

-管理流程实例

-发起新流程

-执行等待流程

-查看流程实例

-终止流程实例

-删除流程实例

public class ProcessInstanceTest extends TestCase {  

    ProcessEngine processEngine;  

    public ProcessInstanceTest() {
        processEngine = Configuration.getProcessEngine();
    }
    @Override
    protected void setUp() throws Exception {
        processEngine.getRepositoryService().createDeployment()
        .addResourceFromClasspath("helloworld.jpdl.xml").deploy();
    }  

    /**
     * 流程实例state节点向下执行
     */
    public void testProcessInstance(){
        ExecutionService es= processEngine.getExecutionService();
        //流程实例
        ProcessInstance pi = es.startProcessInstanceByKey("helloworld");
        //state向下执行
        pi= es.signalExecutionById(pi.getId());
        System.out.println("pi.isEnded"+pi.isEnded());
    }  

    /**
     * 终止流程实例
     */
    public void testProcessInstanceEnd(){
        ExecutionService es= processEngine.getExecutionService();
        //流程实例
        ProcessInstance pi = es.startProcessInstanceByKey("helloworld");
        //终止流程实例
        es.endProcessInstance(pi.getId(), "结束流程");
    }  

    /**
     * 删除流程实例
     */
    public void testProcessInstanceDel(){
        ExecutionService es= processEngine.getExecutionService();
        //流程实例
        ProcessInstance pi = es.startProcessInstanceByKey("helloworld");
        //删除流程实例
        es.deleteProcessInstanceCascade(pi.getId());
    }  

    /**
     * 流程实例列表
     */
    public void testProcessInstanceList(){
        ExecutionService es= processEngine.getExecutionService();
        //流程实例
        ProcessInstance pi = null;
        for (int i = 0; i < 10; i++) {
            pi= es.startProcessInstanceByKey("helloworld");
        }
        //查询流程实例列表
        List<ProcessInstance> list= es.createProcessInstanceQuery().list();
        //输出列表数到控制台
        System.out.println("list.size:"+list.size());
    }
}  

三、      JBPM表结构介绍

资源库和运行时表结构

1.       JBPM4_DEPLOYMENT，JBPM4_DEPLOYPROP，JBPM4_LOB存储流程定义相关的部署信息

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

3.       JBPM4_TASK存放需要人来完成的Activities(活动)，需要人来参与完成的Activity 被称为Task

4.       JBPM4_PARTICIPATION参与者表，存放参与者信息，参与者的种类有Candidate、Client、Owner、Replaced Assignee和Viewer。而具体的参与者既可以是单一用户，也可以是用户组

5.       JBPM4_SWIMLANE泳道表。SwimLane是一种Runtime Process Role。通过SwimLane，多个Task可以一次分配到同一Actor身上 JBPM4_JOB  存放的是Timer 的定义 JBPM4_VARIABLE 存的是进行时的临时变量。

历史数据库表结构

1.       JBPM4_HIST_PROCINST流程实例历史表

2.       JBPM4_HIST_ACTINST流程节点(活动)历史表

3.       JBPM4_HIST_DETAIL保存流程实例、活动实例、任务实例运行过程中历史明细数据

4.       JBPM4_HIST_VAR保存历史的流程变量数据

5.       JBPM4_HIST_TASK保存历史的任务实例记录

身份认证表

1.       JBPM4_ID_GROUP用户组表

2.       JBPM_ID_MEMBERSHIP保存用户和用户组之间的关联关系

3.       JBPM4_ID_USER用户表

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

引擎参数表

1.       JBPM4_PROPERTY引擎参数表，记录JBPM的一些引擎参数，会保存一些初始设定的种子数据；例如引擎版本（KEY=db.version） ,ID生成器版本(KEY=next.dbid)、KEY:引擎KEY，比如next.dbid 下次执行的DBID_VERSION:版本号、VALUE:对应的引擎KEY的VALUE；

执行流程后，数据库表变化情况：

发布一个流程deploy后：

jbpm4_deployment新增一条记录

jbpm4_deployprop新增三条记录

jbpm4_lob新增两条记录

开始一个流程startProcessInstanceByKey后：

jbpm4_execution新增一条记录

jbpm4_hist_actinst新增一条记录

jbpm4_hist_procinst新增一条记录

jbpm4_hist_task新增一条记录

jbpm4_task新增一条记录