介绍

当下多数在java下执行lua脚本的程序都是用了luajava。然而luajava存在一些严重的问题，它会将byte数组和string等同对待，而且它的反射执行效率比较低。为了弥补这些问题，我参考luajava，重写了它的java和jni代码，并以mLua为名重新发布。

特点描述

和luajava类似的，mLua也有内置的全局lua函数；java对象和lua对象可以通过jni层代码进行交换。但是mLua禁止lua直接操作java对象，如果想在lua中使用java对象，必须使用内置的全局函数实现。

mLua区分byte数组和string。在mLua中，java的byte数组对lua端而言，只是一个普通的userdata。

在跨语言数据交换的时候，string是被复制的，因此当一个string从lua传递到java后再于lua中修改它，它在java端的对应版本并不会随着改变。

将lua端的number传递给java后，会被优先解释为byte类型，否则将依照byte - short - int - long - float - double链条来尝试解释。

mLua不对外暴露lua解析器实例，所有的操作都基于MLua实例完成。

java端方法描述

mLua的java端方法集中在MLua中：

除此之外，JavaFunction也是使用者可能需要用到的接口。它表示一个lua函数的java实现。其回调方法execute(Object[])方法会传入从lua端输入的数据，并输出一个结果传回lua端。如果方法本身不需要返回数据，则返回null即可。

lua端函数描述

在mLua下，lua原来的require、print函数已经被改写。

require

require必须使用设置在java端的basedir为根目录的相对路径引用其他lua脚本：

require "dir1/dir2/script1"
require "script2"

print

支持输出一个或多个对象，但是不能将string与java对象作拼接：

-- 正确的做法 --
print("hello mLua")
print("context: ", getContext())
print("string " .. 111)

-- 错误的做法 --
print("context: " .. getContext())

通过逗号分隔的对象会在java端以tab号分隔显示

操作java对象

mLua也采用反射来操作java对象，不过mobTools的ReflectHelper具备缓存功能，理论上会比luajava每次直接反射更快。mLua提供了如下的内置函数：

例子

java端代码

public class MainActivity extends Activity {
    private MLua lua;

    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 构造一个解析器实例
        lua = new MLua();
        // 设置lua代码存放位置
        lua.setBasedir("/sdcard/mLua/LuaTest");
        // push全局对象
        lua.pushGlobal("getContext", new JavaFunction() {
            public Object execute(Object[] args) throws Throwable {
                return getApplication();
            }
        });
        try {
            // 启动解析器，设置main.lua为入口代码
            lua.start("main");
        } catch (Throwable e) {
            e.printStackTrace();
        }
    }

    protected void onDestroy() {
        // 关闭解析器
        lua.stop();
        super.onDestroy();
    }
}

lua端代码

-- 导入ReflectHelper.ReflectRunnable类，并命名为ReflectRunnable --
import("ReflectRunnable", "com.mob.tools.utils.ReflectHelper$ReflectRunnable")

local function main()
  -- 演示print和invoke --
  print("hello world from mLua")
  local context = getContext()
  print("current context: ", context)
  local packageName = invoke(context, "getPackageName")
  print("packageName: ", packageName)

  -- 演示java接口代理 --
  local luaCode = {
    run = function(arg)
      print("luaCode.run(), input: ", arg)
      return "yoyoyo"
    end
  }
  local proxy = createProxy(luaCode, "ReflectRunnable")
  local res = invoke(proxy, "run", packageName)
  print("luaCode.run(), output: ", res)

  -- 演示数组复制 --
  local bArray = new("[B", 16)
  for i = 0, 15 do
    set(bArray, "[" .. i .. "]", i + 1)
  end

  local bArray2 = new("[B", get(bArray, "length"))
  invokeStatic("System", "arraycopy", bArray, 0, bArray2, 0, 16)

  for i = 0, 15 do
    print("bArray2[" .. i .. "]: ", get(bArray2, "[" .. i .. "]"))
  end
end

main()

扩展

mLua默认只能从文件系统中加载lua代码，但是如果对MLua的setBasedir方法进行重写，以其他的方式实现SourceLoader，则可以加载任意方式的lua代码，包括assets中的，和加密的。