详解在JAVA(J2ME)中使用Lua脚本引擎kahlua
在JAVA(J2ME)中使用Lua脚本引擎kahlua是本文要介绍的内容,主要是来学习JAVS中如何来使用LUA,Lua有幸被暴雪选中,在魔兽中大量应用,从而获得了极快的发展,Lua也因此成为游戏、软件开发中脚本语言的首选。Lua是一种十分简洁的脚本语言,不过写起来并不是很简单,当然过分的简化使得程序本身有些混乱。具体的语言教程在网上有很多,这里就不再说了。
kahlua最初是为J2ME设计的,现在已经扩展到J2SE,项目地址是http://code.google.com/p/kahlua/,在这里可以下载到源代码及编译好的jar包。在实际应用中我发现J2ME中导入jar包很困难,弄了好几天也没有成功,只好将源代码放在在工程的目录里一同编译。kahlua可以识别*.lua及*.lbc文件,*.lbc是编译后的lua文件,项目中一般使用这种文件,因为不会泄露lua文件的内容。可以到http://www.lua.org上下载一个lua的运行环境,安装后会自动添加安装路径到系统变量,此时在cmd中运行luac程序就可以编译脚本,命令是luac -o f.lbc d:\f.lua,详情看帮助文档。
我下的kahlua是kahlua-release-20090611.zip源代码包,解压后是一个Ant工程,将src目录下的内容及resource中的stdlib.lua(lbc)文件复制到J2ME项目中src下。在编程之前首先说明一点,在程序中指定文件的路径时要注意对应工程文件的位置。我的工程的src文件夹对应程序中的根目录,比如说上的/src/stdlib.lua在程序中就是/stdlib.lua。
lua脚本语言中一个独特的数据类型就是表,表其实就是java中的map、哈希表,比如说下面一个表:
T1 = {} -- 定义一个空表 T1[1]=10 --定义表的内容 T1["John"]={Age=27, Gender="Male"}
而每一个脚本文件实际上就是一个大表,每一个变量、方法都是表的成员,因此脚本的变量默认都是全局的,而且也可以定以方法为变量,kahlua正是依据这个概念来的。
1、初始化:
LuaState state=new LuaState(System.out); UserdataArray.register(state); OsLib.register(state); LuaCompiler.register(state);
se.krka.kahlua.vm.LuaState对象是kahlua引擎的核心,一切操作都由它来完成,在生成LuaState对象后再进行一些注册。
2、获取全局表:
LuaTable table=state.getEnvironment(); LuaTable有一系列函数添加、获取脚本内容,最常用的有: void rawset(Object key, Object value);//添加内容 Object rawget(Object key);//获取内容
3、加载脚本:
InputStream is=this.getClass().getResourceAsStream(scriptName); //scriptName为脚本文件的路径 LuaClosure closure=LuaCompiler.loadis(is , "lua" , table); //LoadCompiler为编译器,loadis为加载输入流的方法 //is为输入流;"lua"为编译器的名字,好像任意字符串都可以;table为全局表 //LuaClosure为脚本编译后的语句。
整个脚本编译后相当于一个大的方法,并将其添加到全局表。
4、执行脚本:
sate.call(closure, null); LuaState的public Object call(Object fun, Object[] args)
方法是用来执行全局表中的方法,前面说到,整个脚本编译后是作为一个方法存入全局表的,因此也可以用这个方法执行脚本。
5、方法:
public Object call(Object fun, Object[] args)中fun为函数对象,args为参数
(1)在Java中调用Lua方法
state.call( table.rawget("say") , new String[]{"Hello!"});
即从全局表中取出函数并执行。
(2)在Lua中调用Java方法
首先生成一个继承自JavaFunction接口的类,然后添加到全局表中
JavaFunction只有一个public abstract int call(LuaCallFrame callFrame, int nArguments)方法,其中callFrame用于获取输入参数及指定返回值,nArguments获取输入参数数量。返回值为返回参数的个数,因为lua函数可以有多个返回值的。
class JavaFunctionSay implements JavaFunction{ public int call(LuaCallFrame frame, int arg) { String str=BaseLib.rawTostring(frame.get(0));//获取输入参数 say(str);//执行对应Java内容 frame.push("result");//返回参数 return 1; } }
再用table.rawset("say", new JavaFunctionSay());添加到全局表,这样就可以在对应Lua脚本中使用say方法了。
附注:
kahlua显示中文有问题,应该是编码不正确,修改LexState中String newstring( byte[] chars, int offset, int len )方法的第一行编码为"GBK"后好像就可以了。
本人在windows中使用用luac生成的lbc时出错..文件不支持中文,有中文就会报错,而英文就能顺利通过,想来可能和字符编码有关系...想在lbc中使用中文,本人的方法是:
File luascript = new File("E:\\getWeather.lua");//--其实什么后缀名无所谓的 File lbcscript=new File("C:\\Users\\信丰boy\\getWeather.lbc"); closure = LuaCompiler.loadis(new FileInputStream(luascript), "信丰boy",table);//"信丰boy"这个字符串是可以随意的.其作用是表示作用域. OutputStream os=new FileOutputStream(lbcscript); closure.prototype.dump(os);//这样就把lbc格式的字节码文件写到"C:\\Users\\信丰boy\\getWeather.lbc"了. os.close();
当下次要调用的时候
File lbcscript=new File("C:\\Users\\信丰boy\\getWeather.lbc"); closure = LuaPrototype.loadByteCode(new FileInputStream(lbcscript), table);