com.moon.runner.Runner Maven / Gradle / Ivy
package com.moon.runner;
/**
* @param 期望的返回值类型，仅为了方便返回值类型推导，不对解析和执行表达式产生实际影响
*
* @author moonsky
*/
@FunctionalInterface
public interface Runner {
/**
* 如果表达式是含有参数的，用指定参数运行
*
* 如果表达式中含有 data 中不包含的变量名，将抛出异常
*
* @param data
*
* @return
*/
T run(Object data);
/**
* 如果表达式不包含参数，运行无参表达式
*
* @return
*/
default T run() { return run(null); }
/**
* 如果需要使用多个参数，用指定的多参数列表运行解析的表达式
*
* 参数列表优先级——相同键名，后面的值将覆盖前面的值——用一个例子说明：
*
* 如果参数列表是两个都包含 name 键的 Map，得到的是后面 Map 的值
*
* Map map1 = new HashMap();
*
* map1.put("name", 1);
*
* Map map2 = new HashMap();
*
* map2.put("name", 2);
*
* Runner runner = RunnerUtil.parse("name");
*
* runner.runMulti(map1, map2); // 2
*
* @param data
*
* @return
*/
default T runMulti(Object... data) { return run(new RunnerDataMap(data)); }
}