LUCI自行定义表单处理

小小前言

前一章里我阐述了利用LUCI的自身机制实现表单的构建及配置的读取，如今我来讲一下自行构建表单进行提交处理的方法。我的认为，掌握了这个，才不会被LUCI的架构所局限。刚接触那会，我是花了蛮长的时间才弄通了这一点，也由于在网上没找到什么资料，因此想把本身的经验写下来，也但愿能帮到你们。

具体步骤以下：

1. 肯定配置文件
2. 编写路由
3. 创建表单
4. 编写处理方法

1. 肯定配置文件

这一个在前一章也有说过，你们能够先看看个人这一篇文章：
LUCI 使用其原有机制的创建新的页面

这里咱们仍然沿用以前的network配置的interface那项配置就好：

config interface testnets
    option ifname 'testnet'
    option type 'test'
    option ipaddr '192.168.1.1'
    option net '192.168.251.1'

2. 编写路由

我的习惯，我喜欢先定好路由规则再往下写。你们如果不想后面二进宫，那么能够先进行第3步。
话很少话，接下来咱们到luci/controller/admin/net.lua里编写路由：

module luci.controller.admin.net
function index()
    entry({"admin", "testnet", "form"}, template("test/form"), translate("Form"), 12)    -- 表单加载页面路由
   entry({"admin", "testnet", "control"}, call("form"), nil) 
end

3. 创建表单

好了，到了创建表单的时间。相信作过WEB开发的人都知道表单如何创建，其实就是一个HTML页面。但LUCI这里有所不一样，用的是htm文件，但基本语法是同样的，因此不用担忧。
好了，咱们接下来简单写一下咱们的表单页面，页面的文件路径是在luci/view/test/下的form.htm（由于以前路径定义了template("test/form)这一句）：

<%+header%>
<%
    local cbi = require 'luci.model.uci'
    
    local row = cbi:get("network", "testnets")
%>
<form action="<%=url("admin", "testnet", "control")%>" method="post">
<div><label>Ifname: </label><span><input type="text" name="ifname" value="<%=row.ifname%>"/></span></div>
<div><label>Type: </label><span><input type="text" name="type" value="<%=row.type%>"/></span></div>
<div><label>ipaddr: </label><span><input type="text" name="ipaddr" value="<%=row.ipaddr%>"/></span></div>
<div><label>Net: </label><span><input type="text" name="net" value="<%=row.net%>"/></span></div>
<input type="submit" value="提交" />
</form>
<%+footer%>

在表单里有几点我想说一下：

• 在LUCI里的视图层（也就是view层），是能够嵌套LUCI的代码的，跟PHP也能在HTML页面嵌套代码同样，LUCI使用<%%>这个符号做为LUCI代码在.htm嵌套代码的起始和结尾符；
• <%+header%>和<%+footer%>这两个是加载头和尾文件的，至关于PHP的include方法。加载的文件是在视图文件夹之下，即luci/view/header.htm 和 luci/view/footer.htm两个文件
• 表单里的action使用的luci自带的路径生成函数url(),写法与控制器里的entry()函数的第一个参数写法一致；
• 由于LUCI主要的功能是对配置文件进行存取，而取这一点的体现就在于view层的页面上，因此咱们须要将其取出来就要使用LUCI的代码。不管存取，咱们都须要用到LUCI的uci接口，也就是加载里的luci.model.uci；
• uci接口的具体内容在它的是官方接口里有的具体的说明，不过我的以为它没有实例，看得会比较吃力，但如果理解了LUCI的机制并用过一两个接口以后就能比较好地掌握了；
• 这里用到的是uci的get()接口，在官方的描述是这样的：

Uci:get (config, section, option)       
     Get a section type or an option
Parameters
    config: UCI config
    section: UCI section name
    option: UCI option (optional)
    
Return value:
    UCI value

uci:get(config, sectionType/sectionName[, optionType])接口获取一个section或option
section如果只有类型（如： config interface）第二个参数就是 section的类型，如interface
section如果有name名（如： config interface 'testnets'），则第二个参数则写testnets，即section的name名。
如果多有个相同类型的 section存在，获取其中的某个 section须要获取到单个interface的ID，这个ID的获取如果用LUCI的传统方式则可以经过每一行的控件或是tr的标签id中获取。
多个同类型的 section我的建议使用uci:foreach(config, sectionType, callbackFun)接口

Uci:foreach (config, type, callback)
    Call a function for every section of a certain type.
Parameters
    config: UCI config
    type: UCI section type
    callback: Function to be called
Return value:
    Boolean whether operation succeeded

3. 书写处理函数

刚接触LUCI，其实最令我感到难如下手的就是用法，本人C语言比较薄弱一些，LUCI的语法比较绕啥的，看得比较晕，研究了好些天，勉强看懂了它的基本语法，再加上LUCI官方接口文档，才算是找到了点感受。
[尴尬地笑]不发牢骚了，接下来编写处理这个表单内容的代码：

function form()
    local cbi = require 'luci.model.uci'
    local h = require 'luci.http'
    local dsp = require 'luci.dispatcher'
    
    local ifname = h.formvalue("ifname")
    local in_type = h.formvalue("type")
    local in_ipaddr = h.formvalue("ipaddr")
    local in_net = h.formvalue("net")
    cbi:delete("network", "testnets")
    cbi:section("network", "interface", "testnets", {
        ifname = ifname,
        type = in_type,
        ipaddr = in_ipaddr,
        net = in_net
    })
    cbi:save("network")
    cbi:commit("network")
    h.redirect(dsp.bulid_url("admin", "testnet", "form"))
end

• cbi:section(config, sectionType, sectionName/nil, {'...'})接口是创建新的section节点，该节点的参数有四个，第一个参数是config文件的文件名，第二个参数是section的type名，第三个参数是section的name名（如果没有，可为空），第四个参数是具体的配置项内容；
• 也许是我没找到替代方法的缘由，我对于接口的修改都是先删掉再新建。所以，须要调用先cbi:delete(config, section[, option])接口。该接口与前面获取section的uci:get()接口的使用方法一致。
• 在Linux使用过uci命令的童鞋应该会知道：section/option进行操做以后都须要commit才是完成了操做。而LUCI里也提供了uci:commit(config)接口，在LUCI里须要先保存再提交，即应该先调用uci:save(config)接口，再调用commit接口。

Uci:delete (config, section, option)
    Deletes a section or an option.
Parameters
    config: UCI config
    section: UCI section name
    option: UCI option (optional)
Return value:
    Boolean whether operation succeeded

Uci:section (config, type, name, values)
    Create a new section and initialize it with data.
Parameters
    config: UCI config
    type: UCI section type
    name: UCI section name (optional)
    values: Table of key - value pairs to initialize the section with
Return value:
    Name of created section

Cursor:save (config)
    Saves changes made to a config to make them committable.
Parameters
    config: UCI config
Return value:
    Boolean whether operation succeeded

Cursor:commit (config)
    Commit saved changes.
Parameters
    config: UCI config
Return value:
    Boolean whether operation succeeded

至此，咱们本身进行section的存取操做就完成了。加上上一章，好像内容说得比较啰嗦，由于写技术文写得很少，还请见谅；同时也是由于我以为这些经验都是挺重要的，因此写了下来。LUCI我接触的时间并不长，有说明不清或者错误地方，欢迎你们不吝指出~
但愿本文能帮到你们，也但愿能于你们多多交流！