UCI 方式开发 LUCI 模块

beyes

开发 LUCI 配置模块有多种方式，比较方便的是 UCI 方式。使用 UCI 接口使得在 LUCI 中无需考虑配置文件如何存储和读取，且在该方式下也会自动创建 “保存&应用”，“保存” 和 “复位” 3 个按钮，同时在 Bash 文件中也可以非常方便的存储和读取。


下面以只有一个单选框的例子来说明。

在 /usr/lib/lua/luci/model/cbi 下写一小段代码：

1. require("luci.sys")
   
2. 
   
3. m = Map("NoAD", translate("Advertisement killer"), translate("Advertisement Killer"))
   
4. 
   
5. s = m:section(TypedSection, "ifad", "")
   
6. s.addremove = false
   
7. s.anoymous = true
   
8. 
   
9. enable = s:option(Flag, "enable", translate("Enable"))
   
10. 
    
11. return m

复制代码

在 /etc/config/NoAD 下的配置文件就简单一句话：

1. config ifad

复制代码

在上面的 lua 代码中，Map() 函数的第 1 个参数就是对映射配置文件 NoAD 进行了映射。

m:section 中的 section 指定了 config ifad 中的 ifad 这个 section 。

当我们在 WEB 页面上的 “启用” 打勾并单击 “保存&应用” 按钮时，模块会自动作用到配置文件 NoAD 上，此时再查看该文件时，会看到：

# cat /etc/config/NoAD

config ifad
        option enable '1'

在 NoAD 上自动生成了 option enable '1' 这条配置语句。如果取消 “启用” 单选框的勾选时，该条配置语句会自动消失。这个结果正是由模块代码中的  s:option(Flag, "enable", translate("Enable")) 作用的。