JSP Taglib 指令：自定義標籤庫開發與使用全解析

Taglib 指令（<%@ taglib %>）引入自定義標籤庫，賦予 JSP 擴展標記語言的能力，是從「腳本頁」邁向「標籤驅動開發」的關鍵一步。

基本語法與範例

<%@ taglib uri="URIToTagLibrary" prefix="tagPrefix" %>
<!-- 範例 -->
<%@ taglib uri="https://www.example.com/tags" prefix="my" %>
<my:loop>...</my:loop>

核心概念釐清

• 標籤：XML 標記（如 <my:loop>）。
• 元素：完整語法單元，含開始標籤、內文、結束標籤（如 <my:loop>body</my:loop>），可巢狀。
• 標籤庫描述檔：.tld XML 檔，定義標籤名、處理類、屬性、體內容類型等元資料。
• URI 映射機制：容器啟動掃描 WEB-INF/**/*.tld，建立 uri → tld路徑 對應；JSP 中 uri 屬性匹配此映射，無需寫實體路徑。

屬性詳解

開發自定義標籤四步驟

1. 編寫 Tag Handler 類：實作 Tag/IterationTag/BodyTag 或繼承 TagSupport/BodyTagSupport，實作 doStartTag()、doEndTag() 等。
2. 編寫 TLD 檔（置於 WEB-INF/tlds/ 或 JAR META-INF/），定義 <tag> 元素對應處理類與屬性。
3. web.xml 註冊（Servlet 2.3+ 可省略，容器自動掃描 WEB-INF/**/*.tld）。
4. JSP 中 <%@ taglib uri="..." prefix="..." %> 引入並使用。

TagSupport 關鍵點

• pageContext、parent 由容器在 doStartTag() 前注入，構造器中不可訪問。
• 回傳值控制體處理流程：SKIP_BODY、EVAL_BODY_INCLUDE、EVAL_BODY_TAG（BodyTag）。
• 巢狀標籤透過 findAncestorWithClass() 訪問父標籤上下文。

現代框架（Struts2、Spring MVC、JSF）皆大量內建標籤庫，理解 Taglib 機制有助於除錯與擴展。