JSP/Servlet/JSF 標籤庫深度研究：Taglib 結構、開發流程與容器轉換機制

標籤庫三大核心組件

標籤庫打包與部署 (JSP 1.1+ 規範)

1. 編譯處理器、TEI 類 → JAR 包。
2. TLD 放入 JAR META-INF/taglib.tld。
3. JAR 複製到 Web 應用 WEB-INF/lib/，容器自動掃描載入。

開發四步驟

1. 設計標籤：名稱、屬性、變數、體內容類型 (empty/tagdependent/scriptless/JSP)。
2. 編寫 TLD (XML)。
3. 實現標籤處理器 (Java)。
4. JSP 頁面引用：<%@ taglib uri="..." prefix="mytag" %>。

JSP 頁面在容器中的轉換流程

1. 指令元素 → 提供轉換期資訊 (不產出內容)。
2. 靜態 HTML → out.print() 序列。
3. 宣告腳本 <%! ... %> → 類成員區域 (service 方法外)。
4. 表達式腳本 <%= ... %> → out.print()。
5. Scriptlet <% ... %> → 直接複製進 _jspService() 方法體。
6. 動作元素 (標準/自定義) → 生成運行時邏輯代碼。
7. **自定義標籤** → 展開為調用對應處理器方法的 Java 語句序列：
   TagHandler th = new TagHandler(); th.setPageContext(pageContext); th.setParent(parent); th.doStartTag(); ... th.doEndTag();

自定義標籤在容器中的解析流程

1. taglib 指令定位 TLD (uri 匹配)。
2. 讀取 TLD 標籤列表與處理器類名。
3. 遇到前綴標籤 → 查找對應 Taglib → 獲取處理器類。
4. 依 TLD 結構信息生成調用處理器生命週期方法的代碼。

標籤處理器生命週期 (Classic Tag API)

1. setPageContext(pageContext)
2. setParent(parentTag)
3. setXxx(attributeValues)  // 每個屬性一個 setter
4. doStartTag() → 返回 EVAL_BODY_INCLUDE / SKIP_BODY / EVAL_BODY_TAG
5. [若有 Body] doInitBody() → bodyContent → doAfterBody() 循環
6. doEndTag() → 返回 EVAL_PAGE / SKIP_PAGE
7. release()  // 釋放資源，供下次複用 (池化)

SimpleTag API (JSP 2.0+ 推薦)

• 單一方法 doTag() 封裝全部邏輯，無 doStart/EndTag 複雜度。
• 體內容透過 getJspBody().invoke(null) 或 invoke(writer) 處理。
• 無釋放池化問題，每次請求新實例，簡化狀態管理。

現代化替代方案

結語

Taglib 是 JSP 時代**組件化、關注點分離**的核心機制。理解其容器轉換機制、生命週期、TLD 元數據結構，對維護舊系統、設計模板引擎擴展點仍有價值。新架構請擁抱前端組件化與現代模板引擎。

1. 上一篇文章： JSP 防止表單重複提交：基於 Session Token 的服務端驗證方案
2. 下一篇文章： JSP 生成靜態頁面：Tomcat 效能優化的終極之道 — 原理、策略與遷移指南

關於JSP

JBuilder 2005 實戰 JSP：統一錯誤處理頁面與登入失敗頁實作

錯誤處理頁面 error.jsp <%@ page c

Servlet 2.4 核心功能詳細介紹

J2EE 1.4 Servlet 2.4 主要新功能 1.

SSI 框架學習總結：Struts2 + Spring + iBatis 三層架構整合實戰

SSI 框架學習總結：Struts2 + Spring +

JSP 錯誤頁面建立與自動跳轉完整指南

錯誤頁面機制概述 Web 應用若能在發生例外或 HTTP 錯