JavaScript 引擎：Rhino

下載

http://github.com/mozilla/rhino

Java SE 6 和 Java SE 7 有內建 Rhino，但只打包部分功能，所以還是建議下載新版的來用。

Rhino 從 1.7.8 版開始，使用 Java SE 8 編譯，所以 Java SE 6/7 能用的最新版只到 1.7.7.2。

Java SE 8 起，改內建 Nashorn，兩者語法不相容，所以要從 Rhino 轉換 Nashorn 的話，不妨考慮下載 Rhino 來掛載就好，要比修改程式碼省事。

直譯 *.js 檔

java -jar rhino.jar *.js

使用 -jar 參數的話，CLASSPATH 只能存取 rhino.jar 裡面的檔案，無法存取 JAR 外部的檔案，所以最好改用 -cp 參數：

java -cp .;rhino.jar org.mozilla.javascript.tools.shell.Main *.js

此外，若 *.js 原始碼檔案使用不含 BOM 的 UTF-8 字元編碼，在 Windows 會有亂碼的問題。這時要下 -encoding UTF-8 參數給 org.mozilla.javascript.tools.shell.Main 或 rhino.jar，也可以下 -Dfile.encoding=UTF-8 參數給 java.exe。

其他常用的參數有：

編譯 *.js 為 *.class

java -cp rhino.jar org.mozilla.javascript.tools.jsc.Main script.js

編譯出來的 *.class 是 Rhino 的 NativeFunction 物件，所以只用 java.exe 無法執行，得掛載 Rhino：

java -cp .;rhino.jar script

Interactive mode

java -jar rhino.jar

Rhino 1.7.13 2020 09 02
js> _

基本：使用 Rhino.jar 直譯 JavaScript 程式檔

在 JavaScript 使用 Java API
調用第三方套件
在 JavaScript 使用 Java 的資料型態
調用 Java API 傳入 Java 的類別時
覆載物件方法與實作介面功能
多執行緒
在 *.js 中載入其它 *.js
最頂層物件
列出 JavaScript 物件的屬性和方法
Rhino 內建屬性和函式
其它 Rhino 的不標準語法

進階：使用 JDK 6/7 內建的 Rhino 引擎（非必要，可略過）

在 Java 寫 JavaScript 程式
使用新版 Rhino 在 Java 寫 JavaScript 程式
從 Java 傳資料給 JavaScript 程式
在 Java 載入 *.js 檔案
直接用 JDK 執行 *.js 檔
在 JDK 6/7 將 *.js 編譯成 *.class
進入 JDK 內建的 Interactive mode
如何取得 Java 內建 JavaScript 引擎的版本

應用：Java API 範例集

Swing 視窗程式設計
播放 WAVE 和 MP3 音樂
播放 MIDI 音樂
壓縮與解壓縮 ZIP 檔案
使用 SQLite 資料庫
存取剪貼簿文字

附錄

JavaScript 程式設計錦囊

站點

MDN Rhino（頁面已撤除）
MDN JavaScript reference
MDN Standard built-in objects
RingoJS

以覆載 Thread 物件的 run() 方法為例

importPackage(java.lang); let thread = new Thread({ run: function(){ print('Hello!'); } }) thread.start();

Hello!

以實作 Runnable 介面的 run() 功能為例

importPackage(java.lang); let program = new Runnable({ run: function(){ print('Hello!'); } }) new Thread(program).start();

Hello!

基於 Lambda 的特性，介面只有一個功能需要實作的話，可以省略介面名稱：

importPackage(java.lang); let program = { run: function(){ print('Hello!'); } } new Thread(program).start();

Hello!

用 Java API 的 Thread 物件

importPackage(java.lang); function playMusic(file){ runCommand('wmplayer.exe', file); } new Thread({ run: function(){ playMusic('music.mp3'); } }).start(); print('音樂播放中');

用 Rhino 內建函式 spawn()

function playMusic(file){ runCommand('wmplayer.exe', file); } spawn(function(){ playMusic('music.mp3'); }); print('音樂播放中');

補充

像 playMusic() 這樣播放背景音樂的函式，可以把執行緒寫在函式裡面：

arguments

這不是函式物件的 arguments，而是 global 物件的，用來取得命令列的參數。

範例：

print(arguments[0]);

java -cp .;rhino.jar org.mozilla.javascript.tools.shell.Main *.js 123

123

要拖曳檔案給 JavaScript 程式碼，可在執行 *.js 的批次檔用 %1 到 %9 當作參數：

java -cp .;rhino.jar org.mozilla.javascript.tools.shell.Main *.js %1

再把檔案拖曳到批次檔即可。

history

紀錄 Shell 輸入過的指令。

defineClass()

用來載入繼承自 ScriptableObject 的 Java 類別。

這種類別更符合 JavaScript 物件的特性，能用 JavaScript 的語法糖操作 Java 物件。但無法用「new Packages.類別名稱()」建立，所以用「defineClass(Packages.類別名稱)」掛載進來。

loadClass()

用來執行實作 Script 介面的類別。

它並不是載入類別來用，而是直接執行寫在 exec() 裡面的程式。

當 JavaScript 無法正常使用 Java API 的功能，不得不用 Java 設計成 *.class 來調用時，這機制是很棒的選擇！

var 在全域範疇的影響

//在全域範疇宣告變數 a。 var a = 123; //看全域物件是不是有了 a 屬性，得到的是 undefined。 print(global.a); //確認全域物件是什麼，是 global 沒錯。 print(this); //透過 this 取出變數 a 看看，確實是有 123 這筆資料。 print(this.a); //這下知道怎麼對 global 取出變數 a 了，一定在 prototype 裡。 print(global.prototype.a);

undefined
[object global]
123
123

Rhino 將變數放在全域物件的 prototype，這設計或多或少降低 var 對全域的汙染。但 var 的其它容錯特性還是會帶來副作用，所以 let 還是很重要。

let 和 const 的實作並不標準

Rhino 的 let 和 const 並未完全實作 ECMAScript 6 規範的功能，所以全面改用 let 和 const 取代 var 的話，要注意與其它 JavaScript 引擎表現起來不盡相同的問題！

可以把 let 用在 for() 的計數器和流程控制的 {} 裡面就好，用在其它場合的話，不要指望它能和網頁瀏覽器的 let 一樣，完全解決 var 的弊端：「因為 Rhino 的 let 像是拿 var 改出來湊用的，在全域範疇使用，依然會將變數放入 global 物件。」而 const 也有問題，修改變數不會報錯，只是資料並未修改而已，跟 var 出來的變數重複宣告不會報錯一樣。

function 物件裡面只有一行敘述的話，可以省略 {} 括號

var sayHello = function() print('Hello!'); sayHello();

Hello!

寫在全域範疇

import javax.script.ScriptEngine; import javax.script.ScriptEngineManager; public class Main{ public static void main(String[] args){ ScriptEngine js = new ScriptEngineManager().getEngineByName("JavaScript"); js.put("var1", 123); try{ js.eval("print(var1)"); } catch(Exception exception){ exception.printStackTrace(); } } }

123

寫在區域範疇（避免汙染最頂層物件）

import javax.script.ScriptEngine; import javax.script.ScriptEngineManager; public class Main{ public static void main(String[] args){ ScriptEngine js = new ScriptEngineManager().getEngineByName("JavaScript"); Bindings binding = js.createBindings(); binding.put("var2", 456); try{ js.eval("print(var2)", binding); } catch(Exception exception){ exception.printStackTrace(); } } }

456

script.js

print('Hello, JavaScript!');

Main.java

import java.io.FileReader; import javax.script.ScriptEngine; import javax.script.ScriptEngineManager; public class Main{ public static void main(String[] args){ ScriptEngine js = new ScriptEngineManager().getEngineByName("JavaScript"); try{ js.eval(new FileReader("script.js")); } catch(Exception exception){ exception.printStackTrace(); } } }

Hello, JavaScript!

script.js

print('Hello, JavaScript!');

命令提示字元

jrunscript script.js

Hello, JavaScript!

視窗、按鈕、事件

importPackage(javax.swing); importPackage(java.awt.event); let frame = new JFrame(); frame.setSize(400, 300); frame.setTitle('Hello, Swing!'); frame.setVisible(true); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setLayout(null); let button = new JButton(); button.setLocation(40, 100); button.setSize(300, 30); button.setText('別亂按'); frame.add(button); frame.addWindowListener(new WindowAdapter({ windowDeactivated: function(){ print('視窗縮小了'); }, windowDeiconified: function(){ print('視窗還原了'); } })); button.addActionListener(function(){ button.setText('不是叫你別亂按嗎'); });

呼叫另一個視窗

importPackage(javax.swing); function Frame1(){ var frame = new JFrame(); frame.setSize(400, 300); frame.setLocationRelativeTo(null); frame.setTitle('Frame 1'); frame.setVisible(true); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setLayout(null); var button = new JButton(); button.setLocation(40, 100); button.setSize(300, 30); button.setText('開啟另一視窗'); frame.add(button); button.addActionListener(function(){ frame2.show(); }); } function Frame2(){ var frame = new JFrame(); frame.setSize(400, 300); frame.setTitle('Frame 2'); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); this.show = function(){ frame.show(); }; } let frame1 = new Frame1(); let frame2 = new Frame2();

啟動視窗小秘訣

由於 Java 寫的應用程式是透過 java.exe 指令執行，所以視窗應用程式啟動時，會帶一個命令提示字元，相當礙眼。

請善用 CMD /C START "" 指令，可以在執行完指令後，自動結束命令字元視窗：

CMD /C START "" javaw -cp .;"%JAVA_HOME%\lib\rhino.jar" org.mozilla.javascript.tools.shell.Main -version 200 -encoding UTF-8 *.js

在其它表述語言，通常直接建立捷徑，輸入 CMD /C START "" ... 即可。但 java.exe 掛載 rhino.jar 的參數太複雜，裡面有下給參數的參數，還得寫 %"%"%"%" 這種符號表示 ""，建議還是乖乖寫在批次檔執行吧！點兩下批次檔，照樣會自動關閉命令提示字元視窗，不但不會比較難用，反而比捷徑更容易修改、維護。

壓縮

將 archive 資料夾壓縮為 archive.zip：

importPackage(java.io); importPackage(java.util.zip); let zip_output_stream = new ZipOutputStream(new FileOutputStream('archive.zip')); function zip(files){ for(let file of files){ if(file.isDirectory()){ zip_output_stream.putNextEntry(new ZipEntry(file.toString() + '/')); zip_output_stream.closeEntry(); zip(new File(file).listFiles()); } else{ let file_name = file.toString(); zip_output_stream.putNextEntry(new ZipEntry(file_name)); let buffer = java.lang.reflect.Array.newInstance(java.lang.Byte.TYPE, 1024); let buffered_input_stream = new BufferedInputStream(new FileInputStream(file_name), buffer.length); let n; while((n = buffered_input_stream.read(buffer, 0, buffer.length)) != -1){ zip_output_stream.write(buffer, 0, n); } buffered_input_stream.close(); zip_output_stream.closeEntry(); } } } zip(new File('archive').listFiles()); zip_output_stream.close();

解壓縮

importPackage(java.io); importPackage(java.util); importPackage(java.util.zip); let zip_file = new ZipFile('archive.zip'); let enumeration = zip_file.entries(); while(enumeration.hasMoreElements()){ let zip_entry = enumeration.nextElement(); if(zip_entry.isDirectory()){ new File(zip_entry).mkdirs(); } else{ let input_stream = zip_file.getInputStream(zip_entry); let out_stream = new FileOutputStream(zip_entry.getName()); let bytes = java.lang.reflect.Array.newInstance(java.lang.Byte.TYPE, 1024); let n; while((n = input_stream.read(bytes)) != -1){ out_stream.write(bytes, 0, n); } } }

Value object

print('abc'.toUpperCase()); print((123).toString(2)); print((false).toString().toUpperCase()); print([111, 222, 333].reverse()); if(/^[A-z]\w{6,}\d$/.test('abcd1234')){ print('密碼有效'); }

ABC
1111011
FALSE
333,222,111
密碼有效

Higher-order function

//Method references 1 [111, 222, 333].forEach(print); //Method references 2 function f(x){ print(x * 2); } [111, 222, 333].forEach(f); //Anonymous function [111, 222, 333].forEach(x => print(++x)); //Lambda function f(action){ action(); } f(()=>{ print(777); })

111 0 111,222,333
222 1 111,222,333
333 2 111,222,333

222
444
666

112
223
334

777

Destructuring assignment

let a, b, c; [a, b, c] = [123, 456, 789]; print(a); print(b); print(c);

123
456
789

Top-level functions

善用以下函式：

eval(string)
parseInt(string [,radix])
parseFloat(string)
isFinite(value)
encodeURI(string)
decodeURI(string)
encodeURIComponent(string)
decodeURIComponent(string)

建議用 Number.isNaN() 取代 isNaN()。
建議用 String.charCodeAt() 取代 escape()。
建議用 String.fromCharCode() 取代 unescape()。

Array.prototype.join() 和 String.prototype.split() 的妙用

//陣列轉字串 let string = [1, 2, 3, 4, 5, 6, 7, 8, 9].join(' '); print(string); //字串轉陣列 let array = 'a,b,c,d,e'.split(','); for(let n of array){ print(n); }

1 2 3 4 5 6 7 8 9
a
b
c
d
e

Array.prototype.slice.call() 和 [].slice.call() 的差別

前者不用建立 Array 物件，直接調用 slice 方法。

後者等於 new 一個 Array 物件，然後呼叫物件的 slice 方法。

雖然前者不用 new 所以效能更好，還可避免建立大量的垃圾，但程式碼落落長，沒有後者簡短，所以只建立一個物件的話，大多數人都是用後者。

在迴圈會產生大量的物件，就改用前者吧！不像網頁瀏覽器的 JavaScript 引擎（例如 SpiderMonkey），會最佳化編譯再執行，兩者執行起來差別很小，Rhino 就只是直譯而已～

Rhino 1.7.13 仍不支援的新語法替代方案

jjs 或 jrunscript

建議使用 jjs，程式碼有錯誤時，會剖析語法，指出錯誤原因與程式碼位置。

jrunscript 只會拋出例外，不方便除錯。

使用 ECMAScript 6 語法

jjs main.js --language=es6

Java 11 的 Nashorn 支援 `` 符號的字串，能表示多行字串，以及用 ${變數名稱或運算式} 將程式崁在字串裡。還支援預設參數。

Java 8 的 Nashorn 不支援上述功能。

Nashorn 不支援 Destructuring assignment，Rhino 卻有支援，只能說 Java 底下的 JavaScript 引擎沒一個好的～

如何 import 套件

load('nashorn:mozilla_compat.js')，就能使用 Rhino 的 importPackage()。

關於 JFrame

不需要 frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE)，關閉視窗圖示就能結束視窗。但！還是要加！不然 jjs 的行程會殘留在電腦裡，不會隨視窗結束而關閉！

需要用 frame.repaint() 重繪視窗元件，才能在載入視窗時顯示 JFrame.add() 的元件。