luci页面“save&apply”的实现分析

页面上配置的“保存&应用”功能的实现:

最终调用到/etc/config/ucitrack的配置文件。

例如配置无线时,对应ucitrack配置文件中的
config network
    option init network
    list affects dhcp
    list affects radvd

config wireless
    list affects network   // 更改无线参数时,会影响network相关的配置,会重新调用其初始化脚本initscript
段部分

问题一、那么如何添加到ucitrack配置文件中的呢?
答:是通过uci-defaults手动添加的。
搜索一下可以发现:
./feeds/packages/net/mwan3-luci/files/etc/uci-defaults
./feeds/oldpackages/net/wing/files/etc/uci-defaults
./feeds/luci/i18n/portuguese-brazilian/root/etc/uci-defaults
./feeds/luci/i18n/hungarian/root/etc/uci-defaults
./feeds/luci/i18n/ukrainian/root/etc/uci-defaults
./feeds/luci/i18n/hebrew/root/etc/uci-defaults
./feeds/luci/i18n/vietnamese/root/etc/uci-defaults
./feeds/luci/i18n/catalan/root/etc/uci-defaults
./feeds/luci/i18n/german/root/etc/uci-defaults
./feeds/luci/i18n/norwegian/root/etc/uci-defaults
./feeds/luci/i18n/english/root/etc/uci-defaults
./feeds/luci/i18n/chinese/root/etc/uci-defaults
./feeds/luci/i18n/greek/root/etc/uci-defaults
./feeds/luci/i18n/spanish/root/etc/uci-defaults
./feeds/luci/i18n/russian/root/etc/uci-defaults
./feeds/luci/i18n/polish/root/etc/uci-defaults
./feeds/luci/i18n/romanian/root/etc/uci-defaults
./feeds/luci/i18n/japanese/root/etc/uci-defaults
./feeds/luci/i18n/malay/root/etc/uci-defaults
./feeds/luci/i18n/french/root/etc/uci-defaults
./feeds/luci/i18n/swedish/root/etc/uci-defaults
./feeds/luci/i18n/italian/root/etc/uci-defaults
./feeds/luci/i18n/portuguese/root/etc/uci-defaults
./feeds/luci/themes/freifunk-bno/root/etc/uci-defaults
./feeds/luci/themes/openwrt/root/etc/uci-defaults
./feeds/luci/themes/bootstrap/root/etc/uci-defaults
./feeds/luci/themes/freifunk-generic/root/etc/uci-defaults
./feeds/luci/applications/luci-mmc-over-gpio/root/etc/uci-defaults
./feeds/luci/applications/luci-meshwizard/root/etc/uci-defaults
./feeds/luci/applications/luci-ushare/root/etc/uci-defaults
./feeds/luci/applications/luci-hwmqos/root/etc/uci-defaults
./feeds/luci/applications/luci-hd-idle/root/etc/uci-defaults
./feeds/luci/applications/luci-wshaper/root/etc/uci-defaults
./feeds/luci/applications/luci-p910nd/root/etc/uci-defaults
./feeds/luci/applications/luci-p2pblock/root/etc/uci-defaults
./feeds/luci/applications/luci-upnp/root/etc/uci-defaults
./feeds/luci/applications/luci-olsr/root/etc/uci-defaults
./feeds/luci/applications/luci-ser2net/root/etc/uci-defaults
./feeds/luci/applications/luci-polipo/root/etc/uci-defaults
./feeds/luci/applications/luci-statistics/root/etc/uci-defaults
./feeds/luci/applications/luci-backdoor/root/etc/uci-defaults
./feeds/luci/applications/luci-watchcat/root/etc/uci-defaults
./feeds/luci/applications/luci-ahcp/root/etc/uci-defaults
./feeds/luci/applications/luci-freifunk-diagnostics/root/etc/uci-defaults
./feeds/luci/applications/luci-vnstat/root/etc/uci-defaults
./feeds/luci/applications/luci-radvd/root/etc/uci-defaults
./feeds/luci/applications/luci-minidlna/root/etc/uci-defaults
./feeds/luci/applications/luci-transmission/root/etc/uci-defaults
./feeds/luci/applications/luci-asterisk/root/etc/uci-defaults
./feeds/luci/contrib/uci/hostfiles/bin/uci-defaults
./feeds/luci/contrib/package/freifunk-common/files/etc/uci-defaults
./feeds/luci/contrib/package/freifunk-gwcheck/root/etc/uci-defaults
./feeds/luci/contrib/package/freifunk-mapupdate/root/etc/uci-defaults
./feeds/luci/contrib/package/freifunk-policyrouting/files/etc/uci-defaults
./build_dir/target-mips_34kc_uClibc-0.9.33.2/root-ar71xx/etc/uci-defaults

查看 ./feeds/luci/i18n/chinese/root/etc/uci-defaults 文件,可以看到
文件内容如下:
#!/bin/sh
uci batch <<-EOF
   set luci.languages.zh_cn=chinese
   commit luci
EOF
利用uci命令,配置了两条,
1) uci set luci.languages.zh_cn=chinese  配置了/etc/config/luci中的languages
2) uci commit luci 提交luci的更改
这个并没有使用到ucitrack配置文件。

再看另外一个 ./feeds/luci/applications/luci-hwmqos/root/etc/uci-defaults 文件,可以看到
文件内容如下:
#!/bin/sh

#add service depends

uci -q batch <<-EOF >/dev/null
          delete ucitrack.@hwmqos[-1]
          add ucitrack hwmqos
          set ucitrack.@hwmqos[-1].init=hwmqos
          commit ucitrack  
EOF

rm -f /tmp/luci-indexcahe
exit 0
利用uci命令,批量配置了如下命令:
1)uci delete ucitrack.@hwmqos[-1]  删除ucitrack配置文件中的hwmqos相关内容
2)uci add ucitrack hwmqos     增加ucitrack配置文件中的hwmqos
3)uci set ucitarck.@hwmqos[-1].init=hwmqos  相关的起始脚本(initscript)为/etc/init.d/hwmqos
4)uci commit ucitrack  提交变更的文件

问题二、配置文件中的affects干嘛用?
答:其实直接作用就是查找到相关的配置文件,再根据配置文件找到相关的起始脚本。当配置变更时,重新启用脚本。

关于affects 在uci.lua中定义如下:

-- Return a list of initscripts affected by configuration changes.
-- 返回一些跟此配置更改相关的初始化脚本列表,
function Cursor._affected(self, configlist)
   configlist = type(configlist) == "table" and configlist or {configlist}

local c = cursor()
 c:load("ucitrack")

-- Resolve dependencies
 -- 分解依赖情况
 local reloadlist = {}

local function _resolve_deps(name)
  local reload = {name}
  local deps = {}

c:foreach("ucitrack", name,
   function(section)
    if section.affects then
     for i, aff in ipairs(section.affects) do
      deps[#deps+1] = aff         -- 将依赖的配置文件保存到deps数组中去(本例中是将network保存进去)
     end
    end
   end)

for i, dep in ipairs(deps) do
   for j, add in ipairs(_resolve_deps(dep)) do
    reload[#reload+1] = add      -- 将所有依赖列表保存到一个数组reload中去(此处wireless只有一个依赖项affects,就是network)
   end
  end

return reload
 end

-- Collect initscripts
 -- 搜集初始化脚本
 for j, config in ipairs(configlist) do
  for i, e in ipairs(_resolve_deps(config)) do
   if not util.contains(reloadlist, e) then   -- 检测包reloadlist中是否含配置文件(cofig),若有包含,将其加入到reloadlist数组中
    reloadlist[#reloadlist+1] = e   
  end
 end

return reloadlist
end 
 
 
问题三、html页面“save&apply”如何实现的

通过调用"cbi.apply"最后调用到uci.lua脚本中的Cursor.apply.

其实现过程为:

--- Applies UCI configuration changes
-- @param configlist  List of UCI configurations
-- @param command   Don't apply only return the command
function Cursor.apply(self, configlist, command)
 configlist = self:_affected(configlist)
 if command then
      return { "/sbin/luci-reload", unpack(configlist) }    // 调用luci-reload
 else
  return os.execute("/sbin/luci-reload %s >/dev/null 2>&1" % table.concat(configlist, " "))   // 调用luci-reload
 end
end

从函数apply可以看出,均是调用luci-reload。

问题四、luci-reload的实现过程,luci-reload是个shell脚本。

#!/bin/sh
. /lib/functions.sh

apply_config() {
 config_get init "$1" init             
 config_get exec "$1" exec
 config_get test "$1" test

echo "$2" > "/var/run/luci-reload-status"     // 将状态写入到临时文件中

[ -n "$init" ] && reload_init "$2" "$init" "$test"   // 若ucitrack配置文件中init相关参数存在,则进行reload_init
 [ -n "$exec" ] && reload_exec "$2" "$exec" "$test"  // 若ucitrack配置文件中exec相关参数存在,则进行reload_exec

}

reload_exec() {
 local service="$1"
 local ok="$3"
 set -- $2
 local cmd="$1"; shift
 
 [ -x "$cmd" ] && {     // cmd具有可执行权限
  echo "Reloading $service... "
  ( $cmd "$@" ) 2>/dev/null 1>&2   // 执行 “cmd +所有参数”
  [ -n "$ok" -a "$?" != "$ok" ] && echo '!!! Failed to reload' $service '!!!'   // 若执行失败,则打印消息
 }
}

reload_init() {
 [ -x /etc/init.d/$2 ] && /etc/init.d/$2 enabled && {
  echo "Reloading $1... "
  /etc/init.d/$2 reload >/dev/null 2>&1     // 执行脚本的 reload
  [ -n "$3" -a "$?" != "$3" ] && echo '!!! Failed to reload' $1 '!!!'    // 若执行失败,则打印消息
  }
}

lock "/var/run/luci-reload"            // 1、防止多个线程同时调用luci-reload脚本,加锁

config_load ucitrack                    // 2、加载配置文件/etc/config/ucitrack

for i in $*; do              
 config_foreach apply_config $i $i  // 3、遍历所有相关配置和文件,进行重新初始化相关进程
done

rm -f "/var/run/luci-reload-status" // 删除luci-reload-status状态文件
lock -u "/var/run/luci-reload"         // 解锁

===========================================

2017年1月16日补充:

整个实现过程如下:

(1)页面上有"Save & Apply"的功能选项的页面,在单击按钮时,会调用到"changes.htm"页面。页面中关于按钮定义如下:

<form class="inline" method="get" action="<%=controller%>/admin/uci/saveapply">
             <input type="hidden" name="redir" value="<%=pcdata(luci.http.formvalue("redir"))%>" />
           <input class="cbi-button cbi-button-save" type="submit" value="<%:Save & Apply%>" />
      </form>

对应的动作为 ../admin/uci/saveapply

(2)打开对应的 uci.lua文件,可以看到 saveapply对应的定义如下:

entry({"admin", "uci", "saveapply"}, call("action_apply"), _("Save & Apply"), 10).query = {redir=redir}

action_apply()函数实现如下:

    function action_apply()
       local path = luci.dispatcher.context.path
       local uci = luci.model.uci.cursor()
       local changes = uci:changes()
       local reload = {}

    -- Collect files to be applied and commit changes
       for r, tbl in pairs(changes) do
          table.insert(reload, r)
          if path[#path] ~= "apply" then
             uci:load(r)
             uci:commit(r)
             uci:unload(r)
          end
        end

    luci.template.render("admin_uci/apply", {                    跳转到界面apply.htm
        changes = next(changes) and changes,
        configs = reload
      })
    end

(3)apply.htm中主要内容如下:

  <%+cbi/apply_xhr%>              添加页面 apply_xhr.htm
   <%+admin_uci/changelog%>           添加页面 changelog.htm

  <%- cbi_apply_xhr('uci-apply', configs) -%>    去掉调用脚本cbi_apply_xhr

(4)查看 apply_xhr.htm

上一篇:三、Jmeter生成HTML报告


下一篇:【JMeter】ant+jmeter生成html报告