自定義標簽能把頁面裡重複的邏輯判斷抽出去,讓 JSP 只關心展示,同時也讓權限控制與視圖代碼徹底分離。本文以「按登錄用戶的權限決定是否輸出標簽體內容」為例,走一遍完整流程。
最終希望在頁面上這樣寫,只有具備對應資源的用戶才能看到標籤包裹的內容:
<wxt:per uri="${pageContext.request.contextPath }/privilege/list">
<a href="${pageContext.request.contextPath }/privilege/list">權限管理</a>
</wxt:per>
繼承 SimpleTagSupport(簡單標簽的標準做法),重寫 doTag():
package cn.com.liveuc.privilege.tag;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
import java.util.Set;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.PageContext;
import javax.servlet.jsp.tagext.SimpleTagSupport;
import cn.com.liveuc.privilege.model.Privilege;
import cn.com.liveuc.privilege.model.Resource;
import cn.com.liveuc.privilege.model.Role;
import cn.com.liveuc.privilege.model.User;
/**
* 自定義權限標簽
*/
public class PerssionTag extends SimpleTagSupport {
// 標簽屬性,用於接收傳入參數
private String uri;
public void setUri(String uri) {
this.uri = uri;
}
@Override
public void doTag() throws JspException, IOException {
// 取得用戶登錄後保存在 Session 中的對象
PageContext page = (PageContext) this.getJspContext();
User user = (User) page.getSession().getAttribute("login");
if (user != null) {
// 收集該用戶所有角色下的資源 uri
List<String> list = new ArrayList<String>();
Set<Role> role = user.getRole();
for (Role r : role) {
Set<Privilege> privilege = r.getPrivilege();
for (Privilege p : privilege) {
Set<Resource> res = p.getResource();
for (Resource re : res) {
list.add(re.getUri());
}
}
}
// 命中則輸出標簽體
for (String ur : list) {
if (ur.equals(uri)) {
this.getJspBody().invoke(null);
}
}
}
}
}
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<taglib xmlns="https://java.sun.com/xml/ns/j2ee"
xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
version="2.0"
xsi:schemaLocation="https://java.sun.com/xml/ns/j2ee
https://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd">
<description>自定義權限標簽庫</description>
<display-name>wxt tags</display-name>
<tlib-version>2.2.3</tlib-version>
<short-name>wxt</short-name>
<uri>/wxt</uri>
<tag>
<name>per</name> <!-- 標簽名 -->
<tag-class>cn.com.liveuc.privilege.tag.PerssionTag</tag-class>
<body-content>scriptless</body-content>
<attribute>
<name>uri</name> <!-- 屬性名 -->
<required>true</required> <!-- 是否必填 -->
<rtexprvalue>true</rtexprvalue> <!-- 是否支持運行時表達式 -->
</attribute>
</tag>
</taglib>
先在 JSP 頂部導入標簽庫:
<%@ taglib prefix="wxt" uri="/wxt" %>
然後即可像示例那樣使用 <wxt:per>,只有用戶權限包含該 uri 時,標籤體內容才會被輸出。
示例代碼能跑通,但有幾處值得優化。doTag() 中有一層多餘的循環:找到匹配就該直接 invoke 並 return,不必繼續遍歷;更關鍵的是,每次渲染標簽都重新遍歷「角色→權限→資源」三層嵌套,開銷不小,可以考慮把用戶的 uri 集合在登錄時計算好放進 Session,標簽裡只做一次 contains 判斷。
另外,未登錄時示例選擇靜默不輸出任何內容,體驗上略顯突兀;可以在 uri 之外增加一個 loginUrl 屬性,未登錄時輸出跳轉提示。標簽類名 PerssionTag 拼寫有誤,改為 PermissionTag 更合適。
如果是新項目,標簽庫路徑建議寫成 https://java.sun.com/jsp/jstl 之後的現代形式,並考慮直接用 JSTL 的 <c:if> 配合 EL 表達式表達這類判斷;自定義標簽更適合封裝無法用 EL 表達的複雜邏輯。