後台系統做權限管理,角色與功能點的對應關係幾乎都要靠一棵樹來呈現。zTree 在這塊算是老牌選手,但真正容易卡住的地方往往不是「新增授權」,而是「編輯時怎麼把已勾選的權限原樣還原」。下面把整個流程完整走一遍,順便記錄幾個踩過的坑。
專案裡的權限總量並不多,因此沒有做懶加載,直接把整棵樹拉回前端渲染即可。

先在頁面裡載入 zTree 的樣式表與腳本檔:
<link rel="stylesheet" href="js/ztree/zTreeStyle.css"> <script src="js/ztree/jquery.ztree.all-3.5.js"</script>
樹要掛在哪裡,就先留一個空的 ul:
<ul id="functionTree" class="ztree"></ul>
以下程式碼同時整合了 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>
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。
<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 屬性不會被套用。
/**
* 編輯角色時,回顯該角色擁有的權限
*/
@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);
}
原本想用 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 或父節點自動勾選)也會輕鬆很多。