Download to read offline
Uploaded byJustin Lin
Ch08 自訂標籤
本文档介绍了自定义标签的学习目标和方法，包括使用 tag file 和 simple tag 进行自定义标签的实现。文中详细说明了 tag file 的结构及其在 JSP 中的使用方式，以及标签处理器的生命周期和 API 架构。还涵盖了如何处理标签属性、与父标签沟通以及将 tag file 打包为 JAR 文件的注意事项。
Ch08 自訂標籤
- 1.
- 2. 8 • 自訂標籤 學習目標 • 使用Tag File 自訂標籤 • 使用 Simple Tag 自訂標籤 • 使用 Tag 自訂標籤 2
- 3.
- 4.
- 5. 簡介 Tag File •撰寫副檔名為 .tag，放在WEB-INF/tags 底下 5
- 6.
- 7. 簡介 Tag File •Tag File 會被容器轉譯為 javax.servlet.jsp.tagext.SimpleT agSupport 的子類別 • 在 Tag File 中可以使用 out、config、 request、response、session、 application、jspContext 等隱含物件 • 其中 jspContext 在轉譯之後，實際上則 是 javax.servlet.jsp.JspContext 7
- 8. 簡介 Tag File •Tag File 在 JSP 中，並不是靜態包含 （<%@include>）或動態包含 （<jsp:include>） • 在 Tag File 撰寫 Scriplet 的話 – 其中的隱含物件其實是轉譯後的 .java 中 doTag() 方法中的區域變數 – 不可能與 JSP 的 Scriptlet 溝通 8
- 9.
- 10.
- 11.
- 12.
- 13.
- 14. 處理標籤屬性與本體 • Tag File的標籤在使用時若有本體，預設是不 允許有 Scriptlet 的 • tag 指示元素的 body-content 屬性預設 就是 scriptless，還可以設定 empty 或 tagdependent 14
- 15. TLD檔案 • 如果要將 TagFile 包成 JAR 檔案，那麼有幾 個地方要注意一下： – *.tag 檔案必須放在 JAR 的 META-INF/tags 資料 夾或子資料夾下。 – 要定義 TLD（Tag Library Description）檔案。 – TLD 檔案必須放在 JAR 的 META-INF/TLDS 15
- 16.
- 17.
- 18.
- 19.
- 20.
- 21.
- 22. 了解 API 架構與生命週期 •建立自訂標籤處理器實例。 • 呼叫標籤處理器的 setJspContext()方法設定 PageContext 實例。 • 如果是巢狀標籤中的內層標籤，則還會呼叫標籤處 理器的 setParent()方法，並傳入外層標籤處理 器的實例。 • 設定標籤處理器屬性（例如這邊是呼叫 IfTag 的 setTest()方法來設定）。 • 呼叫標籤處理器的 setJspBody() 方法設定 JspFragment 實例。 • 呼叫標籤處理器的 doTag() 方法。 • 銷毀標籤處理器實例。 22
- 23. 了解 API 架構與生命週期 •每一次的請求都會建立新的標籤處理器實例， 而在執行 doTag()過後就銷毀實例 • Simple Tag 的實作中，建議不要有一些耗資 源的動作 23
- 24. 了解 API 架構與生命週期 •如果執行 doTag()的過程在某些條件下，必 須中斷接下來頁面的處理或輸出，則可以丟 出 SkipPageException 24
- 25.
- 26.
- 27.
- 28.
- 29.
- 30.
- 31.
- 32.
- 33.
- 34.
- 35. TLD 檔案 • JAR檔案根目錄下放置編譯好的類別（包含 對應套件的資料夾）。 • JAR 檔案 META-INF 資料夾或子資料夾中放 置 TLD 檔案。 35
- 36.
- 37.
- 38.
- 39.
- 40. 了解架構與生命週期 • 嘗試從標籤池（Tag Pool）找到可用的標籤物件，如果找 到就直接使用，如果沒找到就建立新的標籤物件。 •呼叫標籤處理器的 setPageContext()方法設定 PageContext 實例。 • 如果是巢狀標籤中的內層標籤，則還會呼叫標籤處理器的 setParent() 方法，並傳入外層標籤處理器的實例。 • 設定標籤處理器屬性（例如這邊是呼叫 IfTag 的 setTest() 方法來設定）。 • 呼叫標籤處理器的 doStartTag() 方法，並依不同的傳 回值決定是否執行本體或呼 叫doAfterBody()、 doEndTag()方法（稍後詳述）。 • 將標籤處理器實例置入標籤池中以便再度使用。 40
- 41. 了解架構與生命週期 • Tag 實例是可以重複使用的 •自訂 Tag 類別時，要注意物件狀態是否會保 留下來，必要的時候，在 doStartTag()方 法中，可以進行狀態重置的動作 • 別以為可以使用 release()方法來作狀態重 置，因為 release()方法只會在標籤實例真 正被銷毀回收前被呼叫 41
- 42.
- 43. 重複執行標籤本體 • 想繼承 TagSupport實作 <f:forEach>標 籤，該在哪個方法中實作？ • doStartTag()？doEndTag()？ 43
- 44.
- 45.
- 46.
- 47.
- 48.
- 49.
- 50.
- 51.
- 52.
- 53.
- 54.