jBPM開發入門指南(3)

 

5 　安裝 jBPM 的 Eclipse 開發插件

有個輔助工具開發起來方便一點，只不過現在 jBPM 的開發工具插件功能還不算太強，也就一個“項目創建嚮導”的功能，讓你：

（1）不用再去配置 classpath 庫的引用了

（2）直接得到了一個 jBPM 的項目初始結構

其實吧，開發 jBPM 也不需要什麼插件工具，在熟練了以後，庫引用了項目初始結構都可以手工創建。

 

插件不用再去下載了， jbpm-starters-kit-3.1.1 包裏就有，目錄地址如下： D:\jbpm-starters-kit-3.1.1\jbpm-designer\jbpm-gpd-feature\eclipse ，插件的安裝方式是鏈接式還是直接複製式，任選吧。不懂的就去看看《 Eclipse 從入門精通》這本書，在前面章節都有講到。另外，註明一下 Eclipse 的版本我是用 3.2 ，插件和 Eclispe 版本相關的，要注意了。

 

如果安裝成功，則 Eclipse 首選項裏多了一個 JBoss jBPM ，另外我們也需要到這個 jBPM 的首選項裏做一些配置工作――指定 jBPM 的安裝路徑（如下圖所示）。這個配置主要是爲了找到 jbpm 下的各種 jar 包，好讓 Eclipse 設置項目的庫引用。本文指向路徑是 d:\jbpm-starters-kit-3.1.1\jbpm.3

 

 

 

6 　 jBPM 的 Hello World

6.1 　新建jBPM 項目

主菜單“文件－＞新建－＞項目”，在彈出的對話框裏，有“ Process Project ”項，如下圖所示：

 

 

選上好，單擊“下一步”，起個名“ myjbpm ”，然後就可以單擊“完成”了。然後就生成了如下圖所示的一個項目結構：
 

這個項目和通常 Eclipse 的項目結構有點不同，不過這是一個現在非常流行的項目結構， src/java 存放源文件， test/java 存放相應的 JUnit 單元測試代碼。如果你用 Maven 來編譯構建項目，對這種目錄結構一定不陌生。

 

項目創建起了，介紹一下里面的文件吧：

l           MessageActionHandler ，自動生成的一個 ActionHandler 。不想要可以刪掉。

l           ehcache.xml  cache 的配置文件，裏面有很詳解的英文說明。沒有必要可以不用改它。

l           hibernate.cfg.xml 　 jBPM 是用 Hibernate 進行工作流的數據存儲的，這個就是 Hibernate 的配置文件。後面我們將講到如何配置這個文件。

l           jbpm.cfg.xml 　 jbpm 本身的配置文件。現在是空的，它用的是缺省配置，你想知道有哪些配置就去看這個文件 D:\jbpm-starters-kit-3.1.1\jbpm.3\src\java.jbpm\org\jbpm\default.jbpm.cfg.xml

l           log4j.properties 　這個是日誌 API 包 log4j 的配置文件，用過 log4j 的都知道。

l           SimpleProcessTest.java 　這個是對最重要的流程配置文件的 processdefinition.xml 單元測試代碼。這裏表揚一點， jBPM 的優良設計使得它的可測試性非常之高，喜歡寫 t 單元測試的人有福了。

l           gpd.xml 　用於生成流程圖的定義文件。都是一些方框的座標和長寬

l           processdefinition.xml 　這個是對最重要的流程配置文件，以後寫流程要經常和它打交道。

l           processimage.jpg 　一個流程圖

 

從項目結構來看，我們沒有看到 JSP 網頁程序，也沒有看到 GUI 客戶端程序，這些代碼都是要我們以後開發中來寫的。但本文不準備用 JSP 、 GUI （ Swing 、 SWT ）來做示例，而是用 JUnit 代碼來做使用 jBPM 客戶端來演示。因爲 jBPM 實際上是一個後臺框架，至於前臺是 JSP 還是 Swing 還是無界面的 java.class 都是無關緊要的。在教程裏用無界面的 java.class 來做客戶端則更方便一些，如果進一步採用 JUnit ，則這樣的 java.class 同時還具備了單元測試的功能。以後就是用 JSP 寫了 WEB 頁面，我們還是可以用這些 JUnit 程序來做單元測試，避免了頻繁的鼠標點按 WEB 頁面這樣的力氣活。所以在 jBPM 自帶的英文教程裏都是一個 JUnit 程序，不仔佃看還真摸不着頭腦。

 

6.2 　修改hibernate.cfg.xml

       hibernate.cfg.xml 的默認設置是用 HSQL ，這是一個內存數據庫，這種內存數據庫用來代替項目實際所用的數據庫來做單元測試挺不錯的。不過我們這裏是要試試用 MySQL 、 Oracle ，那就改一下設置吧。

注：配置值可參考 D:\jbpm-starters-kit-3.1.1\jbpm-db 對應子目錄下的 hibernate.properties 文件。

1 、 MySQL 的更改如下：

<property name="hibernate.dialect">org.hibernate.dialect.MySQLDialect</property>

<property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property>

<property name="hibernate.connection.url">jdbc:mysql://localhost:3306/jbpm</property>

<property name="hibernate.connection.username">root</property>

<property name="hibernate.connection.password">123456</property>

 

2 、 Oracle 的更改如下：

<property name="hibernate.dialect">org.hibernate.dialect.OracleDialect</property>

<property name="hibernate.connection.driver_class">oracle.jdbc.driver.OracleDriver</property>

<property name="hibernate.connection.url">jdbc:oracle:thin:@192.168.123.10:1521:wxxrDB</property>

<property name="hibernate.connection.username">chengang</property>

<property name="hibernate.connection.password">chengang</property>

 

如果你裝了 Oracle 的客戶端，並且 D:\oracle\ora92\network\ADMIN\tnsnames.ora 裏做了如下的設置

WXXRDB_192.168.123.10 =

  (DESCRIPTION =

    (ADDRESS_LIST =

      (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.123.10)(PORT = 1521))

    )

    (CONNECT_DATA =

      (SID = wxxrDB)

      (SERVER = DEDICATED)

    )

  )

則 Oracle 的 hibernate.connection.url 項也可以設爲： jdbc:oracle:oci:@WXXRDB_192.168.123.10

 

6.3 　完善庫引用

       雖然 jBPM 在創建項目之初給我們設置好了庫引用，如下圖

 

 

但後面運行時還是報一些 NoClassDefFoundError 異常，如沒有對 hibernate3.jar 的引用導致下面的錯誤

java.lang.NoClassDefFoundError: org/hibernate/Session

    at org.jbpm.persistence.db.DbPersistenceServiceFactory.openService(DbPersistenceServiceFactory.java:55)

    at org.jbpm.svc.Services.getService(Services.java:136)

    .......

 

所以我們要爲本文的實例完善庫引用。主要是把 MySQL 和 Oracle 的 JDBC 庫、以及 Hibernate 的 hibernate3.jar 加入到項目的庫引用中。

（1）       找到缺少的 jar 包

l           mysql 的 jdbc 包，在 D:\jbpm-starters-kit-3.1.1\jbpm-db\mysql\lib 目錄裏

l           oracle 的 jdbc 包， jbmp 中沒有包含（可能是沒拿到 oracle 授權），我們可以自已去 oracle 網站上下載，或者去 oracle 安裝目錄 D:\oracle\ora92\jdbc\lib 找 ojdbc14.jar （我們公司用的是 Oracle9i ）

l           Hibernate3.jar 在目錄 D:\jbpm-starters-kit-3.1.1\jbpm.3\lib\hibernate 裏。

（2）       在項目裏創建一個 lib 目錄，將這三個 jar 複製到 lib 目錄。

（3）       如下圖設置三 jar 包的庫引用

 

 

 

6.4 　開始HellorWorld

這裏是一個很簡單的請假流程，請假人提交假單給經理審批，經理審批後結束。要說明的是，這個流程並不嚴謹，比如經理不通過流程應該到哪？不過這並不防礙拿它來做示例，螃蟹還得一個一個的吃。我們先拿這一杆子捅到底的流程做一個最簡單的示例，從整體上對 jBPM 工作流開發有概念先。然後我們再慢慢豐富。

 

1 、定義流程

流程的定義文件是 processdefinition.xml ，這個是一個關鍵文件， jBPM 的很大一部份內容都是關於它的。在這裏我們把原來自動生成的內容，稍做改動：

<?xml version = "1.0" encoding = "GBK" ?>

 

<process-definition xmlns = "urn:jbpm.org:jpdl-3.1" name = "helloworld" >

    <!-- 申請 -->

    <start-state name = "request" >

        <task >

            <controller >

                <variable name ="name" />

                <variable name ="day" />

                <variable name ="note" />

            </controller >

        </task >

        <!-- 流程轉向 -->

        <transition name ="to_confirm" to ="confirm" >

            <action name ="requestAction"

                class = "cn.com.chengang.jbpm.RequestAction">

                <reason > 我要請假 </reason >

            </action >

        </transition >

    </start-state >

    <!-- 審批 -->

    <state name = "confirm" >

        <transition name ="to_end" to ="end" >

            <action name ="finishAction"

                class = "cn.com.chengang.jbpm.ConfirmAction" />

        </transition >

    </state >

    <!-- 結束 -->

    <end-state name = "end" />

</process-definition>

說明：

流程的名稱改成了 helloworld 。（呵呵，也就是這裏和 helloworld 有關了）

<controller> 標籤定義了三個數據：姓名、請假天數、說明。

<transition> 標籤定了 request 節點的一個流程轉向，這裏是轉到 confirm 節點。

<action> 標籤定義了流程由一個節點轉到另一個節點時，所要執行的動作，動作封裝在一個 ActionHandler 類中。比如這裏當 request 到 confirm 結點時將執行 RequestAction 類的 execute 方法。

FinishAction 下面還有一個 <reason> （請假理由），它對應於 FinshAction 的屬性 String reason 。

 

2 、　編寫 ActionHandler

       在上面 processdefinition.xml 裏我們定義了兩個 ActionHandler ： RequestAction 、 ConfirmAction 。其代碼如下：

package cn.com.chengang.jbpm;

 

import org.jbpm.graph.def.ActionHandler;

import org.jbpm.graph.exe.ExecutionContext;

 

public class RequestAction implements ActionHandler {

 

    private static final long serialVersionUID = 1L;

 

    private String reason ;

 

    public String getReason () {

        return reason ;

    }

 

    public void setReason(String reason) {

        this .reason = reason;

    }

 

    public void execute(ExecutionContext context) throws Exception {

        context.getContextInstance().setVariable("note" , reason );

    }

 

}

 

說明： ExecutionContext 是一個貫通流程的容器。它是個大寶箱，裏面啥玩意都有，後面將更深入的提到。這裏的 reasion 就是 processdefinition.xml 中的 ” 我要請假 ”

 

 

package cn.com.chengang.jbpm;

 

import org.jbpm.graph.def.ActionHandler;

import org.jbpm.graph.exe.ExecutionContext;

 

public class ConfirmAction implements ActionHandler {

 

    private static final long serialVersionUID = 1L;

 

    public void execute(ExecutionContext context) throws Exception {

        context.getContextInstance().setVariable("note" , " 准假 " );

    }

 

}

 

OK ，後臺的程序就算寫完了（前臺客戶端的程序還沒寫），下面開始部署。

 

 

下接  :  jBPM開發入門指南(3) 續