12.內(nèi)置動(dòng)作定義

12.內(nèi)置動(dòng)作定義

概述

在之前的內(nèi)容當(dāng)中我們了解到，如果要在決策集、決策表、交叉決策表、決策樹、評(píng)分卡、復(fù)雜評(píng)分卡或決策流中使用某個(gè)Spring Bean中定義的方法，那么可以使用動(dòng)作庫(kù)將目標(biāo)Bean及相應(yīng)的方法定義到其中，然后在具體的決策集、決策表、交叉決策表、決策樹、評(píng)分卡、復(fù)雜評(píng)分卡或決策流中導(dǎo)入這個(gè)動(dòng)作庫(kù)就可以使用了，這種類型方法調(diào)用，需要我們的顯式的將目標(biāo)動(dòng)作庫(kù)導(dǎo)入后方可使用。

在URule Pro中還提供了一種不需要導(dǎo)入動(dòng)作庫(kù)就可以調(diào)用類方法的方式，我們稱之為內(nèi)置的動(dòng)作，對(duì)于這些內(nèi)置的動(dòng)作，按規(guī)范要求定義好后，用戶無需導(dǎo)入就可以直接在所有規(guī)則文件中使用。

對(duì)于內(nèi)置動(dòng)作的使用與用戶自定義的動(dòng)作庫(kù)完全相同，不同地方在于內(nèi)置動(dòng)作不需要用戶定義，也不需要用戶導(dǎo)入，在任何一個(gè)決策集、決策表、交叉決策表、決策樹、評(píng)分卡、復(fù)雜評(píng)分卡或決策流中可以直接使用，如下圖所示：

如上圖所示，URule Pro中目前默認(rèn)提供的內(nèi)置動(dòng)作有七個(gè)，分別用于獲取當(dāng)前規(guī)則以及針對(duì)日期、字符串、常用數(shù)學(xué)函數(shù)、List集合、Map集合以及循環(huán)操作的計(jì)算。

• 當(dāng)前規(guī)則的內(nèi)置動(dòng)作

  該內(nèi)置動(dòng)作只能在規(guī)則的那么部分使用，不能在規(guī)則的條件中使用，否則會(huì)產(chǎn)生錯(cuò)誤。 該內(nèi)置動(dòng)作在2.1.9及以上版本中提供	方法名	描述
  當(dāng)前規(guī)則對(duì)象	返回當(dāng)前規(guī)則對(duì)象Rule
  當(dāng)前規(guī)則名	返回當(dāng)前規(guī)則的字符串類型的規(guī)則名稱
  當(dāng)前規(guī)則匹配的條件	返回當(dāng)前規(guī)則在匹配時(shí)所經(jīng)歷的條件節(jié)點(diǎn)對(duì)象集合，返回的是一個(gè)Set集合對(duì)象，里面是若干個(gè)Criteria對(duì)象

• 日期的內(nèi)置動(dòng)作

• 字符串的內(nèi)置動(dòng)作

• 常用數(shù)學(xué)函數(shù)的內(nèi)置動(dòng)作

• List集合的內(nèi)置動(dòng)作

• Map集合的內(nèi)置動(dòng)作

• 循環(huán)操作的內(nèi)置動(dòng)作

循環(huán)操作的動(dòng)作就一個(gè)，那就是中斷循環(huán)，該動(dòng)作只能用在循環(huán)規(guī)則里，用于在一定條件下中斷當(dāng)前的循環(huán)規(guī)則。

自定義內(nèi)置動(dòng)作

在用戶使用過程當(dāng)中，如果有一些自己內(nèi)部常用的操作，而這些操作在URule Pro中的內(nèi)置動(dòng)作中又沒有，那么可以利用自定義內(nèi)置動(dòng)作的方式定義自己的內(nèi)置動(dòng)作。

定義內(nèi)置動(dòng)作非常簡(jiǎn)單，只需要在需要暴露給用戶使用的Spring bean中添加相應(yīng)的annotation即可。我們先來看看URule Pro中提供的針對(duì)字符串的內(nèi)置動(dòng)作類的部分源代碼。

package com.bstek.urule.runtime.builtinaction;
import com.bstek.urule.model.library.action.annotation.ActionBean;
import com.bstek.urule.model.library.action.annotation.ActionMethod;
import com.bstek.urule.model.library.action.annotation.ActionMethodParameter;
/**
 * @author Jacky.gao
 * @since 2015年11月27日
 */
@ActionBean(name="字符串")
public class StringAction {
    @ActionMethod(name="去空格")
    @ActionMethodParameter(names={"目標(biāo)字符串"})
    public String trim(String str){
        if(str==null){
            return str;
        }
        return str.trim();
    }


    @ActionMethod(name="指定起始的字符串截取")
    @ActionMethodParameter(names={"目標(biāo)字符串","開始位置","結(jié)束位置"})
    public String substring(String str,int start,int end){
        return str.substring(start, end);
    }
    ......
}

可以看到，首先我們需要在”類“層面添加一個(gè)名為ActionBean的annotation，它只有一個(gè)屬性，就是要定義這個(gè)內(nèi)置動(dòng)作的名稱。然后在需要暴露的方法中添加兩個(gè)annotation，分別是ActionMethod和ActionMethodParameter。ActionMethod是用來定義用戶看到的方法名稱的，而ActionMethodParameter則是用來定義用戶看到的各個(gè)參數(shù)名稱，它的names屬性是一個(gè)數(shù)組，要求給出的描述參數(shù)要與當(dāng)前方法的參數(shù)個(gè)數(shù)匹配，如果小于參數(shù)個(gè)數(shù)，那么用戶將會(huì)看到后面的參數(shù)無描述信息。

在類中定義好這些Annotation之后，將這個(gè)類配置到Spring當(dāng)中，讓其成為一個(gè)標(biāo)準(zhǔn)的Spring Bean，并為其定義一個(gè)Bean Id，這樣URule在啟動(dòng)時(shí)就會(huì)自動(dòng)加載，并讓其成為內(nèi)置動(dòng)作，用戶就可以直接使用了。

定義內(nèi)置動(dòng)作的Spring Bean時(shí)，一定不要忘記給這個(gè)Spring Bean定義一個(gè)Id，這樣才能保證規(guī)則在任何地方運(yùn)行都不會(huì)出錯(cuò)，這點(diǎn)很關(guān)鍵。

在定義內(nèi)置動(dòng)作時(shí)需要注意，如果我們規(guī)則運(yùn)行方式采用的是客戶端服務(wù)器模式（參見第16小節(jié)內(nèi)容介紹），那么必須要保證調(diào)用知識(shí)包的客戶端Spring環(huán)境里有這個(gè)Bean，且Bean的Id要與動(dòng)作庫(kù)定義時(shí)的Id保證一至，否則調(diào)用會(huì)出現(xiàn)錯(cuò)誤。