一、簡介

在 Java 開發(fā)中，有時需要動態(tài)執(zhí)行腳本代碼，比如 JavaScript 腳本，來實現(xiàn)一些靈活的業(yè)務(wù)邏輯，如動態(tài)規(guī)則計算、數(shù)據(jù)處理等。Java 本身提供了 javax.script 包來支持腳本執(zhí)行，但使用起來較為繁瑣。Hutool - Script 模塊對 Java 的腳本執(zhí)行功能進行了封裝，提供了更簡潔易用的 API，讓開發(fā)者可以方便地執(zhí)行各種腳本，這里主要介紹 JavaScript 腳本的執(zhí)行。

二、引入依賴

如果你使用 Maven 項目，在 pom.xml 中添加以下依賴：

<dependency><groupId>cn.hutool</groupId><artifactId>hutool-all</artifactId><version>5.8.16</version>
</dependency>

若使用 Gradle 項目，在 build.gradle 中添加：

implementation 'cn.hutool:hutool-all:5.8.16'

三、基本使用示例

1. 執(zhí)行簡單的 JavaScript 腳本

import cn.hutool.script.ScriptUtil;public class SimpleScriptExecution {public static void main(String[] args) {// 定義 JavaScript 腳本String script = "var a = 5; var b = 3; a + b;";// 執(zhí)行腳本并獲取結(jié)果Object result = ScriptUtil.eval(script);System.out.println("腳本執(zhí)行結(jié)果: " + result);}
}

在上述代碼中，首先定義了一個簡單的 JavaScript 腳本，該腳本定義了兩個變量 a 和 b，并計算它們的和。然后使用 ScriptUtil.eval 方法執(zhí)行該腳本，該方法會返回腳本執(zhí)行的結(jié)果，最后將結(jié)果輸出。

2. 執(zhí)行帶函數(shù)調(diào)用的 JavaScript 腳本

import cn.hutool.script.ScriptUtil;public class FunctionScriptExecution {public static void main(String[] args) {// 定義包含函數(shù)的 JavaScript 腳本String script = "function add(a, b) { return a + b; } add(7, 8);";// 執(zhí)行腳本并獲取結(jié)果Object result = ScriptUtil.eval(script);System.out.println("函數(shù)調(diào)用腳本執(zhí)行結(jié)果: " + result);}
}

這里定義了一個 JavaScript 函數(shù) add 用于計算兩個數(shù)的和，然后調(diào)用該函數(shù)并傳入?yún)?shù)。同樣使用 ScriptUtil.eval 方法執(zhí)行腳本并獲取結(jié)果。

四、向腳本傳遞參數(shù)

1. 傳遞單個參數(shù)

import cn.hutool.script.ScriptUtil;import javax.script.ScriptException;
import java.util.HashMap;
import java.util.Map;public class PassSingleParameter {public static void main(String[] args) throws ScriptException {// 定義 JavaScript 腳本，使用傳入的參數(shù)String script = "var num = param * 2; num;";// 定義參數(shù)Map<String, Object> params = new HashMap<>();params.put("param", 10);// 執(zhí)行腳本并傳遞參數(shù)Object result = ScriptUtil.eval(script, params);System.out.println("傳遞單個參數(shù)腳本執(zhí)行結(jié)果: " + result);}
}

在這個示例中，腳本中使用了一個名為 param 的參數(shù)，通過 Map 對象將參數(shù)傳遞給 ScriptUtil.eval 方法，腳本會使用傳入的參數(shù)進行計算并返回結(jié)果。

2. 傳遞多個參數(shù)

import cn.hutool.script.ScriptUtil;import javax.script.ScriptException;
import java.util.HashMap;
import java.util.Map;public class PassMultipleParameters {public static void main(String[] args) throws ScriptException {// 定義 JavaScript 腳本，使用傳入的多個參數(shù)String script = "var sum = param1 + param2; sum;";// 定義參數(shù)Map<String, Object> params = new HashMap<>();params.put("param1", 5);params.put("param2", 6);// 執(zhí)行腳本并傳遞參數(shù)Object result = ScriptUtil.eval(script, params);System.out.println("傳遞多個參數(shù)腳本執(zhí)行結(jié)果: " + result);}
}

與傳遞單個參數(shù)類似，通過 Map 對象可以傳遞多個參數(shù)給腳本，腳本可以使用這些參數(shù)進行相應(yīng)的計算。

五、處理腳本異常

在執(zhí)行腳本時，可能會出現(xiàn)各種異常，如語法錯誤、類型錯誤等。Hutool - Script 會將腳本執(zhí)行過程中的異常拋出，開發(fā)者可以進行捕獲和處理。

import cn.hutool.script.ScriptUtil;import javax.script.ScriptException;public class ScriptExceptionHandling {public static void main(String[] args) {// 定義包含語法錯誤的 JavaScript 腳本String script = "var a = 5; var b = 3; a + b; // 故意添加語法錯誤: ;;;";try {// 執(zhí)行腳本Object result = ScriptUtil.eval(script);System.out.println("腳本執(zhí)行結(jié)果: " + result);} catch (ScriptException e) {System.err.println("腳本執(zhí)行出錯: " + e.getMessage());}}
}

在上述代碼中，腳本包含語法錯誤，使用 try - catch 塊捕獲 ScriptException 異常，并輸出異常信息，方便開發(fā)者進行調(diào)試。

六、注意事項

• 腳本安全：執(zhí)行外部傳入的腳本時，要注意腳本的安全性，避免執(zhí)行惡意腳本導(dǎo)致安全漏洞，如注入攻擊等。
• 性能考慮：頻繁執(zhí)行腳本可能會影響程序的性能，尤其是復(fù)雜的腳本。在性能敏感的場景下，要謹慎使用腳本執(zhí)行功能。
• 腳本引擎選擇：Hutool - Script 默認使用 Java 內(nèi)置的腳本引擎，對于 JavaScript 腳本，使用的是 Nashorn 引擎（Java 8 及以前）或 GraalVM JavaScript 引擎（Java 11 及以后）。如果需要更高性能或特定功能，可以考慮使用其他腳本引擎。

通過使用 Hutool - Script，開發(fā)者可以方便地在 Java 項目中執(zhí)行 JavaScript 等腳本，為項目增加了更多的靈活性和動態(tài)性。