jboss规则引擎KIE Drools 6.3.0 Final 教程(1)

本文涉及的产品
云数据库 RDS MySQL Serverless,0.5-2RCU 50GB
简介: 前言目前世面上中文的KIE DROOLS Workbench(JBOSS BRMS)的教程几乎没有,有的也只有灵灵碎碎的使用机器来翻译的(翻的不知所云)或者是基于老版本的JBOSS Guvnor即5.x的一些教程,而且这些教程都是”缺胳膊少腿“的,初学者看后不知道它到底在干吗?能干吗?能够解决自己系统中什么问题。

前言


目前世面上中文的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 6
  •  mysql5.5.x or above
  •  apache-tomcat-7.0.67.zip(Tomcat7.0.4 or above)


这些环境,读者应该自己会安装了。


准备安装文件与环境-必须软件



  • kie-drools-wb-6.3.0.Final-tomcat7.war
  • drools-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)


以上12个依赖文件如果读者一时搜不到,不要紧我都把它们上传在此了: droos6.3.0在tomcat布署时的缺失包.zip


开始安装


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


<properties>
      <!--property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect"/-->
      <property name="hibernate.dialect" value="org.hibernate.dialect.MySQL5Dialect"/>
      <property name="hibernate.max_fetch_depth" value="3"/>
      <property name="hibernate.hbm2ddl.auto" value="update"/>
      <property name="hibernate.show_sql" value="false"/>
      <property name="hibernate.transaction.manager_lookup_class" value="org.hibernate.transaction.BTMTransactionManagerLookup"/>
      <!-- BZ 841786: AS7/EAP 6/Hib 4 uses new (sequence) generators which seem to cause problems -->
      <property name="hibernate.id.new_generator_mappings" value="false"/>
 </properties>


6. tomcatconf目录下增加一个文件名为: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目录下增加一个文件名为:resources.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


增加如下内容:

<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

增加如下内容:


<Valve className="org.kie.integration.tomcat.JACCValve" /> 


记得一定要在</host>上部加入


10. 在tomcat的conf目录下修改tomcat-users.xml


增加如下内容:


<user username="tomcat" password="tomcat" roles="admin,manager,manager-gui"/>

该用户用于访问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时碰到让你必须"Select a repository”,请按照下面步骤操作





在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 general manager"
    when
        m : PaymentInfo( moneyAmount>5000 );
    then
         modify (m) { setDecisionPath("GM") };
end

rule "approval decision by 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种,文中也会给出相应的对比和讲解。
相关实践学习
基于CentOS快速搭建LAMP环境
本教程介绍如何搭建LAMP环境,其中LAMP分别代表Linux、Apache、MySQL和PHP。
全面了解阿里云能为你做什么
阿里云在全球各地部署高效节能的绿色数据中心,利用清洁计算为万物互联的新世界提供源源不断的能源动力,目前开服的区域包括中国(华北、华东、华南、香港)、新加坡、美国(美东、美西)、欧洲、中东、澳大利亚、日本。目前阿里云的产品涵盖弹性计算、数据库、存储与CDN、分析与搜索、云通信、网络、管理与监控、应用服务、互联网中间件、移动服务、视频服务等。通过本课程,来了解阿里云能够为你的业务带来哪些帮助 &nbsp; &nbsp; 相关的阿里云产品:云服务器ECS 云服务器 ECS(Elastic Compute Service)是一种弹性可伸缩的计算服务,助您降低 IT 成本,提升运维效率,使您更专注于核心业务创新。产品详情: https://www.aliyun.com/product/ecs
目录
相关文章
|
Java 应用服务中间件 数据库连接
jboss规则引擎KIE Drools 6.3.0-集群篇
DROOLS集群的原理 Drools集群是架设在jboss集群之上的 Drools集群其实是WorkBench(WB)间的集群 KIE SERVER是JSON服务,它是架设在WB上的,一个WB可以挂1个、多个KIE SERVER WB除了...
3558 0
|
Java 数据库连接 应用服务中间件
jboss规则引擎KIE Drools 6.3.0-高级讲授篇
在生产环境怎么用BRMS 回溯BRMS开发教程中的那张“业务变现加速器”架构图,考虑下面的问题 业务开发人员开发规则 IT人员提供FACT 关键在于“全动态” SQL语句改了怎么办?不重启 DAO层改了怎么办?不重启 Mybatis的配置文件改了怎么办?不重启 按照上次的《jboss规则引擎KIE Drools 6.
2894 0
|
Java 应用服务中间件
jboss规则引擎KIE Drools 6.3.0 Final 教程(2)
使用JAVA程序调用规则-运行KIE-DROOLS上的规则 第一步:建立一个MAVEN的Java工程 POM.XML 给出pom.
1818 0
|
应用服务中间件
jboss规则引擎KIE Drools 6.3.0 Final 教程(3)
在前2部教程中,介绍了如何在本地运行.drools文件以及使用stateless的方法访问远程repository上的规则。 KIE Drools还提供了一种叫有状态-stateful的访问方式。
1336 0
|
应用服务中间件 Java
把Drools 5.4集成到JBoss AS 7.1.1
Drools5引入了业务逻辑集成平台,它提供了支持规则、工作流和事件处理的统一、集成的平台。一切都是重新设计。Drools 5可以分成4个主要的子项目:Guvnor(BRMS/BPMS)、Expert(规则引擎)、Flow(处理/工作流)、Fusion(cep/temporal reasoning)。
908 0
|
应用服务中间件 Java
把Drools 5.4集成到JBoss AS 7.1.1
版权声明:本文为博主chszs的原创文章,未经博主允许不得转载。 https://blog.csdn.net/chszs/article/details/8167836 把Drools 5.4集成到JBoss AS 7.1.1作者:chszs,转载需注明。
801 0