• aviator基本使用

• 基本表達(dá)式

• 表達(dá)式變量

• 使用函數(shù)

• aviatorScript腳本

aviator本來是一個輕量級酥夭、高性能的基于JVM的表達(dá)式引擎斑举。不過從5.0.0版本開始搅轿，aviator升級成為了aviatorScript，成為一個高性能富玷、輕量級寄宿于 JVM （包括 Android 平臺）之上的腳本語言璧坟。

根據(jù)官網(wǎng)的介紹既穆，aviator支持的主要特性：

1. 支持?jǐn)?shù)字、字符串雀鹃、正則表達(dá)式幻工、布爾值、正則表達(dá)式等基本類型褐澎，完整支持所有 Java 運(yùn)算符及優(yōu)先級等会钝。
2. 函數(shù)是一等公民伐蒋，支持閉包和函數(shù)式編程
3. 內(nèi)置 bigint/decimal類型用于大整數(shù)和高精度運(yùn)算工三，支持運(yùn)算符重載得以讓這些類型使用普通的算術(shù)運(yùn)算符 +-*/參與運(yùn)算。
4. 完整的腳本語法支持先鱼，包括多行數(shù)據(jù)俭正、條件語句、循環(huán)語句焙畔、詞法作用域和異常處理等。
5. 函數(shù)式編程結(jié)合 Sequence 抽象宏多，便捷處理任何集合。
6. 輕量化的模塊系統(tǒng)伸但。
7. 多種方式，方便地調(diào)用 Java 方法更胖，完整支持 Java 腳本 API（方便從 Java 調(diào)用腳本）。
8. 豐富的定制選項(xiàng)却妨，可作為安全的語言沙箱和全功能語言使用。
9. 輕量化彪标，高性能，ASM 模式下通過直接將腳本翻譯成 JVM 字節(jié)碼捞烟，解釋模式可運(yùn)行于 Android 等非標(biāo) Java 平臺薄声。

使用場景包括：

1. 規(guī)則判斷及規(guī)則引擎
2. 公式計(jì)算
3. 動態(tài)腳本控制
4. 集合數(shù)據(jù) ELT 等

aviator基本使用

基本表達(dá)式

要使用aviator，只需要添加相應(yīng)依賴：

    <dependency>
        <groupId>com.googlecode.aviator</groupId>
        <artifactId>aviator</artifactId>
        <version>5.3.3</version>
    </dependency>

然后就可以進(jìn)行表達(dá)式求值了：

    // 返回值為16
    Long r = (Long) AviatorEvaluator.execute("2 * (3 + 5)");

為了提升性能坷襟，往往先編譯表達(dá)式奸柬，然后可以反復(fù)執(zhí)行，進(jìn)行表達(dá)式求值：

    Expression expression = AviatorEvaluator.compile("2 * (3 + 5)");
    Long r = (Long) expression.execute();

aviator支持?jǐn)?shù)字婴程、字符串廓奕、布爾值等基本數(shù)據(jù)類型，數(shù)字類型值都當(dāng)作long或double類型處理。關(guān)注工眾號：碼猿技術(shù)專欄桌粉，回復(fù)關(guān)鍵詞：1111 獲取阿里內(nèi)部java性能調(diào)優(yōu)手冊蒸绩！所以上面例子的求值結(jié)果是Long。

aviator表達(dá)式支持大部分的運(yùn)算操作符铃肯，如常用的算術(shù)運(yùn)算操作符(+患亿、-、*押逼、/步藕、%)、邏輯運(yùn)算操作符（&&挑格、||咙冗、！）漂彤、比較運(yùn)算操作符（>雾消、>=、==挫望、!=立润、<、<=）媳板、位運(yùn)算操作符（&桑腮、|、^拷肌、<<到旦、>>）和優(yōu)先級操作符，還支持三元操作表達(dá)(?:)巨缘、正則表達(dá)式(=~)添忘。

一些例子：

    // 返回 hello world
    String r = (String) AviatorEvaluator.execute("'hello' + ' world'");
    
    // 返回 true
    Boolean r = (Boolean) AviatorEvaluator.execute("100 > 80 && 30 < 40");
    
    // 三元表達(dá)式，返回 30
    Long r = (Long) AviatorEvaluator.execute("100 > 80 ? 30 : 40");
    
    // 正則表達(dá)式若锁，正則表達(dá)式放在//之間搁骑，返回 true
    Boolean r = (Boolean) AviatorEvaluator.execute("'hello' =~ /[\\w]+/");

表達(dá)式變量

跟其他表達(dá)式引擎一樣，aviator也是支持表達(dá)式求值時傳入?yún)?shù)的：

    Long a = 12L;
    Boolean r = (Boolean) AviatorEvaluator.exec("a > 10", a);

參數(shù)也可以是一個列表又固，如下：

    List<Long> 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會將參數(shù)放到一個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);
    // 結(jié)果返回 3
    Object value = AviatorEvaluator.execute("a.b[0]['x']", jsonObj.toMap());

使用函數(shù)

aviator已經(jīng)提供了很多開箱即用的函數(shù)了：

    // 返回
    Long r = (Long) AviatorEvaluator.execute("math.round(4.3)");
    
    // 返回5
    Long r = (Long) AviatorEvaluator.execute("string.length('hello')");
    
    // 返回一個ArrayList：[1,2,3]
    Object r = AviatorEvaluator.execute("seq.list(1,2,3)");

更詳細(xì)的內(nèi)置函數(shù)列表請參考：aviator函數(shù)庫列表

我們也可以自定義一個java函數(shù)仰冠，自己編寫一個類，繼承aviator的AbstractFunction類洋只，然后實(shí)現(xiàn)相應(yīng)的方法即可：

public class AddFunction extends AbstractFunction {

        /**
         * 函數(shù)實(shí)現(xiàn)的功能
         * @param env 參數(shù)
         * @param arg1 函數(shù)的第一個參數(shù)
         * @param arg2 函數(shù)的第二個參數(shù)
         * @return 返回值
         */
        @Override
        public AviatorObject call(Map<String, Object> env, AviatorObject arg1, AviatorObject arg2) {
            long num1 = FunctionUtils.getNumberValue(arg1, env).longValue();
            long num2 = FunctionUtils.getNumberValue(arg2, env).longValue();
            return AviatorLong.valueOf(num1+num2);
        }

        /**
         * 注冊到aviator的名字
         * @return 函數(shù)名字
         */
        @Override
        public String getName() {
            return "add";
        }
    }

然后就可以注冊到aviator中，像使用內(nèi)置函數(shù)一樣使用自定義函數(shù)：

    // 注冊
    AviatorEvaluator.addFunction(new AddFunction());
    
    // 使用
    long sum = (Long) AviatorEvaluator.getInstance().execute("add(3,4)");

aviatorScript腳本

aviator已經(jīng)升級為一個腳本語言妒茬，所以不僅僅能進(jìn)行表達(dá)式求值乍钻，還可以執(zhí)行腳本程序银择。

    // 返回
    Object r = AviatorEvaluator.execute("if (true) { return 1; } else { return 2; }");

aviatorScript腳本一般放到獨(dú)立的腳本文件中谨履，文件名后綴一般為.av

例如，我們編寫一個hello.av腳本文件，內(nèi)容為：

    if (a > 10) {
        return 10;
    } else {
        return a;
    }

然后就可以執(zhí)行該腳本文件害捕，并傳入?yún)?shù)a的值：

    Map<String, Object> env = new HashMap<>();
    env.put("a", 30);
    Expression exp = AviatorEvaluator.getInstance().compileScript("./hello.av", true);
    Object result = exp.execute(env);

官方文檔：https://github.com/killme2008/aviatorscript