概述
Wax是OC和Lua之间的黏合剂。也就是说,你可以在OC和Lua之间进行通信。
通过Wax,使用Lua访问Cocoa类如同在OC中一样简单。
NSString -- 返回 NSString
UIView -- 返回 UIView
UITableView -- 下面这一行的“语法糖”
wax.class["UITableView"]-- Wax原生调用,你不必了解
当年你创建OC实例时,不需要使用alloc,Wax会为你这样做。
-- 天啊,不需要alloc,retain 和 release了 !
local view = UIView.initWithFrame(CGRect(0, 0,100, 100))
用Lua创建OC类,使用函数waxClass{CLASS_NAME,PARENT_CLASS}。所有后续加入的函数(同一Lua文件中)都会自动添加为该类的实例方法。
waxClass{"MyClass",NSObject}
-- 声明协议
waxClass{"MyClass",NSObject, protocols = {"UITableViewDelegate","UITableViewDataSource"}}
-- 注意!协议名是字符串形式(因为它们并不是类)REMEMBER!
调用Lua函数时,使用{}而不是()(看waxClass函数的调用)。这是用一个Lua表来传递参数的“语法糖”。
-- 等同于第2句
waxClass{"MyClass", NSObject}
-- 大括号可以忽略,等同于第1句
waxClass({"MyClass", NSObject}) -- ...omitting the parenthesis ismuch more pretty, so that's how we roll.
对于waxClass函数,第1个参数总是self,以便用Wax模拟除OC的面向对象模型。
waxClass{"MyClass",NSObject}
-- 注意函数第1个参数为self。这就持有了MyClass实例对象
functionstoreWords(self, words)
self.words = words
-- Wax在self对象中创建了一个'super'的成员变量
-- 以便调用父类方法
self.super:words(self)
end
使用冒号 : 代替点号 . 来调用OC方法。这将把调用者自身作为第1个参数传给该方法。
--在Lua中,使用冒号 : 进行方法调用
UIApplication:sharedApplication()
--... 等同于
UIApplication.sharedApplication(UIApplication)
--使用冒号 : 是为了让代码变得简单和可读
如果OC 方法有多个参数,用下划线 _ 代替冒号 : 。
在OC中
[UIAlertView initWithTitle:@"title"message:@"message" delegate:nil];
使用Wax
UIAlertView:initWithTitle_message_delegate("title","message", nil)
Wax不使用OC属性。它强制Lua和OC只通过方法调用来通信
someView.frame -- 这样不行
-- 只能用 getter/setter 方法
someView:frame()
someView:setFrame(someFrame)
通过点号. 可以为对象动态创建成员变量。不同于冒号 : (用于调用OC的类/实例方法),在 Lua 代码中点 . 能够动态创建成员变量(在对象的 OC 代码中则完全不知道这些变量)。这些成员变量在对象生命周期中是有效的。
--在Lua中用冒号: 进行方法调用…
localview = UIView:init()
view.someRandomVariable= "YEAH!"
--你能把任何对象赋值给一个实例,它会一直存在
Wax视图将OC对象转换为Lua原始类型。反之亦然,如果OC方法有一个NSString参数,你直接传递一个Lua字符串给它。
local fileManager =NSFileManager:defaultManager()
local contents =fileManager:directoryContentsAtPath(".")
-- directoryContentsAtPath 返回一个 NSArray, 但 Wax 将之转换为 Lua table
print(contents[1]) --> "info.plist"
-- NSDictionaries 变成 Lua tables
-- NSArrays 变成Lua tables
-- NSStrings 变成Lua strings
-- NSNumbers 变成Lua numbers
如果你不象OC对象被自动转换,则可以使用toobjc方法。
-- 如果你这样调用NSString的方法是不行的
local string = "astring"
string:capitalizedString()
-- 这是因为string已经被强制转换为Luastring了
-- 使用toobjc,避免NSString被强制转换为Luastring
toobjc(string):capitalizedString()
枚举类型,比如UITableViewStylePlain,已经被硬编码了。目前,大部分常用枚举定义在APP_ROOT/wax/stdlib/enums.lua中。以后我希望在iPhone中使用桥接的方式以便枚举和结构能动态创建。
要传递一个selector,直接使用字符串。例如在OC中,selector被写成@selector(this:is:a:method),在Wax写成this:is:a:method即可。
结构体也同枚举一样。最常用的结构体都声明在APP_ROOT/wax/wax-scripts/structs.lua中。根据structs.lua文件中的模板很容易添加新的结构体。
wax.struct.create("CGRect","ffff", "x", "y", "width","height")
-- 创建一个全局函数叫做CGRect,带有4个float参数
-- 第2个参数"ffff"定义了4个参数的类型
local rect = CGRect(1, 2, 3, 4)
print(rect.x) --> 1
rect.x = 200
print(rect.x) --> 200
网友评论