Wax框架简明教程(3)开始使用Wax

概述
这是Wax框架的一个快速教程。通过本教程，最终你会明白在OC中使用Wax是多么的有趣。
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