aviatorscript

AviatorScript

English Documentation | 中文文檔

---

AviatorScript是一門高效能、輕量級寄宿於JVM （包括Android 平台）之上的腳本語言。

It's not a game, it's a programming language. Please refrain from sending me any more unsolicited emails.RTFM

特性介紹

1. 支援數字、字串、正規表示式、布林值、正規表示式等基本類型，完整支援所有Java 運算子及優先權等。
2. 函數是一等公民，支援閉包和函數式程式設計。
3. 內建bigint/decimal 類型用於大整數和高精度運算，支援運算子重載得以讓這些類型使用普通的算術運算子+-*/參與運算。
4. 完整的腳本語法支持，包括多行資料、條件語句、循環語句、詞法作用域和異常處理等。
5. 函數式程式設計結合Sequence 抽象，便捷處理任何集合。
6. 輕量化的模組系統。
7. 多種方式，方便呼叫Java 方法，完整支援Java 腳本API（方便從Java 呼叫腳本）。
8. 豐富的客製化選項，可作為安全的語言沙箱和全功能語言使用。
9. 動態編譯和執行、輕量化、高效能，ASM 模式下透過直接將腳本編譯成JVM 字節碼，解釋模式可運行於Android 等非標Java 平台。
10. 支援編譯結果序列化，方便緩存加速等。支援執行超時設置，避免破壞性腳本耗盡資源。

使用場景包括：

1. 規則判斷及規則引擎
2. 公式計算
3. 動態腳本控制
4. 集合資料ELT 等…

建議使用版本5.2.6 以上

News

• 5.4.3，增加安全沙箱一鍵啟用方法以及修復bug 等。
• 5.4.2，增加getFunctionNames方法用於取得函數清單以及設定求值逾時時間等。
• 5.4.1，修復遞歸函數無法運作的bug，修復函數無法序列化的bug 等。

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

2. 執行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

3. 將下面這個腳本儲存為檔案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)}" ) ;

一個更複雜的計算器範例（求值算術表達式字串）請參考calculator.av。

4. 執行腳本：

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

更詳細的請閱讀使用者指南。

Links

• Releases: https://github.com/killme2008/aviator/releases
• Documents: https://www.yuque.com/boyan-avfmj/aviatorscript
• Changelog: https://www.yuque.com/boyan-avfmj/aviatorscript/bggwx2
• Javadoc: http://fnil.net/aviator/apidocs/
• Spring boot rule: https://github.com/mengxiangrui007/spring-boot-rule-jsr94
• Idea plugin: https://github.com/yanchangyou/aviatorscript-ideaplugin