12.内置动作定义

12.内置动作定义

概述

在之前的内容当中我们了解到，如果要在决策集、决策表、交叉决策表、决策树、评分卡、复杂评分卡或决策流中使用某个Spring Bean中定义的方法，那么可以使用动作库将目标Bean及相应的方法定义到其中，然后在具体的决策集、决策表、交叉决策表、决策树、评分卡、复杂评分卡或决策流中导入这个动作库就可以使用了，这种类型方法调用，需要我们的显式的将目标动作库导入后方可使用。

在URule Pro中还提供了一种不需要导入动作库就可以调用类方法的方式，我们称之为内置的动作，对于这些内置的动作，按规范要求定义好后，用户无需导入就可以直接在所有规则文件中使用。

对于内置动作的使用与用户自定义的动作库完全相同，不同地方在于内置动作不需要用户定义，也不需要用户导入，在任何一个决策集、决策表、交叉决策表、决策树、评分卡、复杂评分卡或决策流中可以直接使用，如下图所示：

如上图所示，URule Pro中目前默认提供的内置动作有七个，分别用于获取当前规则以及针对日期、字符串、常用数学函数、List集合、Map集合以及循环操作的计算。

• 当前规则的内置动作

  该内置动作只能在规则的那么部分使用，不能在规则的条件中使用，否则会产生错误。 该内置动作在2.1.9及以上版本中提供	方法名	描述
  当前规则对象	返回当前规则对象Rule
  当前规则名	返回当前规则的字符串类型的规则名称
  当前规则匹配的条件	返回当前规则在匹配时所经历的条件节点对象集合，返回的是一个Set集合对象，里面是若干个Criteria对象

• 日期的内置动作

• 字符串的内置动作

• 常用数学函数的内置动作

• List集合的内置动作

• Map集合的内置动作

• 循环操作的内置动作

循环操作的动作就一个，那就是中断循环，该动作只能用在循环规则里，用于在一定条件下中断当前的循环规则。

自定义内置动作

在用户使用过程当中，如果有一些自己内部常用的操作，而这些操作在URule Pro中的内置动作中又没有，那么可以利用自定义内置动作的方式定义自己的内置动作。

定义内置动作非常简单，只需要在需要暴露给用户使用的Spring bean中添加相应的annotation即可。我们先来看看URule Pro中提供的针对字符串的内置动作类的部分源代码。

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);
    }
    ......
}

可以看到，首先我们需要在”类“层面添加一个名为ActionBean的annotation，它只有一个属性，就是要定义这个内置动作的名称。然后在需要暴露的方法中添加两个annotation，分别是ActionMethod和ActionMethodParameter。ActionMethod是用来定义用户看到的方法名称的，而ActionMethodParameter则是用来定义用户看到的各个参数名称，它的names属性是一个数组，要求给出的描述参数要与当前方法的参数个数匹配，如果小于参数个数，那么用户将会看到后面的参数无描述信息。

在类中定义好这些Annotation之后，将这个类配置到Spring当中，让其成为一个标准的Spring Bean，并为其定义一个Bean Id，这样URule在启动时就会自动加载，并让其成为内置动作，用户就可以直接使用了。

定义内置动作的Spring Bean时，一定不要忘记给这个Spring Bean定义一个Id，这样才能保证规则在任何地方运行都不会出错，这点很关键。

在定义内置动作时需要注意，如果我们规则运行方式采用的是客户端服务器模式（参见第16小节内容介绍），那么必须要保证调用知识包的客户端Spring环境里有这个Bean，且Bean的Id要与动作库定义时的Id保证一至，否则调用会出现错误。