SpringBoot+URule實(shí)現(xiàn)可視化規(guī)則引擎的方法示例
一、背景
前段時(shí)間,在做項(xiàng)目重構(gòu)的時(shí)候,遇到很多地方需要做很多的條件判斷。當(dāng)然可以用很多的if-else判斷去解決,但是當(dāng)時(shí)也不清楚怎么回事,就想玩點(diǎn)別的。于是乎,就去調(diào)研了規(guī)則引擎。
當(dāng)然,市面上有很多成熟的規(guī)則引擎,功能很多,性能很好。但是,就是想玩點(diǎn)不一樣的(大家做技術(shù)選型別這樣,這個(gè)是反面教材)。最終一款URule的規(guī)則引擎吸引了我,主要還是采用瀏覽器可直接配置,不需要過多安裝,可視化規(guī)則也做的不錯(cuò)。經(jīng)過一系列調(diào)研,后面就把它接入了項(xiàng)目中,順便記錄下調(diào)研的結(jié)果。
二、介紹
規(guī)則引擎其實(shí)是一種組件,它可以嵌入到程序當(dāng)中。將程序復(fù)雜的判斷規(guī)則從業(yè)務(wù)代碼中剝離出來,使得程序只需要關(guān)心自己的業(yè)務(wù),而不需要去進(jìn)行復(fù)雜的邏輯判斷;簡(jiǎn)單的理解是規(guī)則接受一組輸入的數(shù)據(jù),通過預(yù)定好的規(guī)則配置,再輸出一組結(jié)果。
當(dāng)然,市面上有很多成熟的規(guī)則引擎,如:Drools、Aviator、EasyRules等等。但是URule,它可以運(yùn)行在Windows、Linux、Unix等各種類型的操作系統(tǒng)之上,采用純?yōu)g覽器的編輯模式,不需要安裝工具,直接在瀏覽器上編輯規(guī)則和測(cè)試規(guī)則。
當(dāng)然這款規(guī)則引擎有開源和pro版本的區(qū)別,至于pro版是啥,懂的都懂,下面放個(gè)表格,了解下具體的區(qū)別
三、安裝使用
實(shí)際使用時(shí),有四種使用URule Pro的方式,分別是嵌入式模式、本地模式、分布式計(jì)算模式以及獨(dú)立服務(wù)模式。
但是我們這里不考慮URule Pro,咱自己整個(gè)開源版,在開源版集成springboot的基礎(chǔ)上做一個(gè)二次開發(fā),搜了一圈,其實(shí)就有解決方案。
大致的項(xiàng)目模塊如下:
自己創(chuàng)建個(gè)空數(shù)據(jù)庫,只需要在edas-rule-server服務(wù)中修改下數(shù)據(jù)庫的配置,然后啟動(dòng)服務(wù)即可。第一次啟動(dòng)完成,數(shù)據(jù)庫中會(huì)創(chuàng)建表。
spring.datasource.type=com.alibaba.druid.pool.DruidDataSource spring.datasource.driver-class-name=com.mysql.jdbc.Driver spring.datasource.url=jdbc:mysql://localhost:3306/urule-data?serverTimezone=Asia/Shanghai&useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&useSSL=false spring.datasource.username=root spring.datasource.password=mysql
上面說過,它是純用瀏覽器進(jìn)行編輯,配置規(guī)則的,只需要打開瀏覽器,輸入地址:http://localhost:8090/urule/frame,看到這個(gè)界面,就說明啟動(dòng)成功了。
四、基礎(chǔ)概念
4.1整體介紹
先說下URule它的構(gòu)成部分,主要是兩部分:1、設(shè)計(jì)器部分 2、規(guī)則執(zhí)行引擎。設(shè)計(jì)器部分主要是庫文件和規(guī)則文件構(gòu)成。下面看下整體的結(jié)構(gòu)圖
4.2庫文件
如上圖介紹的,庫文件有4種,包括變量庫,參數(shù)庫,常量庫和動(dòng)作庫。其實(shí)類似于Java開發(fā)的系統(tǒng)中的實(shí)體對(duì)象,枚舉,常量以及方法。
上面說過,規(guī)則都是可視化配置的。在配置規(guī)則的過程中,就需要引入各種已經(jīng)定義好的庫文件,再結(jié)合業(yè)務(wù)需求,從而配置出符合業(yè)務(wù)場(chǎng)景的業(yè)務(wù)規(guī)則,所以哪里都有庫文件的身影。
4.2.1變量庫文件
在業(yè)務(wù)開發(fā)中,我們會(huì)創(chuàng)建很多Getter和Setter的Java類,比如PO、VO、BO、DTO、POJO等等,其實(shí)這些類new對(duì)象后主要起到的作用就是數(shù)據(jù)的載體,用來傳輸數(shù)據(jù)。
在URule中,變量庫就是用來映射這些對(duì)象,然后可以在規(guī)則中使用,最終完成業(yè)務(wù)和規(guī)則的互動(dòng)。最后上一張圖,用來創(chuàng)建變量庫
對(duì)了,上面廢話了這么多可視化配置,這才是第一次展示配置界面,慚愧慚愧。
上圖一目了然,在“庫”這個(gè)菜單底下右鍵,然后點(diǎn)擊添加變量庫即可,最后定義自己喜歡的變量庫名,當(dāng)然名字只支持中文或者英文,其他字符不可用。
創(chuàng)建完變量庫后,就可以對(duì)變量庫進(jìn)行編輯,可以認(rèn)為就是給POJO添加屬性
也不彎彎繞繞講什么術(shù)語,就個(gè)人理解。圖左邊是創(chuàng)建類,其中名稱是它的別名,配置規(guī)則用它代替這個(gè)類。圖右邊是類的屬性,我這里隨便寫了幾個(gè),估計(jì)看了懂得都懂。
最后在業(yè)務(wù)系統(tǒng)中創(chuàng)建對(duì)應(yīng)的類,注意全限定名和配置變量庫的類路徑一致。
package com.cicada; import com.bstek.urule.model.Label; import lombok.Data; /** * @author 往事如風(fēng) * @version 1.0 * @date 2023/3/3 15:38 * @description */ @Data public class Stu { @Label("姓名") private String name; @Label("年齡") private int age; @Label("班級(jí)") private String classes; }
最后說下這個(gè)@Label
注解,這個(gè)是由URule提供的注解,主要是描述字段的屬性,跟變量庫的標(biāo)題一欄一致就行。聽官方介紹可以通過這個(gè)注解,實(shí)現(xiàn)POJO屬性和變量庫屬性映射。就是POJO寫好,然后對(duì)應(yīng)規(guī)則的變量庫就不需要重新寫,可以直接生成。反正就有這個(gè)功能,這里就直接一筆帶過了。
4.2.2常量庫文件
說到常量庫,這個(gè)就可以認(rèn)為是我們Java系統(tǒng)中的常量,枚舉。比如性別,要定義枚舉吧;比如對(duì)接的機(jī)構(gòu),也可以定義一個(gè)枚舉吧。
當(dāng)然,類似于變量庫,常量庫也可以實(shí)現(xiàn)和系統(tǒng)中的枚舉相互映射,這樣做的好處可以避免我們手動(dòng)輸入,防止輸入錯(cuò)誤。創(chuàng)建常量庫也比較簡(jiǎn)單,直接在“庫”這個(gè)菜單下右鍵,“添加常量庫”。
創(chuàng)建好常量庫文件后,也會(huì)出現(xiàn)如下頁面:
4.2.3參數(shù)庫文件
參數(shù)庫,就是URule規(guī)則中的臨時(shí)變量,變量的類型和數(shù)量不固定??梢哉J(rèn)為類似于Map,實(shí)際上存儲(chǔ)參數(shù)庫的也就是個(gè)Map。
同樣的套路,直接在“庫”這個(gè)菜單下右鍵,“添加參數(shù)庫”。
可以看到,參數(shù)庫已經(jīng)少了左邊分類這一項(xiàng),直接添加參數(shù),選擇類型就是干,相對(duì)簡(jiǎn)單了很多。“名稱”這列我這里用了英文,就是Map中的key,而“標(biāo)題”這列就是在配置規(guī)則時(shí)候顯示用的,中文看著比較直觀。
當(dāng)然還需要注意的點(diǎn)是,定義的名稱要保證唯一,因?yàn)镸ap中的key是唯一的,不然就會(huì)存在覆蓋的情況。
4.2.4動(dòng)作庫文件
動(dòng)作庫可以對(duì)配置在spring中的bean方法進(jìn)行映射,然后可以在規(guī)則中直接調(diào)用這批方法。慣用套路,還是在“庫”菜單下右鍵,點(diǎn)擊“添加動(dòng)作庫”。
然后我在系統(tǒng)中添加了一個(gè)類Action
,然后在類上標(biāo)記@Component
注解,將該類交給spring的bean容器管理。該類中添加一些方法,在方法上標(biāo)記@ExposeAction
注解,該注解是URule定義的,說明被標(biāo)記的方法都會(huì)被動(dòng)作庫讀取到。
package com.bstek.urule.cicada; import com.bstek.urule.action.ActionId; import com.bstek.urule.model.ExposeAction; import org.springframework.stereotype.Component; import java.text.SimpleDateFormat; import java.util.Date; /** * @author 往事如風(fēng) * @version 1.0 * @date 2023/3/10 13:59 * @description */ @Component("action") public class Action { @ActionId("Hello") public String hello(){ return "hello"; } @ExposeAction(value="方法1") public boolean evalTest(String username){ if(username==null){ return false; }else if(username.equals("張三")){ return true; } return false; } @ExposeAction(value="測(cè)試Int") public int testInt(int a,int b){ return a+b; } @ExposeAction(value="打印內(nèi)容") public void printContent(String username, Date birthday){ SimpleDateFormat sd=new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); if(birthday!=null){ System.out.println(username+"今年已經(jīng)"+sd.format(birthday)+"歲了!"); }else{ System.out.println("Hello "+username+""); } } @ExposeAction(value="打印Stu") public void printUser(Stu m){ System.out.println("Hello "+m.getName()+", is age:"+m.getAge()); } }
最后在動(dòng)作庫頁面上添加bean,“Bean Id”一列輸入對(duì)應(yīng)的spring bean的名稱,這里輸入action。然后點(diǎn)擊操作列中的小手按鈕,就會(huì)彈出剛在Action
類中標(biāo)記了ExposeAction
注解的方法。選擇一個(gè)指定的方法添加進(jìn)來,最后看到方法對(duì)應(yīng)的參數(shù)也會(huì)被自動(dòng)加載進(jìn)去。
最后,變量庫、參數(shù)庫、動(dòng)作庫、常量庫這些庫文件定義好后,各種規(guī)則文件配置的時(shí)候就可以導(dǎo)入他們。但是一旦這些庫文件被某個(gè)規(guī)則文件使用,就不要隨意修改庫文件了。
4.3規(guī)則集
說到規(guī)則集,顧名思義,就是配置規(guī)則了。前面定義的庫文件就需要導(dǎo)入到規(guī)則集中去配置使用。它是使用頻率最高的一個(gè)業(yè)務(wù)規(guī)則實(shí)現(xiàn)方式。
規(guī)則集說的是規(guī)則的集合,由三個(gè)部分規(guī)則組成:如果、那么、否則。
在規(guī)則集的定義的方式上,URule由向?qū)胶湍_本式兩種;
向?qū)揭?guī)則集:就是在頁面上通過鼠標(biāo)點(diǎn)點(diǎn)點(diǎn),高度的可視化配置,不是開發(fā)都能懂,這也是這個(gè)規(guī)則引擎的亮點(diǎn)所在。
腳本式規(guī)則集:聽名字就知道了,這玩意要寫腳本的。拉高配置門檻,需要懂點(diǎn)編碼的人來編寫。
4.3.1向?qū)揭?guī)則集
還是一樣,首先新建。這次是在“決策集”菜單上右鍵,點(diǎn)擊“添加向?qū)經(jīng)Q策集”,這樣就創(chuàng)建好一個(gè)規(guī)則集了。
在配置規(guī)則前,可以先導(dǎo)入前面定義好的庫文件。我這里導(dǎo)入變量庫文件,頁面上點(diǎn)擊“變量庫”,然后選擇指定的變量庫文件即可。如圖所示;
最后,可以愉快的配置規(guī)則了,向?qū)經(jīng)]什么好講的,都是可視化界面,點(diǎn)點(diǎn)點(diǎn)即可。下面是我配置的一個(gè)簡(jiǎn)單的規(guī)則集;
可以看到由三部分組成:如果、那么、否則;
如果:配置規(guī)則的條件;
那么:配置滿足條件后執(zhí)行的動(dòng)作,一般配置變量賦值比較多
否則:配置不滿足條件執(zhí)行的動(dòng)作
最后,附上添加完規(guī)則后,通過代碼去執(zhí)行規(guī)則;
package com.cicada; import cn.hutool.core.bean.BeanUtil; import com.Result; 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; import com.cicada.req.StuReq; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestBody; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import java.io.IOException; /** * @author 往事如風(fēng) * @version 1.0 * @date 2023/3/10 16:47 * @description */ @RestController @RequestMapping("/rule") public class RuleDataController { @PostMapping("/stu") public Result rule(@RequestBody StuReq stuReq) throws IOException { KnowledgeService knowledgeService = (KnowledgeService) Utils.getApplicationContext().getBean(KnowledgeService.BEAN_ID); KnowledgePackage knowledgePackage = knowledgeService.getKnowledge("xxx/xxx"); KnowledgeSession knowledgeSession = KnowledgeSessionFactory.newKnowledgeSession(knowledgePackage); Stu stu = BeanUtil.copyProperties(stuReq, Stu.class); knowledgeSession.insert(stu); knowledgeSession.fireRules(); return Result.success(stu.getTeacher()); } }
請(qǐng)求接口,最終參數(shù)符合配置的條件,返回“那么”中配置的輸出結(jié)果。
4.3.2腳本式規(guī)則集
腳本式的規(guī)則集,各種原理都是和向?qū)揭荒R粯?,無非就是拉高門檻,用寫腳本的方式去實(shí)現(xiàn)配置的規(guī)則。這里不做過多的介紹了。
4.4決策表
再聊下決策表,其實(shí)它就是規(guī)則集的另一種展示形式,比較相對(duì)規(guī)則集,我更喜歡用決策表去配置規(guī)則,應(yīng)為它呈現(xiàn)的更加直觀,更便于理解。但是本質(zhì)和規(guī)則集沒啥區(qū)別。
也不展開過多的贅述,這里我就放一張配置過的決策表;
4.5其他
當(dāng)然,還有其他的概念和功能,這里也不一一介紹了,因?yàn)樯厦嬲f的已經(jīng)是最常用的了,想了解的可以自行去了解。其他功能包括:交叉決策表、評(píng)分卡、復(fù)雜評(píng)分卡、決策樹、規(guī)則流;當(dāng)然,其中有些是Pro版的功能。
四、運(yùn)用場(chǎng)景
最近在開發(fā)一期大版本的需求,其中就有個(gè)場(chǎng)景,具體如下;參與購買訂單的用戶都會(huì)有自己的一個(gè)職級(jí),也可以說是角色。每個(gè)用戶都會(huì)有三個(gè)職位:普通用戶、會(huì)員、精英會(huì)員。
然后,每個(gè)月初都會(huì)對(duì)用戶進(jìn)行一次晉升處理,普通用戶達(dá)到要求,就會(huì)晉升為會(huì)員,會(huì)員達(dá)到要求就會(huì)晉升為精英會(huì)員。
當(dāng)然,普通用戶晉升會(huì)員,會(huì)員晉升精英會(huì)員,都會(huì)有不同的規(guī)則;
普通用戶->會(huì)員:3個(gè)月內(nèi)幫注冊(cè)人數(shù)達(dá)到3人;3個(gè)月內(nèi)自己和底下團(tuán)隊(duì)的人,下單金額超過1萬;個(gè)人的訂單繼續(xù)率超過80%。
會(huì)員->精英會(huì)員:3個(gè)月內(nèi)幫注冊(cè)人數(shù)達(dá)到6人;3個(gè)月內(nèi)自己和底下團(tuán)隊(duì)的人,下單金額超過5萬;個(gè)人的訂單繼續(xù)率超過90%。
不能跨級(jí)晉升,普通用戶最多只能到會(huì)員,達(dá)到會(huì)員了才能晉升到精英會(huì)員。
當(dāng)然,這只是做過簡(jiǎn)化的一部分需求,我做過稍許的改動(dòng),真實(shí)的需求場(chǎng)景并沒有這么簡(jiǎn)單。
下面,我對(duì)這個(gè)需求做一個(gè)規(guī)則的配置,這里用一個(gè)決策表進(jìn)行配置;在配置規(guī)則前,我添加一個(gè)變量庫文件和常量庫;
最后,添加一個(gè)決策表,并進(jìn)行規(guī)則配置;
可以看到,表格一共五列,其中前四列是規(guī)則,最后一列是滿足規(guī)則后輸出的信息。這樣看著就很清晰,即使并不是技術(shù)人員,也可以輕松看懂其中的規(guī)則。
五、總結(jié)
規(guī)則引擎對(duì)于我們的系統(tǒng)而言可用可不用,它可以錦上添花,幫助我們剝離出業(yè)務(wù)中需要進(jìn)行大量判斷的場(chǎng)景。但是,這種規(guī)則的剝離,需要我們開發(fā)人員對(duì)需求進(jìn)行理解,在理解的基礎(chǔ)上進(jìn)行抽象概念的具化。
以上就是SpringBoot+URule實(shí)現(xiàn)可視化規(guī)則引擎的方法示例的詳細(xì)內(nèi)容,更多關(guān)于SpringBoot URule可視化規(guī)則引擎的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章
編寫android撥打電話apk應(yīng)用實(shí)例代碼
這篇文章主要介紹了編寫android撥打電話apk應(yīng)用實(shí)例代碼,十分的實(shí)用,這里分享給大家,有需要的小伙伴可以參考下2015-04-04淺談導(dǎo)入JavaWeb 項(xiàng)目出現(xiàn)的問題
這篇文章主要介紹了導(dǎo)入JavaWeb 項(xiàng)目出現(xiàn)的問題,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2019-03-03Struts2實(shí)現(xiàn)文件下載功能代碼分享(文件名中文轉(zhuǎn)碼)
這篇文章主要介紹了Struts2實(shí)現(xiàn)文件下載功能代碼分享(文件名中文轉(zhuǎn)碼)的相關(guān)資料,需要的朋友可以參考下2016-06-06SpringBoot3整合Swagger3時(shí)出現(xiàn)Type javax.servlet.http.H的ttpSe
這篇文章主要介紹了SpringBoot3整合Swagger3時(shí)出現(xiàn)Type javax.servlet.http.H的ttpServletRequest not present錯(cuò)誤解決方法,文中有詳細(xì)的解決方法,需要的朋友可以參考下2025-01-01Springboot如何獲取yml、properties參數(shù)
這篇文章主要介紹了Springboot如何獲取yml、properties參數(shù),具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2022-03-03