jboss規則引擎KIE Drools 6.3.0 Final 教程(1)
前言
目前世面上中文的KIE DROOLS Workbench(JBOSS BRMS)的教程幾乎沒有,有的也只有靈靈碎碎的使用機器來翻譯的(翻的不知所雲)或者是基於老版本的JBOSS Guvnor即5.x的一些教程,而且這些教程都是”缺胳膊少腿“的,初學者看後不知道它到底在干嗎?能干嗎?能夠解決自己系統中什麼問題。
所以筆者自己寫了幾個例子,把整個最新的英文版的KIE DROOLS 6.3.0.Final的官方教程給串了起來,用於供讀者使用並以此來作為入門以及相關SOA理念的推廣的第一步。
本教程共分為”三“集。
什麼是規則引擎
規則是讓業務人士驅動整個企業過程的最佳實踐
業務規則在實現上的矛盾
業務規則技術
引入業務規則技術的目的
對系統的使用人員
把業務策略(規則)的創建、修改和維護的權利交給業務經理提高業務靈活性加強業務處理的透明度,業務規則可以被管理減少對IT人員的依賴程度避免將來升級的風險
對IT開發人員
簡化系統架構,優化應用提高系統的可維護性和維護成本方便系統的整合減少編寫“硬代碼”業務規則的成本和風險
何為規則引擎
可以將一個或多個的事實映射到一個或多個規則上接受數據輸入,解釋業務規則,並根據業務規則做出業務決策
一個簡單的例子
從IT技術人員的角度看為什麼使用規則引擎?
從應用邏輯和數據中將業務邏輯分離簡單! -規則有一個非常簡單的結構讓業務用戶開發和維護規則以降低成本聲明式編程性能和可伸縮性解決復雜的和復合的問題,其中有大量細粒度的規則和事實互動
DEMO-人壽新卓越變額萬能壽險投保規則
DEMO-人壽新卓越變額萬能壽險投保規則的IT實現
免體檢累積最高限額表在規則引擎中的實現:
什麼叫BRMS
什麼是BRMS-考慮兩個問題(IT管理者角度)
什麼是BRMS-考慮兩個問題(開發人員易用性角度)
BRMS-Business Rules Management System
一個優秀的BRMS應該具有的特點
BRMS中兩個重要的概念:因子、公式
從業務的角度看因子與公式間的關系
從IT的角度看因子與公式間的關系
基於BRMS的系統邏輯架構
這個邏輯圖有點復雜,很多人看了都會感覺“不知所雲”,OK,不急!我們在後文中會來“回溯”它。
JBOSS Drools & Guvnor
世面上成熟的規則引擎有很多,著名的如:IBM 的iLog,pegga rulz(飛馬),我們在這邊要介紹的也是開源中最著名的jboss rulz。
Jboss Rulz最早是只有基於.drools的規則文件的一個內嵌式規則引擎,後來它發展成了“規則管理系統”即BRMS,它的BRMS被稱為Guvnor。後來在JBOSS Guvnor5.x後它又改名叫"KIE Drools WorkBench“。
目前世面上中文的KIE DROOLS Workbench(JBOSS BRMS)的教程幾乎沒有,有的也只有靈靈碎碎的使用機器來翻譯的(翻的不知所雲)或者是基於老板的JBOSS Guvnor即5.x的一些教程,而且這些教程都是”缺胳膊少腿“的,初學者看後不知道它到底在干嗎?能干嗎?能夠解決自己系統中什麼問題。
所以筆者自己寫了幾個例子,把整個最新的英文版的KIE DROOLS 6.3.0.Final給串了起來,用於供讀者使用並以此來作為入門SOA理念的推廣的第一步。
Guvnor核心功能-最好的開源規則引擎
KIE Drools6.3.0.Final的安裝與使用
准備安裝文件與環境-環境
CentOS 6mysql5.5.x or aboveapache-tomcat-7.0.67.zip(Tomcat7.0.4 or above)
這些環境,讀者應該自己會安裝了。
准備安裝文件與環境-必須軟件
kie-drools-wb-6.3.0.Final-tomcat7.wardrools-distribution-6.3.0.Final.zip給Tomcat7的lib目錄下用的jar文件,其中包括:
jboss-jacc-api_1.4_spec-1.0.3.Final.jar
kie-tomcat-integration-6.3.0.Final.jar
slf4j-log4j12-1.7.7.jar
log4j-core-2.1.jar
log4j-api-2.1.jar
log4j-slf4j-impl-2.1.jar
slf4j-api-1.7.7.jar
javax.security.jacc-api-1.5-javadoc.jar
btm-2.1.4.jar
btm-tomcat55-lifecycle-2.1.4.jar
jta-1.1.jar
數據庫驅動(mysql-connector-java-5.1.38.jar)
開始安裝
1. 把下列文件全部copy至tomcat的lib目錄下
2. 打開eclipse後按照Help->install new software輸入以下地址
http://download.jboss.org/drools/release/6.3.0.Final/org.drools.updatesite/
3. 把drools-distribution-6.3.0.Final.zip解壓在當前目錄
4. 把kie-drools-wb-6.3.0.Final-tomcat7.war解壓在當前目錄
並改名成kie-drools後拷貝入tomcat的webapps目錄下。
5. 修改D:\tomcat7\webapps\kie-drools\WEB-INF\classes\META-INF目錄下的persistence.xml文件
把該項目原來使用的
H2Dialect改成
MySQL5Dialect
6. 在tomcat的conf目錄下增加一個文件名為:btm-config.properties的文件
使內容如下:
bitronix.tm.serverId=tomcat-btm-node0
bitronix.tm.journal.disk.logPart1Filename=${btm.root}/work/btm1.tlog
bitronix.tm.journal.disk.logPart2Filename=${btm.root}/work/btm2.tlog
bitronix.tm.resource.configuration=${btm.root}/conf/resources.properties
7. 在tomcat的conf目錄下增加一個文件名為:btm-config.properties的文件
resource.ds1.className=bitronix.tm.resource.jdbc.lrc.LrcXADataSource
resource.ds1.uniqueName=jdbc/jbpm
resource.ds1.minPoolSize=10
resource.ds1.maxPoolSize=20
resource.ds1.driverProperties.driverClassName=com.mysql.jdbc.Driver
resource.ds1.driverProperties.url=jdbc:mysql://192.168.0.101:3306/drools?useUnicode=true&characterEncoding=UTF-8
resource.ds1.driverProperties.user=kie
resource.ds1.driverProperties.password=aaaaaa
resource.ds1.allowLocalTransactions=true
8. 在tomcat的conf目錄下修改context.xml
增加如下內容:
[html] view plain copy
- <Resource name="jdbc/jbpm" auth="Container" type="javax.sql.DataSource"
- driverClassName="com.mysql.jdbc.Driver"
- url="jdbc:mysql://192.168.0.101:3306/drools?useUnicode=true&characterEncoding=UTF-8"
- username="kie"
- password="aaaaaa"
- maxActive="20"
- maxIdle="1"
- maxWait="5000" />
9. 在tomcat的conf目錄下修改server.xml
增加如下內容:
記得一定要在上部加入
10. 在tomcat的conf目錄下修改tomcat-users.xml
增加如下內容:
該用戶用於訪問drools kie
11. 在mysql中建立一個schema,名為drools
並為該schema分配一個用戶,該用戶如果是通過遠程訪問mysql記得該用戶要建成%(或者是username@ip地址)這樣的格式,因為drools在第一次運行時會通過JPA在相應的DB內建立39張表。
12. 修改tomcat目錄bin下的catalina.sh文件
增加如下內容
export CATALINA_HOME="/opt/tomcat1"
export CATALINA_OPTS="-Dbtm.root=$CATALINA_HOME \
-Dbitronix.tm.configuration=$CATALINA_HOME/conf/btm-config.properties \
-Djbpm.tsr.jndi.lookup=java:comp/env/TransactionSynchronizationRegistry \
-Djava.security.auth.login.config=$CATALINA_HOME/webapps/kie-drools/WEB-INF/classes/login.config \
-Dorg.jboss.logging.provider=jdk"
export JAVA_OPTS="-d64 -server -showversion -Xms1024m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=256m -XX:CICompilerCount=8 -XX:+UseCompressedOops -XX:-DontCompileHugeMethods -Xss256k -XX:+AggressiveOpts -XX:+UseBiasedLocking -XX:MaxTenuringThreshold=31 -XX:+CMSParallelRemarkEnabled -XX:+UseCMSCompactAtFullCollection -XX:+UseFastAccessorMethods -Djava.awt.headless=true -XX:+UseCMSInitiatingOccupancyOnly -XX:+UseGCOverheadLimit -XX:+UseConcMarkSweepGC -XX:+UseParNewGC -XX:MaxGCPauseMillis=200 -Dorg.kie.demo=false"
注意:
1. 此處我的tomcat是放在CentOS的/opt/tomcat1下的,因此我的CATALINA_HOME的設置要換成你的tomcat所在的路徑
2. 參數 –Dorg.kie.demo=false的作用是在無互聯網環境下去運行kie-drools時,如果不加此參數kie-drools會在每次運行時去GIT試圖加載kie-drools的demo,如果你的服務器為虛擬機或者是無互聯網環境時它會因為建立internet連接超時而拋出一個疑似memory leak的exception而導致整個war工程加載失敗。
3. \ 這個符號的前後都要有空格,同時每行啟始處也有有空格,這個符號的作用是在LINUX的CONSOLE界面中一行太長了,分成多行寫但可以連成一行執行的作用。
啟動
在tomcat/bin目錄下鍵入: ./catalina.sh start啟動tomcat,在tomcat/logs目錄下觀察日志文件:
打開一個IE,輸入如下地址:http://192.168.0.101:8080/kie-drools即可看到kie-drools的主界面了
KIE的使用
使用tomcat/tomcat(在tomcat-users.xml文件中配置的具有admin/analyst角色的用戶即可登錄)
新建一個Project
‘
可以看到,在KIE-DROOLS裡的project其實就是一個maven工程
在project裡新建一條規則
為了練習,我們將新建一條規則,這條規則很簡單:
假設有一報銷流程,需要經過部門經理審批後到財務,如果員工的報銷經額大於5,000那麼除部門經理需要審批外還要報總經理再審批。
這是一條業務規則,假設哪天總經理說“大於5,000就要我批,我太煩了,改成大於10,000塊才需要我審核吧”,想一下我們傳統的做法。
利用KIE-DROOLS書寫規則-建立因子
該規則涉及到一個公式 money>X
該規則涉及到一個因子,money
按照上述思想,我們先建立因子
這個Data Object就是因子
你可以在eclipse裡把這個POJO寫好後直接復制到KIE-DROOLS的Data Object編輯界面中去:
package org.sky.threshholdrulz;
public class PaymentInfo implements java.io.Serializable {
static final long serialVersionUID = 1L;
public PaymentInfo() {
}
private int moneyAmount = 0;
private String decisionPath = "";
public void setMoneyAmount(int amount) {
this.moneyAmount = amount;
}
public int getMoneyAmount() {
return this.moneyAmount;
}
public void setDecisionPath(String path) {
this.decisionPath = path;
}
public String getDecisionPath() {
return this.decisionPath;
}
}
不要忘了點”SAVE“按鈕。
利用KIE-DROOLS書寫規則-規則
規則內容如下:
package org.sky.threshholdrulz;
no-loop
rule "approval decision by manager"
when
m : PaymentInfo( moneyAmount>5000 );
then
modify (m) { setDecisionPath("GM") };
end
rule "approval decision by general manager"
when
m : PaymentInfo( moneyAmount<=5000 );
then
modify (m) { setDecisionPath("M") };
end
利用KIE-DROOLS書寫規則-測試規則
我們這條規則其實很簡單:
如果PaymentInfo因子中的paymentAmount>5000,那麼PaymentInfo中的decisionPath返回就是字符串“GM”。
如果PaymentInfo因子中的paymentAmount<=5000,那麼PaymentInfo中的decisionPath返回就是字符串“M”。
利用KIE-DROOLS書寫規則-向導式的Test Scenario
利用KIE-DROOLS書寫規則-給測試用例創建數據
利用KIE-DROOLS書寫規則-運行測試
使用JAVA程序調用規則-規則存本地
結束本次教程
後面的教程會講述如何把.drools文件建到我們自己搭建的kie-drools workbench 6.3.0.Final上,然後用JAVA代碼遠程訪問的內容,這塊內容目前在國內的博文和論壇中幾乎無資料,筆者也是通過看源碼和看官方文檔後總結出來的。
其遠程訪問共分為兩種:stateful(有狀態)和stateless(無狀態)2種,文中也會給出相應的對比和講解。