📖 English Documentation | 📖 中文文档
Aviator是一个轻量级、高性能的Java表达式执行引擎，它动态地将表达式编译成字节码并运行。
- 支持绝大多数运算操作符，包括算术操作符、关系运算符、逻辑操作符、位运算符、正则匹配操作符（
=~）、三元表达式（?:）。 - 支持操作符优先级和括号强制设定优先级。
- 支持赋值。
- 逻辑运算符支持短路运算。
- 支持丰富类型，例如
nil、整数和浮点数、字符串、正则表达式、日期、变量等，支持自动类型转换和提升。 - 支持
lambda匿名函数和闭包。 - 内置一套强大的常用函数库。
- 可自定义函数，易于扩展，支持函数调用点参数列表捕获和 Java 方法批量导入。
- 可重载运算符。
- 支持大数运算（
BigInteger）和高精度运算（BigDecimal）。 - 支持多行表达式以及定制化求值器实例。
- 小巧并性能优秀，提供大量的定制选项。
- Function missing 机制，类似 Ruby 的 method missing。
更多详情，请访问主页。
- 4.2.9, Some bug fixes(#184, #186) and supports list/array elements assignment.
- 4.2.8, Fixed #181 and wraps function returned value to ensure it's not null (replaced by AviatorNil).
- 4.2.7, Fixed parser bug #177
<dependency>
<groupId>com.googlecode.aviator</groupId>
<artifactId>aviator</artifactId>
<version>{version}</version>
</dependency>可以在 search.maven.org 查看可用的版本。
int[] a = ...;
Map<String, Object> env = new HashMap<String, Object>();
env.put("a", a);
AviatorEvaluator.execute("1 + 2 + 3");
AviatorEvaluator.execute("a[1] + 100", env);
AviatorEvaluator.execute("'a[1]=' + a[1]", env);
// 求数组长度
AviatorEvaluator.execute("count(a)", env);
// 求数组总和
AviatorEvaluator.execute("reduce(a, +, 0)", env);
// 检测数组每个元素都在 0 <= e < 10 之间
AviatorEvaluator.execute("seq.every(a, seq.and(seq.ge(0), seq.lt(10)))", env);
// Lambda 求和
AviatorEvaluator.execute("reduce(a, lambda(x,y) -> x + y end, 0)", env);
// 导入 String 类实例方法作为自定义函数
AviatorEvaluator.addInstanceFunctions("s", String.class);
AviatorEvaluator.execute("s.indexOf('hello', 'l')");
AviatorEvaluator.execute("s.replaceAll('hello', 'l', 'x')");
// 导入静态方法作为自定义函数
AviatorEvaluator.addStaticFunctions("sutil", StringUtils.class);
AviatorEvaluator.execute("sutil.isBlank('hello')");
// 启用基于反射的 function missing 机制，调用任意 public 实例方法，无需导入
AviatorEvaluator.setFunctionMissing(JavaMethodReflectionFunctionMissing.getInstance());
// 调用 String#indexOf
System.out.println(AviatorEvaluator.execute("indexOf('hello world', 'w')"));
// 调用 Long#floatValue
System.out.println(AviatorEvaluator.execute("floatValue(3)"));
// 调用 BigDecimal#add
System.out.println(AviatorEvaluator.execute("add(3M, 4M)"));更详细的请阅读用户指南。
- downloads: https://github.com/killme2008/aviator/releases
- documents: https://github.com/killme2008/aviator/wiki
- javadoc: http://fnil.net/aviator/apidocs/
- author: dennis (killme2008@gmail.com)
- spring boot: https://github.com/mengxiangrui007/spring-boot-rule-jsr94