根据官网的介绍,aviator 支持的主要特性:
-
支持数字、字符串、正则表达式、布尔值、正则表达式等基本类型,完整支持所有 Java 运算符及优先级等。
-
函数是一等公民,支持闭包和函数式编程
-
内置 bigint/decimal 类型用于大整数和高精度运算,支持运算符重载得以让这些类型使用普通的算术运算符 +-*/ 参与运算。
-
完整的脚本语法支持,包括多行数据、条件语句、循环语句、词法作用域和异常处理等。
-
函数式编程结合 Sequence 抽象,便捷处理任何集合。
-
轻量化的模块系统。
-
多种方式,方便地调用 Java 方法,完整支持 Java 脚本 API(方便从 Java 调用脚本)。
-
丰富的定制选项,可作为安全的语言沙箱和全功能语言使用。
-
轻量化,高性能,ASM 模式下通过直接将脚本翻译成 JVM 字节码,解释模式可运行于 Android 等非标 Java 平台。
使用场景包括:
-
规则判断及规则引擎
-
公式计算
-
动态脚本控制
-
集合数据 ELT 等
aviator 基本使用
基本表达式
要使用 aviator,只需要添加相应依赖:
<dependency>
<groupId>com.googlecode.aviatorgroupId>
<artifactId>aviatorartifactId>
<version>5.3.3version>
dependency>
然后就可以进行表达式求值了:
Long r = (Long) AviatorEvaluator.execute("2 * (3 + 5)");
为了提升性能,往往先编译表达式,然后可以反复执行,进行表达式求值:
Expression expression = AviatorEvaluator.compile("2 * (3 + 5)");
Long r = (Long) expression.execute();
aviator 支持数字、字符串、布尔值等基本数据类型,数字类型值都当作 long 或 double 类型处理。
aviator 表达式支持大部分的运算操作符,如常用的算术运算操作符 (+、-、*、/、%)、逻辑运算操作符(&&、||、!)、比较运算操作符(>、>=、==、!=、>)和优先级操作符,还支持三元操作表达 (?:)、正则表达式 (=~)。
一些例子:
String r = (String) AviatorEvaluator.execute("'hello' + ' world'");
Boolean r = (Boolean) AviatorEvaluator.execute("100 > 80 && 30 < 40");
Long r = (Long) AviatorEvaluator.execute("100 > 80 ? 30 : 40");
Boolean r = (Boolean) AviatorEvaluator.execute("'hello' =~ /[\\w]+/");
表达式变量
跟其他表达式引擎一样,aviator 也是支持表达式求值时传入参数的:
Long a = 12L;
Boolean r = (Boolean) AviatorEvaluator.exec("a > 10", a);
参数也可以是一个列表,如下:
List a = new ArrayList<>();
a.add(12L);
a.add(20L);
Boolean r = (Boolean) AviatorEvaluator.exec("a[0] > 10", a);
也可以是一个对象:
public static class Person {
private String name;
private Integer age;
}
Person a = new Person("movee", 25);
Boolean r = (Boolean) AviatorEvaluator.exec("a.age > 10", a);
更一般地,aviator 会将参数放到一个 map 中:
Map<String, Object> env = new HashMap<>();
env.put("person", new Person("movee", 25));
env.put("a", 20L);
Object result = AviatorEvaluator.execute("person.name", env);
这样一来,aviator 可以非常方便的从 json 字符串中提取子 json 字符串:
String jsonStr = """
{
"a": {
"b": [
{
"x": 3
},
{
"x": 4
}
]
}
}
""";
JSONObject jsonObj = new JSONObject(jsonStr);
// 结果返回 3
Object value = AviatorEvaluator.execute("a.b[0]['x']", jsonObj.toMap());
使用函数
aviator 已经提供了很多开箱即用的函数了:
Long r = (Long) AviatorEvaluator.execute("math.round(4.3)");
Long r = (Long) AviatorEvaluator.execute("string.length('hello')");
Object r = AviatorEvaluator.execute("seq.list(1,2,3)");
更详细的内置函数列表请参考:aviator 函数库列表
我们也可以自定义一个 java 函数,自己编写一个类,继承 aviator 的 AbstractFunction 类,然后实现相应的方法即可:
public class AddFunction extends AbstractFunction {
@Override
public AviatorObject call(Map env, AviatorObject arg1, AviatorObject arg2)