springboot整合规则引擎URule

前言: 项目中要使用规则引擎,所以本人有尝试使用urule这款国内公司开发的规则引擎,用的是开源版的

相比其他规则引擎,urule有如下特点:
- 响应毫秒级
- 支持规则在client的缓存,并自动比对更新时间,减少网络IO,但客户端需要引入jar
- 原生支持动态规则和两种规则持久化方式(文件,数据库)
- 支持决策树,决策表等
- 集成了可视化规则管理界面,管理规则方便
- 社区活跃度低,技术支持需要付费
- 功能强大,但开源版功能有限

这里介绍一下如何将URule整合到springBoot项目中

官方文档:http://www.bstek.com/resources/doc/

先来瞅瞅他的管理界面长啥样!

按层级从上往下是项目(就是图中的UCTest)--知识包--决策表/决策树等--库

1.库是最低的层级: 在这里创建需要校验的基本数据或者POJO, 如图上我就是想对UserParam进行校验.将名称和全类名添加进去.

2.决策集\决策树就是一个个具体的规则了.

在这里以库为校验对象创建规则.

3.知识包是多个决策树/决策集的集合,创建知识包之后再加入决策集

4.项目下面包含多个知识包,可以将知识包暴露给多个客户端

直接在树菜单上右键即可操作.

服务端配置:

pom.xml

<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-jpa</artifactId></dependency><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId></dependency><dependency><groupId>javax.servlet</groupId><artifactId>servlet-api</artifactId><version>2.5</version><scope>provided</scope></dependency><!-- urule规则引擎 --><dependency><groupId>com.bstek.urule</groupId><artifactId>urule-console</artifactId><version>2.1.6</version></dependency></dependencies>

需要两个核心类:

1.config.java

@Configuration
@ImportResource({"classpath:urule-console-context.xml"})
@PropertySource(value = {"classpath:urule-console-context.properties"})
public class Config {@Beanpublic PropertySourcesPlaceholderConfigurer propertySourceLoader() {PropertySourcesPlaceholderConfigurer configurer = new PropertySourcesPlaceholderConfigurer();configurer.setIgnoreUnresolvablePlaceholders(true);configurer.setOrder(1);return configurer;}@Bean@ConfigurationProperties(prefix = "spring.datasource")public DataSource datasource() {return DataSourceBuilder.create().build();}
}

这里其实就是引入jar包中的配置文件:

classpath:urule-console-context.xml

classpath:urule-console-context.properties

非maven项目参考: https://blog.csdn.net/su1573/article/details/82178544

2.URuleServletRegistration.java

package com.example.demo.ur;import org.springframework.boot.web.servlet.ServletRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.stereotype.Component;import com.bstek.urule.console.servlet.URuleServlet;@Component
public class URuleServletRegistration {@Beanpublic ServletRegistrationBean registerURuleServlet(){return new ServletRegistrationBean(new URuleServlet(),"/urule/*");}
}

3. 配置文件:application.yml(当然,这些配置你想放到properties文件或者配置中心都可以), 主要配置持久化的数据库地址

spring:datasource:jdbc-url: 这里写数据库地址driver-class-name: com.mysql.jdbc.Driverusername: rootpassword: 1234jackson:default-property-inclusion: non_nullserver:port: 8755

然后直接用springBoot启动类启动就好了,再输入http://localhost:8755/urule/frame

就可以看到管理界面了

客户端配置

pom.xml

<!-- urule规则引擎 --><dependency><groupId>com.bstek.urule</groupId><artifactId>urule-console</artifactId><version>2.1.6</version></dependency>

application.yml配置服务端地址:

urule:resporityServerUrl: http://localhost:8755knowledgeUpdateCycle: 1

如果“urule.knowledgeUpdateCycle”属性值大于1，那么客户端会首先检查本地缓存中是否存在指定的知识包，如果存在，那么就拿当前时间与本地缓存中的知识包的时间戳进行比较，如果小于“urule.knowledgeUpdateCycle”属性值，那么就直接取这个知识包，如果大于它，那么就到URule Server上通过时间戳检查当前知识包有没有更新，如果有更新则取到客户端，同时更新客户端缓存里对应的知识包；如果没有更新，那么就直接采用当前客户端缓存里的知识包。

客户端调用:

package tt;
import rete.test.Dept;
import rete.test.Employee;
import com.bstek.urule.Utils;
import com.bstek.urule.runtime.KnowledgePackage;
import com.bstek.urule.runtime.KnowledgeSession;
import com.bstek.urule.runtime.KnowledgeSessionFactory;
import com.bstek.urule.runtime.service.KnowledgeService;public class Invoke {public void doTest() throws Exception{//从Spring中获取KnowledgeService接口实例KnowledgeService service=(KnowledgeService)Utils.getApplicationContext().getBean(KnowledgeService.BEAN_ID);//通过KnowledgeService接口获取指定的资源包"项目名/知识包名"KnowledgePackage knowledgePackage=service.getKnowledge("UCTest/UCBag");//通过取到的KnowledgePackage对象创建KnowledgeSession对象KnowledgeSession session=KnowledgeSessionFactory.newKnowledgeSession(knowledgePackage);Employee employee=new Employee();Dept dept=new Dept();dept.setLevel(12);employee.setDept(dept);employee.setSalary(111000);//将业务数据对象Employee插入到KnowledgeSession中session.insert(employee);//执行所有满足条件的规则session.fireRules();}
}

可以直接把上面这段代码嵌入web项目的controller

getKnowledge(..)方法必须传入的是"项目名/知识包名",我之前就没有创建知识包,写的是规则名所以获取服务失败了.

新增修改知识包之后必须先发布知识包,再将其推送至客户端才可以使用