LUCI这个在百度上搜索除了一篇我的百度文库luci的介绍文章之外,前三页都是些不知所云的名词(足见百度在专业领域的搜索之烂),我却在大学毕业的大半年的大部分时间里与它纠结,由于开始的发懵到后来逐渐感觉到这家伙还很好玩的,现在就把我对luci的浅显认识介绍给大家。
:/
有关luci的各个方面,你几乎都可以从这里获得,当然,只是浅显的获得,luci的文档写的还算比较全,但是写的稍显简略,开始看的时候会有一点不知所措。
UCI熟悉openwrt的人都会有所了解,就是Uni fi ed Con fi guration Interface的简称,而luci 这个openwrt上的默认web系统,是一个独立的由严谨的德国人开发的web框架,是Lua Con fi guration Interface的简称,如果在您的应用里,luci是对openwrt的服务,我们就有必要做一下uci的简介,我这里就不说了,见链接:
le.hk/url?sa=t&source=web&cd=5&ved=0CEMQFjAE&url=http%3A%2F %2Fnbd.name%2Fopenwrt-fosdem-09.pdf&ei=h52iTcXvOcrMcJ-xxOwD&usg=AFQjCNGFhum CIgS5tK_mDJ2dDFU4qsskfQ
有的时候,我们开发的luci是在自己的Linux PC上开发,在普通的linux上,一般是没有uci命令的,为了开发方便,可以手动编译一下,方法见链接:
/viewtopic.php?id=15243
OK,之前罗里罗嗦的说了很多,现在就进入正题,进入正题的前提是你已经make install正确的安装了lua,luci,以及编译好链接了相关的so(如果你需要,比如uci.so nixio.so),以及make install正确web server,(我用的web server是thttpd,也编译过mongoose,lighttpd,在这三个之中,lighttpd是功能最完善的,mongoose是最小巧的)。
进入正题:
一:luci的启动
在web server中的cgi-bin目录下,运行luci文件(权限一般是755),luci的代码如下:1#!/usr/bin/lua--cgi的执行命令的路径
2require"luci.cacheloader"--导入cacheloader包
3require"i"--导入i包
4luci.dispatcher.indexcache="/tmp/luci-indexcache"--cache缓存路径地址
i.run()--执行run方法,此方法位于*/luci/sgi/cgi.lua中
run方法的主要任务就是在安全的环境中打开开始页面(登录页面),在run中,最主要的功能还是在dispatch.lua中完成。
运行luci之后,就会出现登录界面:
-bash-4.0#pwd
/var/www/cgi-bin
-bash-4.0#./luci
Status:200OK
Content-Type:text/html;charset=utf-8
Cache-Control:no-cache
Expires:0
<!DOCTYPE HTML PUBLIC"-//W3C//DTD HTML4.01//EN"
"/TR/html4/strict.dtd">
<html class="ext-strict"><head>
/*some html code*/
</html>
如果你成功的运行了luci就说明你的luci框架成功的跑了起来。
二:LUCI的MVC
1:用户管理:
在luci的说明了luci是一个MVC架构的框架,这个MVC做的可扩展性很好,可以完全的统一的写自己的html网页,而且他对shell的支持相当的到位,(因为luci 是lua写的,lua是C的儿子嘛,与shell是兄弟)。在登录界面用户名的选择很重要,luci是一个单用户框架,公用的模块放置在*/luci/controller/下面,各个用户的模块放置在*/luci/controller/下面对应的文件夹里面,比如admin登录,最终的页面只显示/luci/controller/admin下面的菜单。这样既有效的管理了不同管理员的权限。
2:controller文件夹下的lua文件说明:(以mini用户为例)
在mini目录下面,会有一个index.lua文件,简略的代码如下:
这个文件定义了node,最外面的节点,最上层菜单的显示等等。在其他的lua文件里,定义了其他菜单的显示和html以及业务处理路径。每个文件对应一个菜单相。
例如system.lua文件
mudel是对应文件的,function index定义了菜单,比如这一句entry({"mini","system", "reboot"},call("action_reboot"),i18n("reboot"),100)
第1项为菜单入口:
{"mini","system","reboot"},mini是最上层的菜单,即为用户项,system为一个具体的菜单,reboot为这个菜单的子菜单,如果reboot还需要加上子菜单的话,可以这样写:
php文章管理模块实例代码
entry({"mini","system","reboot","chreboot"},call("action_chreboot"),i18n("chreboot"),1),这样就会在reboot上产生一个新的子菜单,以此类推,可以产生N层菜单。
第二项为菜单对应的页面,可以是lua的源代码文件,也可以是html页面。
alias cgi form call等定义了此菜单相应的处理方式,form和cgi对应到model/cbi相应的目录下面,那里面是对应的定制好的html和lua业务处理。
alias是等同于别的链接,call调用了相应的action_function。还有一种调用,是template,是直接链接到view相应目录下面的htm页面。(说明:luci框架下面的htm都是可以嵌入lua 语句的,做业务处理,相当于jsp页面的内部的Java语句)。
问价查对应简介:
entry({"mini","system","reboot"},call("action_reboot"),i18n("reboot"),100):对应此文件的action_reboot function
entry({"mini","system","index"},cbi("mini/system",{autoapply=true}),i18n("general"),1):对应*/model/cbi/mini/system.lua{autoapply=true}这个失传的参数。
。。。。。
第三项为i18n显示,比如entry({"mini","system","reboot"},call("action_reboot"), i18n("reboot"),100),菜
单的名字为admin-core文件内的对应显示。此处也可以这样写,i18n("reboot","重启"),即直接做了国际化。菜单上显示的就是“重启”。
第四项为现实的顺序,这个数字越小,显示越靠前,靠上。
3:model业务处理和页面生成简介
我认为model的业务处理和html生成,是luci框架的精华,但是想用好它,最终扩展定义自己的页面也是最难的,但是一旦定义好了,后面的工作就会轻松高效简介统一,不失为一种好的解决方案。但是它又有缺点,就是写页面虽然统一,但是不够灵活。
下面以SimpleForm为例,讲解一下。
具体文件*/luci/model/cbi/passwd.lua
f=SimpleForm("password",translate("a_s_changepw"),translate("a_s_changepw1"))--调用SimpleForm页面当然还是I18N从中捣乱,看上去没那么直观,不理他
pw1=f:field(Value,"pw1",translate("password"))--SimpleForm里面加一个field至于SimpleForm和fiemd是什么,一会去看SimpleForm页面去
pw2=f:field(Value,"pw2",translate("confirmation"))
function pw2.validate(self,value,section)
return pw1:formvalue(section)==value and value
end
function f.handle(self,state,data)
if state==FORM_VALID then--这个就是业务处理了你懂得呵呵
local stat=luci.sys.user.setpasswd("admin",data.pw1)==0--root-->admin
if stat then
else
end
data.pw1=nil
data.pw2=nil
end
return true
end
return f
说明:(simpleForm位于view/cbi下面,可以研究一下,各个元素是如何定义的)
现在在给一个小例子:
以.*/luci/model/cbi/admin_system/version_manage.lua为例,介绍一下luci中web页面lua代码
6local h=loadfile("/usr/local/luci/help.lua")
7if h then
8h()
9end
10local help_txt=help_info and help_info.version
加载帮助帮助文件help.lua,关于loadfile()的用法可以查看lua的手册(我还没完全弄明白,先用了)
help_txt是一个全局变量
12appadmin_path="/usr/local/appadmin/bin/"
定义一个全局变量,其实跟功能跟宏一样,定义appadmin的绝对路径
14versionlist={}
15
16function getline(s)
.........
32end
33
34function get_versionlist()
68end
69
70versionlist=get_versionlist()
定义一个全局变量和两个函数,并初始化此变量
接下来就是和最终展现的Web页面直接相关的代码了,大部分都是对luci封装好的一些html 控件(代码)的使用和扩展。luci封装好的html控件
类可以在以下文件查看:./host/usr/lib/lua/luci/cbi.lua
71m=SimpleForm("version",translate("版本管理"))
72m.submit=false
74m.help=help_txt and true or false
75m.helptxt=help_txt or""
使用了一个SimpleForm的控件,SimpleForm实际上对应一个html表单,是整个页面最大的"容器",本页面内的绝大部分控件都处于SimpleForm内
,是它的子控件。我知道的可以做>页面最大"容器"的控件还有一个Map,但它需要./host/etc/config/目录下的一个配置文件,我没有使用。
submit reset是luci默认就封装好的一个属性,分别控制html表单的"提交""重置"按钮;help helptxt是我扩充的表单属性,分别控制web页面的
"帮助"功能和帮助内容。关于控件属
性的意义、实现和扩充可以按以下步骤进行:
在文件./host/usr/lib/lua/luci/cbi.lua中查控件名SimpleForm,然后可以到以下行plate="cbi/simpleform"这
表明SimpleForm的html模版文件为./host/usr/lib/lua/luci/view/cbi/simpleform.htm,通过研究simpleform.htm文件内容可以知道各属性的
功能以及模版中使用lua代码的方法,然后可以按类似的方法添加自定义的
属性。
77s=m:section(Table,versionlist)
新建了一个section,section内定义了一个表格类,versionlist是与其相关的变量(lua的所有变量都可归类于table类型)
与Table关联的table变量应该是这种结构的:
t={
row1={column1="xxx",column2="xxx",....},
row2={column1="xxx",column2="xxx",....},
row3={column1="xxx",column2="xxx",....},
row4={column1="xxx",column2="xxx",....},
}

版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。