openWRT学习之LUCI之中的一个helloworld演示样例

备注1：本文 讲述的是原生的openWRT环境下的LUCI

备注2：本文參考了诸多资料。感谢网友分享。參考资料：

http://www.cnblogs.com/zmkeil/archive/2013/05/14/3078774.html

 

 

文章开篇：加入一个选项，该选项处理结果：显示hello world字串的网页

注：我们先将页面加入出来。然后我将分析怎样为什么这么加入的。

 

目的：在system菜单下加入一个名字为heyg1的选项，处理结果显示“hello world”

第一步：/usr/lib/lua/luci/controller/admin/system.lua中注冊选项：

entry({"admin", "system", "heyg1"}, template("heyg/heyg1"), _("heyg1"), 3).dependent=false

 

第二步：在view文件夹下加入对应的heyg1.htm文件

/usr/lib/lua/luci/view/heyg/heyg1.htm

Heyg.htm源代码为：

<%+header%>

<h1><%:hello world%></h1>

<%+footer%>

 

第三步：将上面文件加入完毕后，保存登录路由后台能够看到结果（有时可能须要又一次启动 路由）

 

 

分析为什么要这么加入（个人分析，不对相互讨论，勿喷）：

实际上我们看到的web界面，在luci下是以“树-结点”的方式存在：

第一步分析：

我们看到/usr/lib/lua/luci/controller/admin/下非常多*.lua文件，基本都是注冊模块，然后注冊“结点”，每一个lua文件都是一个结点生成文件（初学能够这么理解），正如我们web后台界面看到的：在后端system就是system.lua这个结点文件生成的。

所以我们须要在system.lua文件里通过entry()函数去注冊我们要加入的节点hey1

entry({"admin", "system", "heyg1"}, template("heyg/heyg1"), _("heyg1"), 3).dependent=false

 

Entry()函数分析：

參数一：插入的节点名字,如：{“admin”, “system”, “heyg1”},表示在admin下system中插入节点heyg1

參数二：插入的heyg1节点要做什么（动作时什么），通常有以下几种方式：

方式一：template方式。即调该节点会直接调用view下的对应htm文件

方式二：cbi/form方式。会调用model下的对应文件做对应的处理

方式三：call方式，会调用本文件或者导入文件的函数

其它方式：

Alias：表示链接到其它某个节点

这里template(“heyg/heyg1”)会调用view/heyg/heyg1.htm文件

參数三：插入节点在相应位置的名字，在web界面相应菜单中的显示名字

这里_(“heyg1”)，在web的菜单中显示为heyg1

參数四：插入结点的同等级的不同分类，或者说是差别同等级下的其它结点的数字代号

这里3，不能和同级别下的其它选项反复

在菜单中级别是从小到大的显示如：system（1）、Administration(2)、heyg1(3)....

 

Entry()函数的一些属性解析：对于插入一个结点，该结点除了有对应的名称和处理动作之外，它另一些对应的属性，我们能够手动的设置它的属性值类似于entry().dependent=false

官方文旦中给出下面属性：

dependent :当该节点的父节点丢失时。将该节点保护起来，不让它被意外调用

leaf:假设该节点下还有其它子节点，解析到该结点时。就不向下继续解析其子节点。

sysauth：在使用该节点时须要一个系统账户验证

I18n：定义了当求页面请求时。哪些文件会自己主动载入

其它属性（纯属自己推測，如有不正，多多不吝赐教，勿喷）：

Index:将该节点作为同级文件夹下的作为首页，或者说默认的第一个页面

 

能够參考luci官方文旦：

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

 

 

第二步分析：依据第一步分析，我们要在对应的view文件夹下加入我们的htm文件---直接调用