12.内置動作(zuò)定義

概述

在之前的内容當中(zhōng)我們了解到，如果要在決策集、決策表、交叉決策表、決策樹、評分(fēn)卡、複雜評分(fēn)卡或決策流中(zhōng)使用(yòng)某個Spring Bean中(zhōng)定義的方法，那麽可(kě)以使用(yòng)動作(zuò)庫将目标Bean及相應的方法定義到其中(zhōng)，然後在具(jù)體(tǐ)的決策集、決策表、交叉決策表、決策樹、評分(fēn)卡、複雜評分(fēn)卡或決策流中(zhōng)導入這個動作(zuò)庫就可(kě)以使用(yòng)了，這種類型方法調用(yòng)，需要我們的顯式的将目标動作(zuò)庫導入後方可(kě)使用(yòng)。

在URule Pro中(zhōng)還提供了一種不需要導入動作(zuò)庫就可(kě)以調用(yòng)類方法的方式，我們稱之為(wèi)内置的動作(zuò)，對于這些内置的動作(zuò)，按規範要求定義好後，用(yòng)戶無需導入就可(kě)以直接在所有(yǒu)規則文(wén)件中(zhōng)使用(yòng)。

對于内置動作(zuò)的使用(yòng)與用(yòng)戶自定義的動作(zuò)庫完全相同，不同地方在于内置動作(zuò)不需要用(yòng)戶定義，也不需要用(yòng)戶導入，在任何一個決策集、決策表、交叉決策表、決策樹、評分(fēn)卡、複雜評分(fēn)卡或決策流中(zhōng)可(kě)以直接使用(yòng)，如下图所示：

如上图所示，URule Pro中(zhōng)目前默認提供的内置動作(zuò)有(yǒu)七個，分(fēn)别用(yòng)于獲取當前規則以及針對日期、字符串、常用(yòng)數學(xué)函數、List集合、Map集合以及循環操作(zuò)的計算。

• 當前規則的内置動作(zuò)

  該内置動作(zuò)隻能(néng)在規則的那麽部分(fēn)使用(yòng)，不能(néng)在規則的條件中(zhōng)使用(yòng)，否則會産(chǎn)生錯誤。 該内置動作(zuò)在2.1.9及以上版本中(zhōng)提供

• 日期的内置動作(zuò)

• 字符串的内置動作(zuò)

• 常用(yòng)數學(xué)函數的内置動作(zuò)

• List集合的内置動作(zuò)

• Map集合的内置動作(zuò)

• 對象的的内置動作(zuò)

• 循環操作(zuò)的内置動作(zuò)

循環操作(zuò)的動作(zuò)就一個，那就是中(zhōng)斷循環，該動作(zuò)隻能(néng)用(yòng)在循環規則裏，用(yòng)于在一定條件下中(zhōng)斷當前的循環規則。

自定義内置動作(zuò)

在用(yòng)戶使用(yòng)過程當中(zhōng)，如果有(yǒu)一些自己内部常用(yòng)的操作(zuò)，而這些操作(zuò)在URule Pro中(zhōng)的内置動作(zuò)中(zhōng)又(yòu)沒有(yǒu)，那麽可(kě)以利用(yòng)自定義内置動作(zuò)的方式定義自己的内置動作(zuò)。

定義内置動作(zuò)非常簡單，隻需要在需要暴露給用(yòng)戶使用(yòng)的Spring bean中(zhōng)添加相應的annotation即可(kě)。我們先來看看URule Pro中(zhōng)提供的針對字符串的内置動作(zuò)類的部分(fēn)源代碼。

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={"目标字符串","開始位置","結束位置"})
    public String substring(String str,int start,int end){
        return str.substring(start, end);
    }
    ......
}

可(kě)以看到，首先我們需要在”類“層面添加一個名(míng)為(wèi)ActionBean的annotation，它隻有(yǒu)一個屬性，就是要定義這個内置動作(zuò)的名(míng)稱。然後在需要暴露的方法中(zhōng)添加兩個annotation，分(fēn)别是ActionMethod和ActionMethodParameter。ActionMethod是用(yòng)來定義用(yòng)戶看到的方法名(míng)稱的，而ActionMethodParameter則是用(yòng)來定義用(yòng)戶看到的各個參數名(míng)稱，它的names屬性是一個數組，要求給出的描述參數要與當前方法的參數個數匹配，如果小(xiǎo)于參數個數，那麽用(yòng)戶将會看到後面的參數無描述信息。

在類中(zhōng)定義好這些Annotation之後，将這個類配置到Spring當中(zhōng)，讓其成為(wèi)一個标準的Spring Bean，并為(wèi)其定義一個Bean Id，這樣URule在啓動時就會自動加載，并讓其成為(wèi)内置動作(zuò)，用(yòng)戶就可(kě)以直接使用(yòng)了。

定義内置動作(zuò)的Spring Bean時，一定不要忘記給這個Spring Bean定義一個Id，這樣才能(néng)保證規則在任何地方運行都不會出錯，這點很(hěn)關鍵。

在定義内置動作(zuò)時需要注意，如果我們規則運行方式采用(yòng)的是客戶端服務(wù)器模式（參見第16小(xiǎo)節内容介紹），那麽必須要保證調用(yòng)知識包的客戶端Spring環境裏有(yǒu)這個Bean，且Bean的Id要與動作(zuò)庫定義時的Id保證一至，否則調用(yòng)會出現錯誤。