初识Lua——OpenWrt路由界面配置

OpenWrt路由的界面配置使用LuCI系统管理。

在此，对其中的目录结构进行介绍：

-目录结构

以status模块为例进行说明，模块入口文件status.lua在目录lualucicontrolleradmin下。

function?index()

??? entry({"admin",?"status"},?alias("admin",?"status",?"overview"),?_("Status"),?20).index?=?true

??? entry({"admin",?"overview"},?template("admin_status/index"),?_("Overview"),0)">1)

??? entry({"admin",?"iptables"},?call("action_iptables"),?_("Firewall"),0)">2).leaf?=?true

??? ……

??? entry({"admin",?"processes"},?cbi("admin_status/processes"),?_("Processes"),0)">6)

……

end

?

在index()函数中，使用entry函数来完成每个模块函数的注册，官方说明文档如下：

?entry(path,target,title=nil,order=nil)

• path?is a table that describes the position in the dispatching tree: For example a path of {"foo","bar","baz"} would insert your node in foo.bar.baz.
• target?describes the action that will be taken when a user requests the node. There are several predefined ones of which the 3 most important (call,template,cbi) are described later on on this page
• title?defines the title that will be visible to the user in the menu (optional)
• order?is a number with which nodes on the same level will be sorted in the menu (optional)

?其中target主要分为三类：call，template和cbi。

call用来调用函数。

即语句entry({"admin",0)">2)

Firewall模块调用了action_iptables函数：

function?action_iptables()

????if?luci.http.formvalue("zero")?then

??? ??? ……

????end

end

?

template用来调用已有的htm模版，模版目录在lualuciview目录下。

即语句entry({"admin",0)">1)

调用了lualuciviewadmin_statusindex.htm文件来显示。

?

cbi语句使用cbi模块，这是使用非常频繁也非常方便的模块，在cbi模块中定义各种控件，Luci系统会自动执行大部分处理工作。其链接目录在lualucimodelcbi下。

显然语句entry({"admin",0)">6)

调用lualucimodelcbiadmin_statusprocesses.lua来实现模块。

?

这样我们可以发现，cbi模块可能是核心功能模块了，我们看看这个模块的使用。

-cbi模块

cbi模块包含的一系列lua文件构成界面元素的组合，所有cbi模块中的控件都需要写在luci.cbi.Map中。

在cbi.lua文件中封装了所有的控件元素，例如复选框，下拉列表等。

?

?常用控件的具体说明可以参照LuCI Documentation中的描述。

http://luci.subsignal.org/trac/wiki/Documentation/CBI

?

在此简单地举例Button来说明其应用

button?=?s:option(Button,?"_button",?"Button")

button.inputtitle?=?translate("exec")

button.inputstyle?=?"apply"

?

function?button.write(self,?section,?value)

??????? AbstractValue.write(self,?value)

????????local?listvalue?=?luci.fs.readfile("/etc/saveValue")

????????os.execute("touch /etc/testfile%s"?%{listvalue})

??????? self.inputtitle?=?translate("haha")

end

按钮的响应过程为：从saveValue文件中获取内容，然后以获取到的字符串命名创建新文件。

截一张学习测试界面时的图：

?

Lua语言也是这几天才开始接触，了解必然是有局限性的，wayne欢迎大神们的指导，希望能共同促进！?

?

?