JBPM 工作流引擎 JBPM指南 例子：数据库 (3.2)

声明：

本人E文VeryVeryPoor，又是刚刚开始学习JBPM工作流引擎，对原文及概念等理解不当的地方，请网友不吝赐教，吾将及时修改和更正。

本文仅是本人自己学习JBPM，对JBPM指南的学习理解过程。

还望可以对入门者有所帮助。共享之。

需要中英文对照Word文档者请联系：[e-mail]或留下邮件地址。

3.2. 例子：数据库

jBPM的基本特征之一是当业务处理处在一个等待的状态时，支持业务的数据库持久化执行能力。下面的例子将为你展示如何将业务实例存储进jBPM数据库中。这个例子也提出了可能产生哪些上下文环境。几段不同的用户代码是单独被创建的方法。例子：在webapplication中每段用户代码启动一个业务和数据库持久化的执行。然后，一个消息驱动bean(message driven bean)从数据库装载业务实例并重新启动执行。

More about the jBPM persistence can be found in Chapter 6, Persistence.

更多关于jBPM持久化可以在jBPM的文档Chapter 6, Persistence中了解.

public class HelloWorldDbTest extends TestCase {

/*

我们需要申请一个JbpmSessionFactory，因此我们把它放到一个静态变量中

（static variable），这个JbpmSessionFactory将被使用在创建的test方法中(test methods)。

*/

  static JbpmSessionFactory jbpmSessionFactory = 

      JbpmSessionFactory.buildJbpmSessionFactory();

  static {

/*

自the hypersonic in-memory database以来是一个新的数据库，在我们

启动测试前，我们需要创建运行时的计划，下面一行创建了一个数据库

表和外键约束关系。

*/

    jbpmSessionFactory.getJbpmSchema().createSchema();

  }

  public void testSimplePersistence() {

/*

在下面的3个方法调用之间，所有数据是通过数据库传递。这里，在单元

测试中，因为我们想测试一个完成的业务情节，这3个方法彼此被正确的

执行。但事实上，这些方法代表了对服务器的不同请求。

当我们启动一个干净的，空的内存数据库时，我们首先部署业务。事实上，

这些被业务开发人员做过一次了。

*/

    deployProcessDefinition();

/*

推想我们想要启动一个业务实例，

process instance (=process execution)，

当用户在一个web application 中提交一个form时……

*/

    processInstanceIsCreatedWhenUserSubmitsWebappForm();

/*

然后，一个异步消息到达时，将会继续执行。

*/

    theProcessInstanceContinuesWhenAnAsyncMessageIsReceived();

  }

  public void deployProcessDefinition() {

/*

这个测试展示了一个业务定义和业务定义的执行。业务定义有3个节点：

an unnamed start-state, a state 's' and an end-state named 'end'.

*/

    ProcessDefinition processDefinition = ProcessDefinition.parseXmlString(

      "<process-definition name='hello world'> +

      "  <start-state name='start'> +

      "    <transition to='s' /> +

      "  </start-state> +

      "  <state name='s'> +

      "    <transition to='end' /> +

      "  </state> +

      "  <end-state name='end' /> +

      "</process-definition>

    );

//我们打开一个新的持久化session

    JbpmSession jbpmSession = jbpmSessionFactory.openJbpmSession();

//然后开始一个在持久session上的事务。

    jbpmSession.beginTransaction();

//把业务定义保存到数据库里

    jbpmSession

        .getGraphSession()

        .saveProcessDefinition(processDefinition);

    //提交事务

    jbpmSession.commitTransaction();

//关闭session.

    jbpmSession.close();

  }

  public void processInstanceIsCreatedWhenUserSubmitsWebappForm() {

/*

在这个方法中的代码可以被放到struts-action 

     or a JSF managed bean.中

    */

//我们打开一个新的持久化session

    JbpmSession jbpmSession = jbpmSessionFactory.openJbpmSession();

//然后开始一个在持久session上的事务。

    jbpmSession.beginTransaction();

/*

现在对我们在上面部署的业务定义进行数据库查询。

*/

    ProcessDefinition processDefinition = 

        jbpmSession

          .getGraphSession()

          .findLatestProcessDefinition("hello world");

/*

随着我们从数据库提取的业务定义，我们能创建一个业务定义的执行，

就像hello world example，(它没有持久化)。

*/

    ProcessInstance processInstance = 

        new ProcessInstance(processDefinition);

    Token token = processInstance.getRootToken(); 

    assertEquals("start", token.getNode().getName());

//启动业务执行

    token.signal();

//现在业务处在状态’s’中 。

    assertEquals("s", token.getNode().getName());

/*

现在这业务实例被保存到数据库里。因此当前业务执行的状态被存储到

数据库里。

*/

    jbpmSession

        .getGraphSession()

        .saveProcessInstance(processInstance);

/*

下面的方法将得到从数据库收回的业务实例，然后通过在另外的扩展信号

条件下，重新启动执行。

*/

//在webapp action的结尾，事务被提交。

    jbpmSession.commitTransaction();

//关闭事务。

    jbpmSession.close();

  }

  public void theProcessInstanceContinuesWhenAnAsyncMessageIsReceived() {

//在方法中的这段代码是在消息驱动中的内容。

//我们打开一个新的持久化session

    JbpmSession jbpmSession = jbpmSessionFactory.openJbpmSession();

/*

 然后在持久化session上开始事务，注意，它也可能使用

在你的应用服务器上的a jdbc connection 。

*/

    jbpmSession.beginTransaction();

    GraphSession graphSession = jbpmSession.getGraphSession();

/*

首先，我们需要得到从数据库收回的业务实例。要知道我们在这处理的

业务实例有几个选项。在这个简单的测试案例中正在寻找这个完整

的业务实例列表。那将给我们唯一的结果。因此我们可以查询业务定义。

*/

    ProcessDefinition processDefinition = 

        graphSession.findLatestProcessDefinition("hello world");

现在，我们搜索所有业务定义的业务实例。

    List processInstances = 

        graphSession.findProcessInstances(processDefinition.getId());

我们知道在单元测试内容中只有一个业务执行。在实际生命周期中，业

务实例能够从到达的消息内容中或来自用户的选择中提取。

    ProcessInstance processInstance = 

        (ProcessInstance) processInstances.get(0);

/*

现在我们能继续执行。注意，业务实例代表了signals执行的主要(path)

执行路线(path)或叫（轨迹）(=the root token)

*/

    processInstance.signal();

/*

在这个signal，我们知道业务执行将到达end-state.

*/

    assertTrue(processInstance.hasEnded());

//现在我们能更新在数据库中的执行状态。

    graphSession.saveProcessInstance(processInstance);

//在MDB的结尾，事务被提交.

    jbpmSession.commitTransaction();

//关闭事务jbpmSession.

    jbpmSession.close();

  }

}

 

待续….