ClassJS

ClassJS 是一個在 KubeJS 中建立 Java 類別的模組。

基本範例

你可以操作 Java 位元組碼來建立自訂的方法。

注意：某些會與類別互動的指令（例如 getstatic、invokestatic、new 等）受 KubeJS 的類別過濾器保護。你不能使用這些指令存取 KubeJS 或其其他外掛不允許的類別，也不能擴充或實作這些被限制的類別。

let ExampleClass = ClassCreator.create("ExampleClass")
    .toPublic()           // 設定類別為 public
    .defaultConstructor() // 新增預設建構子
    .createMethod("exampleMethod", [], "java.lang.String") // 方法名稱、參數型別、與回傳型別
        .toPublic()
        .code(builder => {
            builder.pushString("你好，ClassJS！")   // 將字串參考推到操作數棧
                .returnObject();                    // 回傳該字串
        })
    .defineClass();     // 定義該類別

console.info((new ExampleClass()).exampleMethod());

等價的 Java 程式碼：

public class ExampleClass {

    public ExampleClass() {
        super();
    }

    public String exampleMethod() {
        return "你好，ClassJS！";
    }

}

在 JavaScript 中撰寫程式碼

如果你不想學習 Java 位元組碼，也可以使用 JavaScript 函數來建立方法。

let ExampleClass = ClassCreator.create("ExampleClass")
    .toPublic()
    .createMethod("exampleMethod", ["int", "int"], "int")
        .toPublic().toStatic()
        .codeJS((num1, num2) => {
            return num1 + num2;
        })
    .defineClass();

console.info(ExampleClass.exampleMethod(1, 2));
// 在 startup.log 的輸出為
// 3.0

等價的 Java 程式碼：

public class ExampleClass {

    // 注意：這個類別甚至沒有建構子，
    // 因為上面的 JavaScript 並未呼叫 `defaultConstructor`，
    // 也沒有建立其他建構子。

    public static int exampleMethod(int i1, int i2) {
        return i1 + i2;
    }

}

載入已建立的類別

類別只能在 startup 腳本中定義。如果你想在其他腳本中使用它們，可以使用 ClassJSUtils.loadClass 方法。

ClassCreator.create("SomeClass")
    /** 對這個類別進行一些操作以加入內容 */
    .defineClass();

// 在其他腳本中：

let SomeClass = ClassJSUtils.loadClass("SomeClass");
// 然後就可以使用 `SomeClass`