当前位置：首页 > news >正文

LuaJava

news 2025/8/18 6:51:58

一、什么是LuaJava

LuaJava是一个Java脚本工具。该工具的目标是允许用Lua编写的脚本操纵用 Java开发的组件。LuaJava允许使用与访问Lua的本机对象相同的语法从Lua访问Java组件，而不需要任何声明或任何类型的预处理。

LuaJava还允许在Lua中实现任何Java接口，并将其作为参数传递给任何方法，当调用时，Lua中将调动等效函数，并将结果传递会Java。

LuaJava与Lua5.1的许可证相同，也就是说，它可以免费用于学术和商业目的。

二、Maven依赖引用

        <!-- https://mvnrepository.com/artifact/party.iroiro.luajava/luajava --><dependency><groupId>party.iroiro.luajava</groupId><artifactId>luajava</artifactId><version>4.0.2</version></dependency><!-- https://mvnrepository.com/artifact/party.iroiro.luajava/lua54 --><dependency><groupId>party.iroiro.luajava</groupId><artifactId>lua54</artifactId><version>4.0.2</version></dependency><!-- https://mvnrepository.com/artifact/party.iroiro.luajava/lua54-platform --><!--<dependency><groupId>party.iroiro.luajava</groupId><artifactId>lua54-platform</artifactId><version>4.0.2</version><type>pom</type></dependency>--><dependency><groupId>party.iroiro.luajava</groupId><artifactId>lua54-platform</artifactId><version>4.0.2</version><classifier>natives-desktop</classifier><scope>runtime</scope></dependency>

三、LuaJava包含两组Java API

围绕Lua C API的薄包装。因此，您需要对Lua C API有一些基本的了解。大多数API名称在驼峰命名法中被重命名，去掉lua_或luaL_前缀。

此外，如果您对API（这是Lua5.*版本之间的交叉点）不满意，可以通过Lua#getLuaNatives直接使用 Lua C API绑定。

更加Java话的API。这需要更少的Lua知识。请参阅Java API。

四、支持的Lua版本

支持的Lua版本有：Lua 5.1、Lua 5.2、Lua 5.3、Lua 5.4、LuaJ和LuaJIT。

五、Java API

Java API主要围绕着party.iroiro.luajava.Lua接口和party.iroiro.luajava.value.LuaValue接口设计。

首先，只需要使用以下任何构造函数获取Lua状态：

new Lua51()
new Lua52()
new Lua53()
new Lua54()
new LuaJit()
new LuaJ()

关闭状态：

Lua L = new Lua51();
// Operations
L.close();// Or
try (Lua J = new Lua51()) {// Operations
}

默认情况下，Lua状态仅由Java库加载。要使用string、table或coroutine，你需要显式打开这些库：

openLibraries 打开所有可用库；
openLibrary 打开指定的库；

要与Lua值交互，可以使用LuaValue接口或直接使用Lua C API绑定：

    @Testpublic void test(){try (Lua L = new Lua54()) {LuaValue[] returnValues = L.eval("return { a = 1 }, 1024, 'my string value'");assertEquals(3, returnValues.length);assertEquals(1, returnValues[0].get("a").toInteger());assertEquals(1024, returnValues[1].toInteger());assertEquals("my string value", returnValues[2].toString());}}

获取全局变量、设置全局变量：

    @Testpublic void getGlobalVar(){try(Lua lua = new Lua54()) {assertEquals("Lua 5.4", lua.get("_VERSION").toString());LuaValue value = lua.from(1);lua.set("a", value); // LuaValuelua.set("b", 2); // Java Integerlua.set("c", new BigDecimal(3)); // Any Java objectassertEquals(6,lua.eval("return a + b + c:longValue()")[0].toInteger());}}

要从简单的 Java值创建LuaValue，请使用Lua::from(boolean/double/long/String) 或 Lua::fromNull().

@Testpublic void getLuaValues() {try (Lua L = new Lua54()) {LuaValue value = L.from(1);L.set("a", value); // LuaValueL.set("b", 2); // Java IntegerL.set("c", new BigDecimal(3)); // Any Java objectassertEquals(6,L.eval("return a + b + c:longValue()")[0].toInteger());}}

要运行Lua代码并获取返回值，请使用Lua::eval(String)

    @Testpublic void getEval() {try (Lua L = new Lua54()) {L.openLibraries();LuaValue[] values1 = L.eval("string.sub('abcdefg', 0, 3)");assertEquals(0, values1.length);LuaValue[] values2 = L.eval("return string.sub('abcdefg', 0, 3)");assertEquals("abc", values2[0].toString());}}

LuaValues实现了Java Map接口，并允许直接操作Lua tables.

    @Testpublic void getTable() {try (Lua L = new Lua54()) {L.run("t = { text = 'abc', children = { 'a', 'b', 'c' } }");LuaValue table = L.eval("return t")[0];// Get-calls return LuaValues.assertEquals("abc", table.get("text").toString());LuaValue children = table.get("children");// Indices are 1-based.assertEquals("a", children.get(1).toString());assertEquals(3, children.size());// Set-calls accept LuaValues or any Java object.children.set(4, "d");// Changes are done in the Lua side.L.run("assert(t.children[4] == 'd')");}}

调用lua函数（使用LuaValue::call(…)调用函数并返回 LuaValue）：

    @Testpublic void getLuaValue() {try (Lua L = new Lua54()) {L.openLibrary("string");LuaValue gsub = L.eval("return string.gsub")[0];LuaValue luaJava = gsub.call("Lua", "a", "aJava")[0];assertEquals("LuaJava", luaJava.toString());}}

使用LuaValue::toProxy创建java代理：

    @Testpublic void getRunnable() throws InterruptedException {try (Lua L = new Lua54()) {LuaValue runnable = L.eval("return { run = function() print('running...') end }")[0];Runnable r = runnable.toProxy(Runnable.class);Thread t = new Thread(r);t.start();t.join();}}