DIV CSS 佈局教程網

zTree 角色權限樹實戰:新增授權與編輯回顯的完整解法
編輯:JQuery入門技巧     

後台系統做權限管理,角色與功能點的對應關係幾乎都要靠一棵樹來呈現。zTree 在這塊算是老牌選手,但真正容易卡住的地方往往不是「新增授權」,而是「編輯時怎麼把已勾選的權限原樣還原」。下面把整個流程完整走一遍,順便記錄幾個踩過的坑。

一、新增角色:一次性載入全部權限

專案裡的權限總量並不多,因此沒有做懶加載,直接把整棵樹拉回前端渲染即可。

1. 引入資源

先在頁面裡載入 zTree 的樣式表與腳本檔:

<link rel="stylesheet" href="js/ztree/zTreeStyle.css">
<script src="js/ztree/jquery.ztree.all-3.5.js"</script>

2. 準備容器

樹要掛在哪裡,就先留一個空的 ul:

<ul id="functionTree" class="ztree"></ul>

3. 前端腳本

以下程式碼同時整合了 layer 彈窗提示,方便統一操作回饋:

<script>
$(function() {
    // 授權樹初始化設定
    var setting = {
        data: {
            key: { title: "t" },
            simpleData: { enable: true }
        },
        check: { enable: true }   // 啟用核取方塊
    };

    $.ajax({
        url: '${pageContext.request.contextPath}/rest/sys/getAllFunction',
        type: 'get',
        dataType: 'json',
        success: function(data) {
            // data 為後端回傳的權限節點集合,直接初始化
            $.fn.zTree.init($("#functionTree"), setting, data);
        },
        error: function(msg) {
            alert('樹加載異常!');
        }
    });

    // 點擊「確定新增」
    $("#btn_submit").click(function() {
        if (checkHousetype()) {
            var treeObj = $.fn.zTree.getZTreeObj("functionTree");
            var nodes = treeObj.getCheckedNodes(true);  // 取出所有被勾選的節點

            // 把節點 id 拼成以逗號分隔的字串
            var array = [];
            for (var i = 0; i < nodes.length; i++) {
                array.push(nodes[i].id);
            }
            $("input[name=funcitonIds]").val(array.join(","));

            var formData = new FormData($("#formproject")[0]);
            $.ajax({
                type: "POST",
                url: "${pageContext.request.contextPath}/rest/sys/addRole",
                data: formData,
                contentType: false,
                processData: false,
                statusCode: {
                    201: function() {
                        layer.msg('新增角色成功!', { icon: 6, time: 1500 }, function() {
                            location.href = "${pageContext.request.contextPath}/rest/sys/page/rolelist";
                        });
                    },
                    400: function() { layer.msg('提交的參數不合法', { time: 1500 }); },
                    500: function() { layer.msg('網絡異常,請稍候再試!', { time: 1500 }); }
                }
            });
        }
    });

    // 表單校驗
    function checkHousetype() {
        var flag = true;
        if ($("#code").val() == '') {
            flag = false;
            layer.msg('請輸入關鍵字', { time: 1500 });
            return flag;
        }
        if ($("#name").val() == '') {
            flag = false;
            layer.msg('請輸入角色名稱', { time: 1500 });
            return flag;
        }
        return flag;
    }
});
</script>

4. 後端節點結構

zTree 對節點欄位有固定約定,特別是 pId 必須有值,否則父子關係會錯亂:

private String id;
private String name;
private String code;
private String description;
private String pid;
private boolean isParent;

// zTree 組件要求的格式:父層為空時回傳 "0"
public String getpId() {
    return this.pid == null ? "0" : this.pid;
}
// ...其餘 getter / setter 省略

二、編輯角色:權限回顯

回顯的核心思路是:後端先撈出「全部權限」,再撈出「該角色擁有的權限」,然後在組裝 zTree 節點時,逐一判斷是否命中,命中就塞入 checked: true。

1. 前端:先取權限,再初始化樹

<script>
var zNodes;
var setting = {
    check: { enable: true },
    data: { simpleData: { enable: true } }
};

// 依角色 id 取得權限清單
function loadPower(roleId) {
    $.ajax({
        type: "post",
        url: "${pageContext.request.contextPath}/rest/sys/queryFunByRoleId",
        data: { "roleId": roleId },
        async: false,
        dataType: "json",
        success: function(data) {
            zNodes = data;
        }
    });
}

$(function() {
    var setting = {
        data: {
            key: { title: "t" },
            simpleData: { enable: true }
        },
        check: { enable: true }
    };

    $(document).ready(function() {
        var id = $("#roleId").val();
        loadPower(id);                                        // 先拿到帶 checked 標記的節點
        $.fn.zTree.init($("#functionTree"), setting, zNodes); // 再渲染,勾選狀態才會生效
    });

    // 提交編輯
    $("#btn_submit").click(function() {
        if (checkHousetype()) {
            var treeObj = $.fn.zTree.getZTreeObj("functionTree");
            var nodes = treeObj.getCheckedNodes(true);
            var array = [];
            for (var i = 0; i < nodes.length; i++) {
                array.push(nodes[i].id);
            }
            $("input[name=funcitonIds]").val(array.join(","));

            var formData = new FormData($("#formproject")[0]);
            $.ajax({
                type: "POST",
                url: "${pageContext.request.contextPath}/rest/sys/eidtRole",
                data: formData,
                contentType: false,
                processData: false,
                statusCode: {
                    201: function() {
                        layer.msg('編輯角色成功!', { icon: 6, time: 1500 }, function() {
                            location.href = "${pageContext.request.contextPath}/rest/sys/page/rolelist";
                        });
                    },
                    400: function() { layer.msg('提交的參數不合法', { time: 1500 }); },
                    500: function() { layer.msg('網絡異常,請稍候再試!', { time: 1500 }); }
                }
            });
        }
    });

    function checkHousetype() {
        var flag = true;
        if ($("#code").val() == '') { flag = false; layer.msg('請輸入關鍵字', { time: 1500 }); return flag; }
        if ($("#name").val() == '') { flag = false; layer.msg('請輸入角色名稱', { time: 1500 }); return flag; }
        return flag;
    }
});
</script>

順序很關鍵:一定要等 loadPower 拿到資料後再呼叫 zTree.init,反過來的話樹已經用空節點畫完,後續補上的 checked 屬性不會被套用。

2. Controller

/**
 * 編輯角色時,回顯該角色擁有的權限
 */
@RequestMapping(value = "queryFunByRoleId", method = RequestMethod.POST)
public ResponseEntity<List<Map<String, Object>>> queryFunByRoleId(String roleId) {
    try {
        if (StringUtils.isBlank(roleId)) {
            return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(null);
        }
        return ResponseEntity.ok(sysService.queryFunByRoleId(roleId));
    } catch (Exception e) {
        e.printStackTrace();
    }
    return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(null);
}

3. Service:組裝節點並標記勾選

原本想用 List.contains() 直接比對物件,但一直判定失敗,於是改成自己寫一個依 id 比對的方法,簡單可靠。

/**
 * zTree v3 回顯:初始化權限樹並拼接 treeNode 屬性
 */
@Transactional(readOnly = true)
public List<Map<String, Object>> queryFunByRoleId(String roleId) {
    List<AuthFunction> functions = queryAllAuthFunction();          // 全部權限
    List<AuthFunction> functionsByRoleId = findFunctionByRoleId(roleId); // 該角色權限

    List<Map<String, Object>> list = new ArrayList<>();
    for (int i = 0; i < functions.size(); i++) {
        Map<String, Object> map = new HashMap<>();
        AuthFunction fun = functions.get(i);
        map.put("id", fun.getId());
        map.put("pId", fun.getpId());
        map.put("name", fun.getName());
        map.put("isParent", fun.getIsParent());

        // 該節點是否屬於此角色,是則 checked = true
        if (functionsByRoleId != null && functionsByRoleId.size() > 0
                && ListIsContainsObj(functionsByRoleId, fun)) {
            map.put("checked", true);
        } else {
            map.put("checked", false);
        }
        list.add(map);
    }
    return list;
}

// 依 id 判斷清單中是否包含指定權限
private boolean ListIsContainsObj(List<AuthFunction> functions, AuthFunction fun) {
    if (fun == null || functions == null || functions.size() <= 0) {
        return false;
    }
    for (AuthFunction authFunction : functions) {
        if (fun.getId().equals(authFunction.getId())) {
            return true;
        }
    }
    return false;
}

小結

新增與編輯在資料流上的差別只有一處:編輯多了「先撈角色權限、再標記 checked」的步驟。把節點組裝邏輯抽成一個共用方法,兩種情境都能重複使用,後續要加半選狀態(chkDisabled 或父節點自動勾選)也會輕鬆很多。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved