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

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

概述

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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={"目標字符串"})
    public String trim(String str){
        if(str==null){
            return str;
        }
        return str.trim();
    }


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

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

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

定義內(nèi)置動作的Spring Bean時，一定不要忘記給這個Spring Bean定義一個Id，這樣才能保證規(guī)則在任何地方運行都不會出錯，這點很關(guān)鍵。

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