com.ql.util.express

类 ExpressRunner

java.lang.Object

com.ql.util.express.ExpressRunner

public class ExpressRunner
extends Object

语法分析和计算的入口类

作者:

xuannan

构造器概要

构造器

构造器和说明
ExpressRunner()
ExpressRunner(boolean aIsPrecise, boolean aIstrace)
ExpressRunner(boolean aIsPrecise, boolean aIstrace, IExpressResourceLoader aExpressResourceLoader, NodeTypeManager aManager)
ExpressRunner(boolean aIsPrecise, boolean aIstrace, NodeTypeManager aManager)

方法概要

方法

限定符和类型	方法和说明
void	addClassField(String field, Class<?> bindingClass, Class<?> returnType, Operator op) 添加类的方法
void	addClassField(String field, Class<?> bindingClass, Operator op) 添加类的方法
void	addClassMethod(String name, Class<?> bindingClass, OperatorBase op) 添加类的方法
void	addFunction(String name, OperatorBase op) 添加函数定义
void	addFunctionAndClassMethod(String name, Class<?> bindingClass, OperatorBase op) 添加函数定义扩展类的方法
void	addFunctionOfClassMethod(String name, String aClassName, String aFunctionName, Class<?>[] aParameterClassTypes, String errorInfo) 添加一个类的函数定义，例如：Math.abs(double) 映射为表达式中的 "取绝对值(-5.0)"
void	addFunctionOfClassMethod(String name, String aClassName, String aFunctionName, Class<?>[] aParameterClassTypes, String[] aParameterDesc, String[] aParameterAnnotation, String errorInfo) 添加一个类的函数定义，例如：Math.abs(double) 映射为表达式中的 "取绝对值(-5.0)"
void	addFunctionOfClassMethod(String name, String aClassName, String aFunctionName, String[] aParameterTypes, String errorInfo) 添加一个类的函数定义，例如：Math.abs(double) 映射为表达式中的 "取绝对值(-5.0)"
void	addFunctionOfClassMethod(String name, String aClassName, String aFunctionName, String[] aParameterTypes, String[] aParameterDesc, String[] aParameterAnnotation, String errorInfo) 添加一个类的函数定义，例如：Math.abs(double) 映射为表达式中的 "取绝对值(-5.0)"
void	addFunctionOfServiceMethod(String name, Object aServiceObject, String aFunctionName, Class<?>[] aParameterClassTypes, String errorInfo) 用于将一个用户自己定义的对象(例如Spring对象)方法转换为一个表达式计算的函数
void	addFunctionOfServiceMethod(String name, Object aServiceObject, String aFunctionName, Class<?>[] aParameterClassTypes, String[] aParameterDesc, String[] aParameterAnnotation, String errorInfo) 用于将一个用户自己定义的对象(例如Spring对象)方法转换为一个表达式计算的函数
void	addFunctionOfServiceMethod(String name, Object aServiceObject, String aFunctionName, String[] aParameterTypes, String errorInfo) 用于将一个用户自己定义的对象(例如Spring对象)方法转换为一个表达式计算的函数
void	addFunctionOfServiceMethod(String name, Object aServiceObject, String aFunctionName, String[] aParameterTypes, String[] aParameterDesc, String[] aParameterAnnotation, String errorInfo)
void	addMacro(String macroName, String express) 添加宏定义 例如： macro 玄难 { abc(userinfo.userId);}
void	addOperator(String name, Operator op) 添加操作符号，此操作符号的优先级与 "*"相同，语法形式也是 data name data
void	addOperator(String name, String aRefOpername, Operator op) 添加操作符号，此操作符号与给定的参照操作符号在优先级别和语法形式上一致
void	addOperatorWithAlias(String keyWordName, String realKeyWordName, String errorInfo) 添加操作符和关键字的别名，同时对操作符可以指定错误信息。
void	addSystemFunctions()
void	clearExpressCache() 清除缓存
void	createInstructionSet(ExpressNode root, InstructionSet result)
InstructionSet	createInstructionSet(ExpressNode root, String type)
boolean	createInstructionSetPrivate(InstructionSet result, Stack<ForRelBreakContinue> forStack, ExpressNode node, boolean isRoot)
Object	execute(InstructionSet[] instructionSets, IExpressContext<String,Object> context, List<String> errorList, boolean isTrace, boolean isCatchException, org.apache.commons.logging.Log aLog) 已过时。
Object	execute(InstructionSet instructionSets, IExpressContext<String,Object> context, List<String> errorList, boolean isTrace, boolean isCatchException, org.apache.commons.logging.Log aLog) 执行指令集
Object	execute(String expressString, IExpressContext<String,Object> context, List<String> errorList, boolean isCache, boolean isTrace) 执行一段文本
Object	execute(String expressString, IExpressContext<String,Object> context, List<String> errorList, boolean isCache, boolean isTrace, org.apache.commons.logging.Log aLog) 执行一段文本
Object	executeByExpressName(String name, IExpressContext<String,Object> context, List<String> errorList, boolean isTrace, boolean isCatchException, org.apache.commons.logging.Log aLog) 根据表达式的名称进行执行
RuleResult	executeRule(String expressString, IExpressContext<String,Object> context, boolean isCache, boolean isTrace)
AppendingClassFieldManager	getAppendingClassFieldManager()
AppendingClassMethodManager	getAppendingClassMethodManager()
ExportItem[]	getExportInfo() 输出全局定义信息
IExpressResourceLoader	getExpressResourceLoader()
OperatorBase	getFunciton(String name) 获取函数定义，通过函数定义可以拿到参数的说明信息
InstructionSet	getInstructionSetFromLocalCache(String expressString) 优先从本地指令集缓存获取指令集，没有的话生成并且缓存在本地
NodeTypeManager	getNodeTypeManager() 获取语法定义的管理器
IOperateDataCache	getOperateDataCache()
OperatorFactory	getOperatorFactory() 获取操作符号管理器
String[]	getOutFunctionNames(String express)
String[]	getOutVarNames(String express) 获取一个表达式需要的外部变量名称列表
ExpressPackage	getRootExpressPackage()
boolean	isShortCircuit()
void	loadExpress(String expressName) 装载文件中定义的Express
void	loadMutilExpress(String groupName, String express) 装载表达式，但不执行，例如一些宏定义，或者自定义函数
Condition	parseContition(String text)
InstructionSet	parseInstructionSet(String text) 解析一段文本，生成指令集合
Rule	parseRule(String text)
OperatorBase	replaceOperator(String name, OperatorBase op) 替换操作符处理
void	setShortCircuit(boolean isShortCircuit)

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

ExpressRunner

public ExpressRunner()

ExpressRunner

public ExpressRunner(boolean aIsPrecise,
             boolean aIstrace)

参数:

aIsPrecise - 是否需要高精度计算支持

aIstrace - 是否跟踪执行指令的过程

ExpressRunner

public ExpressRunner(boolean aIsPrecise,
             boolean aIstrace,
             NodeTypeManager aManager)

ExpressRunner

public ExpressRunner(boolean aIsPrecise,
             boolean aIstrace,
             IExpressResourceLoader aExpressResourceLoader,
             NodeTypeManager aManager)

参数:

aIsPrecise - 是否需要高精度计算支持

aIstrace - 是否跟踪执行指令的过程

aExpressResourceLoader - 表达式的资源装载器

方法详细资料

getAppendingClassMethodManager

public AppendingClassMethodManager getAppendingClassMethodManager()

getAppendingClassFieldManager

public AppendingClassFieldManager getAppendingClassFieldManager()

getOperateDataCache

public IOperateDataCache getOperateDataCache()

addSystemFunctions

public void addSystemFunctions()

getNodeTypeManager

public NodeTypeManager getNodeTypeManager()

获取语法定义的管理器

返回:

getOperatorFactory

public OperatorFactory getOperatorFactory()

获取操作符号管理器

返回:

getExpressResourceLoader

public IExpressResourceLoader getExpressResourceLoader()

addMacro

public void addMacro(String macroName,
            String express)
              throws Exception

添加宏定义 例如： macro 玄难 { abc(userinfo.userId);}

参数:

macroName：玄难 -

express - ：abc(userinfo.userId);

抛出:

Exception

loadMutilExpress

public void loadMutilExpress(String groupName,
                    String express)
                      throws Exception

装载表达式，但不执行，例如一些宏定义，或者自定义函数

参数:

groupName -

express -

抛出:

Exception

loadExpress

public void loadExpress(String expressName)
                 throws Exception

装载文件中定义的Express

参数:

expressName -

抛出:

Exception

addFunction

public void addFunction(String name,
               OperatorBase op)

添加函数定义

参数:

name - 函数名称

op - 对应的操作实现类

addFunctionAndClassMethod

public void addFunctionAndClassMethod(String name,
                             Class<?> bindingClass,
                             OperatorBase op)

添加函数定义扩展类的方法

参数:

name -

bindingClass -

op -

addClassField

public void addClassField(String field,
                 Class<?> bindingClass,
                 Operator op)

添加类的方法

参数:

field -

bindingClass -

op -

addClassField

public void addClassField(String field,
                 Class<?> bindingClass,
                 Class<?> returnType,
                 Operator op)

添加类的方法

参数:

field -

bindingClass -

returnType -

op -

addClassMethod

public void addClassMethod(String name,
                  Class<?> bindingClass,
                  OperatorBase op)

添加类的方法

参数:

name -

bindingClass -

op -

getFunciton

public OperatorBase getFunciton(String name)

获取函数定义，通过函数定义可以拿到参数的说明信息

参数:

name - 函数名称

返回:

addFunctionOfClassMethod

public void addFunctionOfClassMethod(String name,
                            String aClassName,
                            String aFunctionName,
                            Class<?>[] aParameterClassTypes,
                            String errorInfo)
                              throws Exception

添加一个类的函数定义，例如：Math.abs(double) 映射为表达式中的 "取绝对值(-5.0)"

参数:

name - 函数名称

aClassName - 类名称

aFunctionName - 类中的方法名称

aParameterClassTypes - 方法的参数类型名称

errorInfo - 如果函数执行的结果是false，需要输出的错误信息

抛出:

Exception

addFunctionOfClassMethod

public void addFunctionOfClassMethod(String name,
                            String aClassName,
                            String aFunctionName,
                            Class<?>[] aParameterClassTypes,
                            String[] aParameterDesc,
                            String[] aParameterAnnotation,
                            String errorInfo)
                              throws Exception

添加一个类的函数定义，例如：Math.abs(double) 映射为表达式中的 "取绝对值(-5.0)"

参数:

name - 函数名称

aClassName - 类名称

aFunctionName - 类中的方法名称

aParameterClassTypes - 方法的参数类型名称

aParameterDesc - 方法的参数说明

aParameterAnnotation - 方法的参数注解

errorInfo - 如果函数执行的结果是false，需要输出的错误信息

抛出:

Exception

addFunctionOfClassMethod

public void addFunctionOfClassMethod(String name,
                            String aClassName,
                            String aFunctionName,
                            String[] aParameterTypes,
                            String errorInfo)
                              throws Exception

添加一个类的函数定义，例如：Math.abs(double) 映射为表达式中的 "取绝对值(-5.0)"

参数:

name - 函数名称

aClassName - 类名称

aFunctionName - 类中的方法名称

aParameterTypes - 方法的参数类型名称

errorInfo - 如果函数执行的结果是false，需要输出的错误信息

抛出:

Exception

addFunctionOfClassMethod

public void addFunctionOfClassMethod(String name,
                            String aClassName,
                            String aFunctionName,
                            String[] aParameterTypes,
                            String[] aParameterDesc,
                            String[] aParameterAnnotation,
                            String errorInfo)
                              throws Exception

添加一个类的函数定义，例如：Math.abs(double) 映射为表达式中的 "取绝对值(-5.0)"

参数:

name - 函数名称

aClassName - 类名称

aFunctionName - 类中的方法名称

aParameterTypes - 方法的参数类型名称

aParameterDesc - 方法的参数说明

aParameterAnnotation - 方法的参数注解

errorInfo - 如果函数执行的结果是false，需要输出的错误信息

抛出:

Exception

addFunctionOfServiceMethod

public void addFunctionOfServiceMethod(String name,
                              Object aServiceObject,
                              String aFunctionName,
                              Class<?>[] aParameterClassTypes,
                              String errorInfo)
                                throws Exception

用于将一个用户自己定义的对象(例如Spring对象)方法转换为一个表达式计算的函数

参数:

name -

aServiceObject -

aFunctionName -

aParameterClassTypes -

errorInfo -

抛出:

Exception

addFunctionOfServiceMethod

public void addFunctionOfServiceMethod(String name,
                              Object aServiceObject,
                              String aFunctionName,
                              Class<?>[] aParameterClassTypes,
                              String[] aParameterDesc,
                              String[] aParameterAnnotation,
                              String errorInfo)
                                throws Exception

用于将一个用户自己定义的对象(例如Spring对象)方法转换为一个表达式计算的函数

参数:

name -

aServiceObject -

aFunctionName -

aParameterClassTypes -

aParameterDesc - 方法的参数说明

aParameterAnnotation - 方法的参数注解

errorInfo -

抛出:

Exception

addFunctionOfServiceMethod

public void addFunctionOfServiceMethod(String name,
                              Object aServiceObject,
                              String aFunctionName,
                              String[] aParameterTypes,
                              String errorInfo)
                                throws Exception

用于将一个用户自己定义的对象(例如Spring对象)方法转换为一个表达式计算的函数

参数:

name -

aServiceObject -

aFunctionName -

aParameterTypes -

errorInfo -

抛出:

Exception

addFunctionOfServiceMethod

public void addFunctionOfServiceMethod(String name,
                              Object aServiceObject,
                              String aFunctionName,
                              String[] aParameterTypes,
                              String[] aParameterDesc,
                              String[] aParameterAnnotation,
                              String errorInfo)
                                throws Exception

抛出:

Exception

addOperator

public void addOperator(String name,
               Operator op)
                 throws Exception

添加操作符号，此操作符号的优先级与 "*"相同，语法形式也是 data name data

参数:

name -

op -

抛出:

Exception

addOperator

public void addOperator(String name,
               String aRefOpername,
               Operator op)
                 throws Exception

添加操作符号，此操作符号与给定的参照操作符号在优先级别和语法形式上一致

参数:

name - 操作符号名称

aRefOpername - 参照的操作符号，例如 "+","--"等

op -

抛出:

Exception

addOperatorWithAlias

public void addOperatorWithAlias(String keyWordName,
                        String realKeyWordName,
                        String errorInfo)
                          throws Exception

添加操作符和关键字的别名，同时对操作符可以指定错误信息。 例如：addOperatorWithAlias("加","+",null)

参数:

keyWordName -

realKeyWordName -

errorInfo -

抛出:

Exception

replaceOperator

public OperatorBase replaceOperator(String name,
                           OperatorBase op)

替换操作符处理

参数:

name -

getRootExpressPackage

public ExpressPackage getRootExpressPackage()

clearExpressCache

public void clearExpressCache()

清除缓存

executeByExpressName

public Object executeByExpressName(String name,
                          IExpressContext<String,Object> context,
                          List<String> errorList,
                          boolean isTrace,
                          boolean isCatchException,
                          org.apache.commons.logging.Log aLog)
                            throws Exception

根据表达式的名称进行执行

参数:

name -

context -

errorList -

isTrace -

isCatchException -

aLog -

返回:

抛出:

Exception

execute

@Deprecated
public Object execute(InstructionSet[] instructionSets,
                        IExpressContext<String,Object> context,
                        List<String> errorList,
                        boolean isTrace,
                        boolean isCatchException,
                        org.apache.commons.logging.Log aLog)
               throws Exception

已过时。

执行指令集(兼容老接口,请不要自己管理指令缓存，直接使用execute(InstructionSet instructionSets,....... ) 清理缓存可以使用clearExpressCache()函数

参数:

instructionSets -

context -

errorList -

isTrace -

isCatchException -

aLog -

返回:

抛出:

Exception

execute

public Object execute(InstructionSet instructionSets,
             IExpressContext<String,Object> context,
             List<String> errorList,
             boolean isTrace,
             boolean isCatchException,
             org.apache.commons.logging.Log aLog)
               throws Exception

执行指令集

参数:

instructionSets -

context -

errorList -

isTrace -

isCatchException -

aLog -

返回:

抛出:

Exception

execute

public Object execute(String expressString,
             IExpressContext<String,Object> context,
             List<String> errorList,
             boolean isCache,
             boolean isTrace)
               throws Exception

执行一段文本

参数:

expressString - 程序文本

context - 执行上下文

errorList - 输出的错误信息List

isCache - 是否使用Cache中的指令集

isTrace - 是否输出详细的执行指令信息

返回:

抛出:

Exception

execute

public Object execute(String expressString,
             IExpressContext<String,Object> context,
             List<String> errorList,
             boolean isCache,
             boolean isTrace,
             org.apache.commons.logging.Log aLog)
               throws Exception

执行一段文本

参数:

expressString - 程序文本

context - 执行上下文

errorList - 输出的错误信息List

isCache - 是否使用Cache中的指令集

isTrace - 是否输出详细的执行指令信息

aLog - 输出的log

返回:

抛出:

Exception

executeRule

public RuleResult executeRule(String expressString,
                     IExpressContext<String,Object> context,
                     boolean isCache,
                     boolean isTrace)
                       throws Exception

抛出:

Exception

parseRule

public Rule parseRule(String text)
               throws Exception

抛出:

Exception

parseContition

public Condition parseContition(String text)
                         throws Exception

抛出:

Exception

parseInstructionSet

public InstructionSet parseInstructionSet(String text)
                                   throws Exception

解析一段文本，生成指令集合

参数:

text -

返回:

抛出:

Exception

getExportInfo

public ExportItem[] getExportInfo()

输出全局定义信息

返回:

getInstructionSetFromLocalCache

public InstructionSet getInstructionSetFromLocalCache(String expressString)
                                               throws Exception

优先从本地指令集缓存获取指令集，没有的话生成并且缓存在本地

参数:

expressString -

返回:

抛出:

Exception

createInstructionSet

public InstructionSet createInstructionSet(ExpressNode root,
                                  String type)
                                    throws Exception

抛出:

Exception

createInstructionSet

public void createInstructionSet(ExpressNode root,
                        InstructionSet result)
                          throws Exception

抛出:

Exception

createInstructionSetPrivate

public boolean createInstructionSetPrivate(InstructionSet result,
                                  Stack<ForRelBreakContinue> forStack,
                                  ExpressNode node,
                                  boolean isRoot)
                                    throws Exception

抛出:

Exception

getOutVarNames

public String[] getOutVarNames(String express)
                        throws Exception

获取一个表达式需要的外部变量名称列表

参数:

express -

返回:

抛出:

Exception

getOutFunctionNames

public String[] getOutFunctionNames(String express)
                             throws Exception

抛出:

Exception

isShortCircuit

public boolean isShortCircuit()

setShortCircuit

public void setShortCircuit(boolean isShortCircuit)