BeanShell 動態腳本引擎實戰指南：Java 應用嵌入腳本、動態方法定義與接口實現技術

BeanShell 核心定位

BeanShell (bsh) 是純 Java 實現的動態腳本引擎，支持：

• 標準 Java 語法 (類、方法、循環、條件)
• 腳本特性：弱類型、閉包、動態方法、命令式風格
• 嵌入 Java 應用：運行時動態執行腳本、擴展應用行為
• JSR-274 標準化：Java 平台第三種官方腳本語言 (繼 Groovy 之後)

三種運行模式

# 1. 圖形化控制台
java bsh.Console

# 2. 命令行交互
java bsh.Interpreter

# 3. 執行腳本文件
java bsh.Interpreter script.bsh [args...]

核心語法特性

動態方法定義 (鬆散類型)

// 強類型 (Java 風格)
int add(int a, int b) { return a + b; }

// 弱類型 (腳本風格) - 同一方法處理多類型
add(a, b) { return a + b; }

print(add(1, 2));        // 3
print(add("Hello", "World")); // "HelloWorld"
print(add(new Date(), 1000)); // 日期加毫秒 (若支持)

腳本實現 Java 接口 (動態代理)

// 匿名內部類語法實現接口
ActionListener listener = new ActionListener() {
    actionPerformed(event) {
        print("Button clicked: " + event.getActionCommand());
    }
};

// 部分實現：未定義方法拋出异常
// 通用處理：invoked 方法攔截所有調用
MouseListener ml = new MouseListener() {
    mousePressed(event) { print("Pressed: " + event); }
    invoke(name, args) { print("Unhandled: " + name); }
};

嵌入 Java 應用完整範例

import bsh.Interpreter;
import bsh.EvalError;

public class ScriptEngine {
    private final Interpreter interpreter = new Interpreter();

    public void init() throws EvalError {
        // 1. 向腳本暴露 Java 對象
        interpreter.set("appContext", this);
        interpreter.set("userService", new UserService());

        // 2. 預加載通用腳本
        interpreter.source("classpath:scripts/common.bsh");
    }

    public Object execute(String script) {
        try {
            return interpreter.eval(script);
        } catch (EvalError e) {
            throw new RuntimeException("Script execution failed", e);
        }
    }

    // 業務方法可被腳本調用
    public void notifyAdmins(String msg) { /* ... */ }
}

// 腳本示例: dynamicRule.bsh
// userService.createUser("admin", "123456");
// appContext.notifyAdmins("New user registered");

進階應用場景

• 熱加載業務規則：無需重啟應用修改驗證邏輯、計算公式、流程配置
• 用戶自定義腳本：提供安全沙箱讓用戶編寫擴展邏輯
• 測試腳本化：測試數據構建、API 調用序列腳本化
• 配置文件增強：屬性文件中嵌入邏輯表達式

安全沙箱與性能考量

BeanShell vs Groovy vs Java Scripting API (JSR-223)

特性
BeanShell
Groovy
Nashorn (JS)
Java 語法兼容
高 (子集)
高 (超集)
低 (JS 語法)
性能
中
高 (靜態編譯)
高 (JIT)
生態成熟度
低 (維護緩慢)
高
中 (JDK 15 移除)
適用場景
輕量嵌入、Java 開發者友好
DSL、構建腳本、完整應用
前端共享邏輯、Polyglot


參考資源：BeanShell 官網 | JSR-274 規范