AviatorScript轻量级Java表达式解析工具

偏执的太偏执、 2022-10-05 06:59 352阅读 0赞

github:[https://github.com/killme2008/aviatorscript][https_github.com_killme2008_aviatorscript]

教程：[https://www.yuque.com/boyan-avfmj/aviatorscript][https_www.yuque.com_boyan-avfmj_aviatorscript]

`viatorScript` 是一门高性能、轻量级寄宿于 JVM 之上的脚本语言。

# 特性介绍 #

1.  支持数字、字符串、正则表达式、布尔值、正则表达式、三元表达式等[基本类型][Link 1]，完整支持所有 Java 运算符及优先级等。
2.  [函数][Link 2]是一等公民，支持[闭包和函数式编程][Link 3]。
3.  内置 [bigint][]/[decmal][] 类型用于大整数和高精度运算，支持[运算符重载][Link 4]得以让这些类型使用普通的算术运算符 `+-*/`参与运算。
4.  完整的脚本语法支持，包括多行数据、条件语句、循环语句、词法作用域和异常处理等。
5.  [函数式编程][Link 3]结合 [Sequence 抽象][Sequence]，便捷处理任何集合。
6.  轻量化的[模块系统][Link 5]。
7.  多种方式，方便地[调用 Java 方法][Java]，完整支持 Java [脚本 API][API]（方便从 Java 调用脚本）。
8.  丰富的定制选项，可作为安全的语言沙箱和全功能语言使用。
9.  轻量化，高性能，通过直接将脚本翻译成 JVM 字节码，AviatorScript 的基础性能较好。

使用场景包括：

1.  规则判断及规则引擎
2.  公式计算
3.  动态脚本控制
4.  集合数据 ELT 等 ……

#  #

# News #

*  [5.2.5][]，调用 java 方法数值装箱类型自动转换、修复 bug 等。
 *  [5.2.4][]，unpacking arguments（类 python 语法）、使用 `fn` 定义匿名函数和改进 for 语句支持索引、KV 键值等。
 *  [5.2.3][]，移除 commons-beantuils、性能优化和修复 `AviatorString#toString` 打印警告日志等。

#  #

# Dependency #

<dependency>
      <groupId>com.googlecode.aviator</groupId>
      <artifactId>aviator</artifactId>
      <version>{version}</version>
    </dependency>

可以在 [search.maven.org][] 查看可用的版本。

# 快速开始 #

1.  下载 [aviator][] shell 到某个目录（最好是在系统的 `PATH` 环境变量内），比如 `~/bin/aviator`:

$ wget https://raw.githubusercontent.com/killme2008/aviator/master/bin/aviator
    $ chmod u+x aviator

1.  执行 `aviator` 命令，将自动下载最新文档版本 aviator jar 到 `~/.aviatorscript` 下的安装目录并运行：

$ aviator
    Downloading AviatorScript now...
      % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                     Dload  Upload   Total   Spent    Left  Speed
    100   153  100   153    0     0    111      0  0:00:01  0:00:01 --:--:--   111
    100 1373k  100 1373k    0     0   689k      0  0:00:01  0:00:01 --:--:--  689k
    Usage: java com.googlecode.aviator.Main [file] [args]
         : java com.googlecode.aviator.Main -e [script]
         : java com.googlecode.aviator.Main -v

1.  将下面这个脚本保存为文件 `hello.av`:

p("Hello, AviatorScript!");
    
    let a = tuple(1, 2, 3, 4, 5);
    
    p("sum of a is: " + reduce(a, +, 0));
    
    let date = new java.util.Date();
    p("The year is: "+ getYear(date));
    p("The month is: #{getMonth(date)}");

1.  执行脚本：

$ aviator hello.av
    Hello, AviatorScript!
    sum of a is: 15
    The year is: 120
    The month is: 3

示例：

public static void main(String[] args) {
            Map<String,Object> params = new HashMap<>();
           // params.put("T",null);
            params.put("P",new BigDecimal(20));
            params.put("L",100);
            params.put("W",500);
            params.put("Q",3);
            // P*L*W*Q  可以写作 T=P*L*W*Q
            Expression compiledExp = AviatorEvaluator.compile("T=P*L*W*Q");
            BigDecimal totalPrice = (BigDecimal) compiledExp.execute(params);
            System.out.println("totalPrice : "+totalPrice);
        }

更详细的请阅读[用户指南][Link 6]。

# 三元表达式 #

public static void main(String[] args) {
    
            String expression = "W*L<0.1?0.1*329*P:W*L*329*P";
            Map<String,Object>  params = new ConcurrentHashMap<>();
            params.put("W",new BigDecimal(0.1));
            params.put("L",new BigDecimal(0.5));
            params.put("P",new BigDecimal(1));
    
            BigDecimal finalPrice= BigDecimal.ZERO;
    
            Expression compiledExp = AviatorEvaluator.compile(expression);
    
            try {
                finalPrice = (BigDecimal) compiledExp.execute(params);
            } catch (ClassCastException e) {
               if(compiledExp.execute(params) instanceof  Double
                       || compiledExp.execute(params) instanceof  Float
                       || compiledExp.execute(params) instanceof  Integer){
                   Double doubleVal = (Double)compiledExp.execute(params);
                   finalPrice = new BigDecimal(doubleVal);
               }
            }catch (Exception e) {
                e.printStackTrace();
                finalPrice =BigDecimal.ZERO;
            }
            finalPrice = finalPrice.setScale(2,BigDecimal.ROUND_HALF_UP);
    
            System.out.println("finalPrice:"+finalPrice);
    
            String result5=(String)AviatorEvaluator.execute("3>0? 'yes':'no'");
            System.out.println(result5);
        }

# Links #

*  Releases: [https://github.com/killme2008/aviator/releases][https_github.com_killme2008_aviator_releases]
 *  Documents: [https://www.yuque.com/boyan-avfmj/aviatorscript][https_www.yuque.com_boyan-avfmj_aviatorscript]
 *  Changelog: [https://www.yuque.com/boyan-avfmj/aviatorscript/bggwx2][https_www.yuque.com_boyan-avfmj_aviatorscript_bggwx2]
 *  Javadoc: [http://fnil.net/aviator/apidocs/][http_fnil.net_aviator_apidocs]
 *  Spring boot rule: [https://github.com/mengxiangrui007/spring-boot-rule-jsr94][https_github.com_mengxiangrui007_spring-boot-rule-jsr94]
 *  Idea plugin: [https://github.com/yanchangyou/aviatorscript-ideaplugin][https_github.com_yanchangyou_aviatorscript-ideaplugin]

[https_github.com_killme2008_aviatorscript]: https://github.com/killme2008/aviatorscript
[https_www.yuque.com_boyan-avfmj_aviatorscript]: https://www.yuque.com/boyan-avfmj/aviatorscript
[Link 1]: https://www.yuque.com/boyan-avfmj/aviatorscript/lvabnw
[Link 2]: https://www.yuque.com/boyan-avfmj/aviatorscript/gl2p0q
[Link 3]: https://www.yuque.com/boyan-avfmj/aviatorscript/ksghfc
[bigint]: https://www.yuque.com/boyan-avfmj/aviatorscript/lvabnw#a0Ifn
[decmal]: https://www.yuque.com/boyan-avfmj/aviatorscript/lvabnw#QbV7z
[Link 4]: https://www.yuque.com/boyan-avfmj/aviatorscript/ydllav#5hq4k
[Sequence]: https://www.yuque.com/boyan-avfmj/aviatorscript/yc4l93
[Link 5]: https://www.yuque.com/boyan-avfmj/aviatorscript/rqra81
[Java]: https://www.yuque.com/boyan-avfmj/aviatorscript/xbdgg2
[API]: https://www.yuque.com/boyan-avfmj/aviatorscript/bds23b
[5.2.5]: https://github.com/killme2008/aviator/releases/tag/aviator-5.2.5
[5.2.4]: https://github.com/killme2008/aviator/releases/tag/aviator-5.2.4
[5.2.3]: https://github.com/killme2008/aviator/releases/tag/aviator-5.2.3
[search.maven.org]: https://search.maven.org/search?q=g:com.googlecode.aviator%20AND%20a:aviator&core=gav
[aviator]: https://raw.githubusercontent.com/killme2008/aviator/master/bin/aviator
[Link 6]: https://www.yuque.com/boyan-avfmj/aviatorscript/cpow90
[https_github.com_killme2008_aviator_releases]: https://github.com/killme2008/aviator/releases
[https_www.yuque.com_boyan-avfmj_aviatorscript_bggwx2]: https://www.yuque.com/boyan-avfmj/aviatorscript/bggwx2
[http_fnil.net_aviator_apidocs]: http://fnil.net/aviator/apidocs/
[https_github.com_mengxiangrui007_spring-boot-rule-jsr94]: https://github.com/mengxiangrui007/spring-boot-rule-jsr94
[https_github.com_yanchangyou_aviatorscript-ideaplugin]: https://github.com/yanchangyou/aviatorscript-ideaplugin