Lua中的模块与module函数详解

很快就要开始介绍lua里的“面向对象”了，在此之前，我们先来了解一下lua的模块。

1.编写一个简单的模块

lua的模块是什么东西呢？通常我们可以理解为是一个table，这个table里有一些变量、一些函数…

等等，这不就是我们所熟悉的类吗？

没错，和类很像（实际上我说不出它们的区别）。
 
我们来看看一个简单的模块，新建一个文件，命名为game.lua，代码如下：

game = {}
function game.play()
    print("那么，开始吧");
end
function game.quit()
    print("你走吧，我保证你不会出事的，呵，呵呵");
end
return game;

我们定义了一个table，并且给这个table加了两个字段，只不过这两个字段的值是函数而已。

至于如何使用模块，那就要用到我们之前介绍过的require了。
 
我们在main函数里这么使用：

local function main()
    cc.fileutils:getinstance():addsearchpath("src")
    game = require("game");
  
    game.play();
end

注意，我们要require其他文件的时候，要把文件路径给设置好，否则会找不到文件。
因为我使用的是cocos code ide，直接调用addsearchpath函数就可以了，我的game.lua文件是在src目录下的。
 
好了，运行代码，结果如下：

[lua-print] 那么，开始吧

ok，这就是一个很简单的模块，如果我们习惯了java、c++等面向对象语言，那也可以简单地把模块理解为类。

2.为以后的自己偷懒——避免修改每个函数中的模块名

假设我们想把刚刚的game模块改个名字，改成eatdaddygame，那么，我们需要做以下两件事情：

1).修改game.lua的文件名
2).修改game.lua的内容，把所有的game改成eatdaddygame
 
目前的game.lua函数还算少，就两个，实际上一个模块的函数肯定不会少的，那么，要这么去改这些函数，太烦了。

如果批量修改，又怕有哪个地方改错。

于是，我们可以这么偷懒：

game = {}
local m = game;
function m.play()
    print("那么，开始吧");
end
function m.quit()
    print("你走吧，我保证你不会出事的，呵，呵呵");
end
return m;

我们用一个局部变量m来代替了game，于是，以后我们只需要修改前面两个的game就可以了，函数部分的内容完全不需要去修改。

这个偷懒其实蛮有用的，某些情况下，修改越少，越安全~

3.更进一步的偷懒——模块名参数

实际上，我们可以更加得偷懒，以后修改模块名，只需要修改模块的文件名就可以了，文件内容可以不管，具体怎么实现？

看代码：

local m = {};
local modelname = ...;
_g[modelname] = m;
function m.play()
    print("那么，开始吧");
end
function m.quit()
    print("你走吧，我保证你不会出事的，呵，呵呵");
end
return m;

留意一下，这里有一个 local modelname = …
“…”就是传递给模块的模块名，在这里其实就是“game”这个字符串。
 
接着，有点微妙了，还记得之前介绍的全局环境_g吗？我们以”game”作为字段名，添加到_g这个table里。

于是，当我们直接调用game的时候，其实就是在调用_g["game"]的内容了，而这个内容就是这里的m。
 
能逻辑过来吗？就是这么简单，在你没有忘记_g的前提下~

4.利用非全局环境制作更简洁和安全的模块

如果说，刚刚已经达到了我们作为高(ai)智(zhe)商(teng)人群的巅峰，那，你就太天真了。

巅峰就是要拿来超越的，还记得我们的非全局环境吗？就是那个setfenv函数。
 
我们来看看下面的代码：

local m = {};
local modelname = ...;
_g[modelname] = m;
setfenv(1, m);
function play()
    print("那么，开始吧");
end
function quit()
    print("你走吧，我保证你不会出事的，呵，呵呵");
end
return m;

我们把game.lua这个模块里的全局环境设置为m，于是，我们直接定义函数的时候，不需要再带m前缀。

因为此时的全局环境就是m，不带前缀去定义变量，就是全局变量，这时的全局变量是保存在m里。

所以，实际上，play和quit函数仍然是在m这个table里。
 
于是，我们连前缀都不用写了，这真是懒到了一个极致，简直就是艺术~

另外，由于当前的全局环境是m，所以， 在这里不需要担心重新定义了已存在的函数名，因为外部的全局变量与这里无关了。
 
当然，如果大家现在就运行代码，肯定会报错了。

因为我们的全局环境改变了，所以print函数也找不到了。

为了解决这个问题，我们看看第5条内容吧~

5.解决原全局变量的无法找到的问题——方案1

第一个方法，就是我们之前介绍过的，使用继承，如下代码：

local m = {};
local modelname = ...;
_g[modelname] = m;
-- 方法1：使用继承
setmetatable(m, {__index = _g});
setfenv(1, m);
function play()
    print("那么，开始吧");
end
function quit()
    print("你走吧，我保证你不会出事的，呵，呵呵");
end
return m;

没错，使用__index元方法就能解决这个问题了，当找不到print等函数时，就会去原来的_g里查找。

6.解决原全局变量的无法找到的问题——方案2

第二个方法更简单，使用一个局部变量把原来的_g保存起来，如下代码：

local m = {};
local modelname = ...;
_g[modelname] = m;
-- 方法2：使用局部变量保存_g
local _g = _g;
setfenv(1, m);
function play()
    _g.print("那么，开始吧");
end
function quit()
    _g.print("你走吧，我保证你不会出事的，呵，呵呵");
end
return m;

这种方法的缺点比较明显，那就是，每次调用print等函数时，都要使用_g前缀。

7.解决原全局变量的无法找到的问题——方案3

第三个方法比较繁琐，使用局部变量把需要用到的其他模块保存起来，如下代码：

local m = {};
local modelname = ...;
_g[modelname] = m;
-- 方法3：保存需要使用到的模块
local print = print;
setfenv(1, m);
function play()
    print("那么，开始吧");
end
function quit()
    print("你走吧，我保证你不会出事的，呵，呵呵");
end
return m;

这种方法的缺点更明显了，所有用到的模块都要用局部变量声明一次，烦人。
 
但，就速度而言，第三种方案比第二种方案快，第二种方法又比第一种快。
但至于快多少，我也不知道，只是理论上~我也没测试。

8.你就笑吧，但，我还想更加偷懒——module函数

本以为刚刚介绍的那些技巧已经够偷懒的吧？
但lua似乎知道我们有多懒似的，它竟然把我们把这一切都自动完成了。
再来回忆我们刚刚为了偷懒而写的几句代码：

local m = {};
local modelname = ...;
_g[modelname] = m;
setmetatable(m, {__index = _g});
setfenv(1, m);

就这几句代码，其实我们可以忽略不写，因为，我们有module函数，它的功能就相当于写了这些代码。
我们修改一下game.lua的内容，如下代码：

module(..., package.seeall);
function play()
    print("那么，开始吧");
end
function quit()
    print("你走吧，我保证你不会出事的，呵，呵呵");
end

注意，前面的几行代码都没了，只留下了一个module函数的调用。

module函数的调用已经相当于之前的那些代码了。

而package.seeall参数的作用就是让原来的_g依然生效，相当于调用了：setmetatable(m, {__index = _g});
 
再次留意一下，代码末尾的return m也不见了，因为module函数的存在，已经不需要我们主动去返回这个模块的table了。

9.结束

这篇结束的内容似乎有点多，我也写了一个多小时了。

其实我还省略不少东西，比如package.loaded，lua路径查找的规则等等。

因为这些cocos code ide，或者说是cocos2d-x lua，已经帮我们做了，我们不需要去管这些。

所以我就避重就轻了，啊不，是顾此失彼…不对~！反正，就是那个意思了~！