点击上方“芋道源码”,选择“设为星标”
管她前浪,还是后浪?
能浪的浪,才是好浪!
每天 10:33 更新文章,每天掉亿点点头发...
源码精品专栏
- 原创 | Java 2021 超神之路,很肝~
- 中文详细注释的开源项目
- RPC 框架 Dubbo 源码解析
- 网络应用框架 Netty 源码解析
- 消息中间件 RocketMQ 源码解析
- 数据库中间件 Sharding-JDBC 和 MyCAT 源码解析
- 作业调度中间件 Elastic-Job 源码解析
- 分布式事务中间件 TCC-Transaction 源码解析
- Eureka 和 Hystrix 源码解析
- Java 并发源码
来源:网络
- 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 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能
- 项目地址:https://gitee.com/zhijiantianya/ruoyi-vue-pro
- 视频教程:https://doc.iocoder.cn/video/
luaj 用法示例
Java 方法原型:
代码语言:javascript复制public static float getNum(float n) {
return n;
}
lua 调用示例:
代码语言:javascript复制-- Java 类的名称
local className = "com/xttblog/Test"
-- 调用 的Java 方法名
local method = 'getNum'
-- 调用 Java 方法需要的参数
local n = 10
local args = {
n
}
-- 调用 Java 方法
local _, testStaticMethod = luaj.callStaticMethod(className, method, args)
基于 Spring Cloud Alibaba Gateway Nacos RocketMQ Vue & Element 实现的后台管理系统 用户小程序,支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能
- 项目地址:https://gitee.com/zhijiantianya/yudao-cloud
- 视频教程:https://doc.iocoder.cn/video/
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 可以根据调用参数自动猜测方法签名所以示例中我们并没有写签名。
示例中指定参数:
代码语言:javascript复制local args = {n}
luaj 根据这 个参数,会构造出正确的方法签名。
注意:这里要说的是 Lua 里没有办法准确判断一个数值是整数还是浮点数,所以 luaj 在猜测方法签名时,假定所有的数值都是浮点数。所以下面调用会报错:
代码语言:javascript复制public static int getNum(int n) {
return n;
}
-- Java 类的名称
local className = "com/xttblog/Test"
-- 调用 的Java 方法名
local method = 'getNum'
-- 调用 Java 方法需要的参数
local n = 10
local args = {
n
}
-- 调用 Java 方法
local _, testStaticMethod = luaj.callStaticMethod(className, method, args)
这样是不行的,所以这个时候我们要自己定义签名。
下面给出正确的示例
代码语言:javascript复制public static int getNum(int n) {
return n;
}
-- Java 类的名称
local className = "com/xttblog/Test"
-- 调用 的Java 方法名
local method = 'getNum'
-- 调用 Java 方法需要的参数
local n = 10
local args = {
n
}
-- 定义签名-- 参数: [I]nteger-- 返回值: [I]nt
local sig = "(I)I"
-- 调用 Java 方法
local _, testStaticMethod = luaj.callStaticMethod(className, method, args,sig)
签名使用“(依次排列的参数类型)返回值类型”的格式,几个例子如下:
代码语言:javascript复制签名 解释
()V 参数:无,返回值:无
(I)V 参数:int,返回值:无
(Ljava/lang/String;)Z 参数:字符串,返回值:布尔值
(IF)Ljava/lang/String; 参数:整数、浮点数,返回值:字符串
这里列出不同类型对应的 Java 签名字符串:
代码语言:javascript复制类型名 类型
I 整数,或者 Lua function
F 浮点数
Z 布尔值
Ljava/lang/String; 字符串
V Void 空,仅用于指定一个 Java 方法不返回任何值
Java 方法里接收 Lua function 的参数必须定义为 int 类型
从 Java 方法获取返回值
luaj 会检查调用结果,并从 Java 方法获取返回值。
luaj 调用 Java 方法时,可能会出现各种错误,因此 luaj 提供了一种机制让 Lua 调用代码可以确定 Java 方法是否成功调用。
luaj.callStaticMethod()
会返回两个值:
- 当成功时,第一个值为 true,第二个值是 Java 方法的返回值(如果有)。
- 当失败时,第一个值为 false,第二个值是错误代码。
下面的代码展示了如何检查返回结果和获得返回值:
代码语言:javascript复制public static int AddTwoNumbers(final int number1, final int number2) {
return number1 number2;
}
Lua代码
代码语言:javascript复制local args = {2, 3}
local sig = "(II)I"
local ok, ret = luaj.callStaticMethod(className, "AddTwoNumbers", args, sig)
if not ok then
print("luaj error:", ret)
else
print("ret:", ret) -- 输出 ret: 5
end
错误代码定义如下:
代码语言:javascript复制错误代码 描述
-1 不支持的参数类型或返回值类型
-2 无效的签名
-3 没有找到指定的方法
-4 Java 方法执行时抛出了异常
-5 Java 虚拟机出错
-6 Java 虚拟机出错
将 Lua function 作为参数传递给 Java 方法
Lua 虚拟机中,Lua function 以值的形式保存。但这个值无法直接给 Java 用,所以 luaj 做了一个 Lua function 引用表。当一个 Lua function 传递给 Java 时,这个 function 对应的值会被存在引用表中,并获得一个唯一的引用 ID (整数)。Java 代码拿到这个引用 ID 后,就可以很方便的调用该 Lua function 了。
所以 Java 方法里接收 Lua function 的参数必须定义为 int 类型。
示例:
代码语言:javascript复制public static int getNum(int n) {
return n;
}
local function callback(result)
---方法内容
end
-- Java 类的名称
local className = "com/xttblog/Test"
-- 调用 的Java 方法名
local method = 'getNum'
-- 调用 Java 方法需要的参数
local args = {
callback
}
-- 定义签名-- 参数: [I]nteger-- 返回值: [I]nt
local sig = "(I)I"
-- 调用 Java 方法
local _, testStaticMethod = luaj.callStaticMethod(className, method, args,sig)
另外,LuaJ 也很好用。只需引入 pom。
然后直接把 lua 代码当做 String 字符串内嵌到 Java 代码中:
代码语言:javascript复制String luaStr = "print 'hello,world!'";
Globals globals = JsePlatform.standardGlobals();
LuaValue chunk = globals.load(luaStr);
chunk.call();
也可以创建一个 login.lua 脚本,内容如下:
代码语言:javascript复制 --无参函数
function hello()
print 'hello'
end
--带参函数
function test(str)
print('data from java is:'..str)
return 'haha'
end
然后,Java先载入login.lua脚本并编译,然后再获取指定名称的函数,无参的直接使用call()方法调用,带参的需要通过invoke(LuaValue[])传入参数表:
代码语言:javascript复制 String luaPath = "res/lua/login.lua"; //lua脚本文件所在路径
Globals globals = JsePlatform.standardGlobals();
//加载脚本文件login.lua,并编译
globals.loadfile(luaPath).call();
//获取无参函数hello
LuaValue func = globals.get(LuaValue.valueOf("hello"));
//执行hello方法
func.call();
//获取带参函数test
LuaValue func1 = globals.get(LuaValue.valueOf("test"));
//执行test方法,传入String类型的参数参数
String data = func1.call(LuaValue.valueOf("I'am from Java!")).toString();
//打印lua函数回传的数据
Logger.info("data return from lua is:" data);
运行结果如下:
代码语言:javascript复制hello
data from java is:I'am from Java!
八月 07, 2022 5:31:25 下午 com.tw.login.tools.Logger info
信息: lua return data:haha
欢迎加入我的知识星球,一起探讨架构,交流源码。加入方式,长按下方二维码噢:
已在知识星球更新源码解析如下:
最近更新《芋道 SpringBoot 2.X 入门》系列,已经 101 余篇,覆盖了 MyBatis、Redis、MongoDB、ES、分库分表、读写分离、SpringMVC、Webflux、权限、WebSocket、Dubbo、RabbitMQ、RocketMQ、Kafka、性能测试等等内容。
提供近 3W 行代码的 SpringBoot 示例,以及超 4W 行代码的电商微服务项目。
获取方式:点“在看”,关注公众号并回复 666 领取,更多内容陆续奉上。
代码语言:javascript复制文章有帮助的话,在看,转发吧。谢谢支持哟 (*^__^*)