luaj 主要特征

luaj 用法示例

luaj 實現原理

查找并調用指定的 Java 方法

從 Java 方法獲取返回值

將 Lua function 作為參數傳遞給 Java 方法

在某些業務場景下，我們可能會遇到 lua 中要調用 java 代碼情況，當然這個用 JNI 肯定是可以做到的，但是有更加方便的辦法：LuaJavaBridge（LuaJava）和 LuaJ。

luaj 主要特征

可以從 Lua 調用 Java Class Static Method

調用 Java 方法時，支持 int/float/boolean/String/Lua function 五種參數類型

可以將 Lua function 作為參數傳遞給 Java，并讓 Java 保存 Lua function 的引用

可以從 Java 調用 Lua 的全局函數，或者調用引用指向的 Lua function

luaj 的功能很簡單，但對于集成各種 SDK 來說已經完全滿足需求了。

基于 Spring Boot + MyBatis Plus + Vue & Element 實現的后臺管理系統 + 用戶小程序，支持 RBAC 動態權限、多租戶、數據權限、工作流、三方登錄、支付、短信、商城等功能

luaj 用法示例

Java 方法原型：

publicstaticfloatgetNum(floatn){
returnn;
}

lua 調用示例：

--Java類的名稱
localclassName="com/xttblog/Test"
--調用的Java方法名
localmethod='getNum'
--調用Java方法需要的參數
localn=10
localargs={
n
}
--調用Java方法
local_,testStaticMethod=luaj.callStaticMethod(className,method,args)

基于 Spring Cloud Alibaba + Gateway + Nacos + RocketMQ + Vue & Element 實現的后臺管理系統 + 用戶小程序，支持 RBAC 動態權限、多租戶、數據權限、工作流、三方登錄、支付、短信、商城等功能

luaj 實現原理

luaj 的核心目標有兩個：從 Lua 調用 Java, 從 Java 調用 Lua。整理出來就是如下幾點

查找并調用指定的 Java 方法

檢查調用結果，并從 Java 方法獲取返回值

將 Lua function 作為參數傳遞給 Java 方法

在 Java 方法中調用 Lua function

查找并調用指定的 Java 方法

JNI 提供了 FindClass() 方法用于查找指定的 Class，所以 luaj.callStaticMethod() 的第一個參數就是要調用的 Java Class 的完整類名稱（類名稱中的“.”要替換為“/”）。

找到指定 Class 后，利用 JNI 的 GetStaticMethodID() 方法就可以找到這個類的指定靜態方法，前提是要提供靜態方法的名稱和簽名。

所謂簽名，就是指Java方法的參數類型和返回類型定義。方法的簽名就是類似(Ljava/lang/String;ZZI)V這樣的一串描述，通過字節碼方式可以查看，如下示例：

關于 Java 方法簽名的具體定義，可以參考：JNI Type Signatures。

這里要說的是 luaj 可以根據調用參數自動猜測方法簽名所以示例中我們并沒有寫簽名。

示例中指定參數：

localargs={n}

luaj 根據這 個參數，會構造出正確的方法簽名。

注意：這里要說的是 Lua 里沒有辦法準確判斷一個數值是整數還是浮點數，所以 luaj 在猜測方法簽名時，假定所有的數值都是浮點數。所以下面調用會報錯：

publicstaticintgetNum(intn){
returnn;
}

--Java類的名稱
localclassName="com/xttblog/Test"
--調用的Java方法名
localmethod='getNum'
--調用Java方法需要的參數
localn=10
localargs={
n
}
--調用Java方法
local_,testStaticMethod=luaj.callStaticMethod(className,method,args)

這樣是不行的，所以這個時候我們要自己定義簽名。

下面給出正確的示例

publicstaticintgetNum(intn){
returnn;
}
--Java類的名稱
localclassName="com/xttblog/Test"
--調用的Java方法名
localmethod='getNum'
--調用Java方法需要的參數
localn=10
localargs={
n
}
--定義簽名--參數:[I]nteger--返回值:[I]nt
localsig="(I)I"
--調用Java方法
local_,testStaticMethod=luaj.callStaticMethod(className,method,args，sig)

簽名使用“(依次排列的參數類型)返回值類型”的格式，幾個例子如下：

簽名解釋
()V 參數：無，返回值：無
(I)V 參數：int，返回值：無
(Ljava/lang/String;)Z 參數：字符串，返回值：布爾值
(IF)Ljava/lang/String;參數：整數、浮點數，返回值：字符串

這里列出不同類型對應的 Java 簽名字符串：

類型名類型
I整數，或者Luafunction
F浮點數
Z布爾值
Ljava/lang/String;字符串
VVoid空，僅用于指定一個Java方法不返回任何值

Java 方法里接收 Lua function 的參數必須定義為 int 類型

從 Java 方法獲取返回值

luaj 會檢查調用結果，并從 Java 方法獲取返回值。

luaj 調用 Java 方法時，可能會出現各種錯誤，因此 luaj 提供了一種機制讓 Lua 調用代碼可以確定 Java 方法是否成功調用。

luaj.callStaticMethod()會返回兩個值：

當成功時，第一個值為 true，第二個值是 Java 方法的返回值（如果有）。

當失敗時，第一個值為 false，第二個值是錯誤代碼。

下面的代碼展示了如何檢查返回結果和獲得返回值：

publicstaticintAddTwoNumbers(finalintnumber1,finalintnumber2){
returnnumber1+number2;
}

Lua代碼

localargs={2,3}
localsig="(II)I"
localok,ret=luaj.callStaticMethod(className,"AddTwoNumbers",args,sig)

ifnotokthen
print("luajerror:",ret)
else
print("ret:",ret)--輸出ret:5
end

錯誤代碼定義如下：

錯誤代碼描述
-1不支持的參數類型或返回值類型
-2無效的簽名
-3沒有找到指定的方法
-4Java方法執行時拋出了異常
-5Java虛擬機出錯
-6Java虛擬機出錯

將 Lua function 作為參數傳遞給 Java 方法

Lua 虛擬機中，Lua function 以值的形式保存。但這個值無法直接給 Java 用，所以 luaj 做了一個 Lua function 引用表。當一個 Lua function 傳遞給 Java 時，這個 function 對應的值會被存在引用表中，并獲得一個唯一的引用 ID （整數）。Java 代碼拿到這個引用 ID 后，就可以很方便的調用該 Lua function 了。

所以 Java 方法里接收 Lua function 的參數必須定義為 int 類型。

示例：

publicstaticintgetNum(intn){
returnn;
}

localfunctioncallback(result)
---方法內容
end
--Java類的名稱
localclassName="com/xttblog/Test"
--調用的Java方法名
localmethod='getNum'
--調用Java方法需要的參數
localargs={
callback
}
--定義簽名--參數:[I]nteger--返回值:[I]nt
localsig="(I)I"
--調用Java方法
local_,testStaticMethod=luaj.callStaticMethod(className,method,args，sig)

另外，LuaJ 也很好用。只需引入 pom。

?然后直接把 lua 代碼當做 String 字符串內嵌到 Java 代碼中：

StringluaStr="print'hello,world!'";
Globalsglobals=JsePlatform.standardGlobals();
LuaValuechunk=globals.load(luaStr);
chunk.call();

也可以創建一個 login.lua 腳本，內容如下：

--無參函數
functionhello()
print'hello'
end
--帶參函數
functiontest(str)
print('datafromjavais:'..str)
return'haha'
end

然后，Java先載入login.lua腳本并編譯，然后再獲取指定名稱的函數，無參的直接使用call()方法調用，帶參的需要通過invoke(LuaValue[])傳入參數表：

StringluaPath="res/lua/login.lua";//lua腳本文件所在路徑
Globalsglobals=JsePlatform.standardGlobals();
//加載腳本文件login.lua，并編譯
globals.loadfile(luaPath).call();
//獲取無參函數hello
LuaValuefunc=globals.get(LuaValue.valueOf("hello"));
//執行hello方法
func.call();
//獲取帶參函數test
LuaValuefunc1=globals.get(LuaValue.valueOf("test"));
//執行test方法,傳入String類型的參數參數
Stringdata=func1.call(LuaValue.valueOf("I'amfromJava!")).toString();
//打印lua函數回傳的數據
Logger.info("datareturnfromluais:"+data);

運行結果如下：

hello
datafromjavais:I'amfromJava!
八月07,2022525下午com.tw.login.tools.Loggerinfo
信息: lua return data：haha

審核編輯：劉清