我們可以來設計一個簡單的Tag File,Tag File通常是存放在WEB-INF/tags/目錄下,下面是我們設計的簡單Tag File:
<table border="1"> <tr><td>Hello! World!</td></tr> </table>
假設我們的Tag File取名為hello.tag,*.tag是Tag File建議的副檔名,也可以是*.tagx,Tag File也可以包括其它的Tag File,如果是這樣的情況,建議可以用*.tagf作為副檔名。
我們的Tag File中目前只有靜態的內容,事實上您可以在當中使用合法的JSP語法來撰寫,像是Scriptlet、EL、指令元素或動作元素等等,我們可以撰寫以下的JSP網頁來使用自訂的Tag File:
<%@taglib prefix="demo" tagdir="/WEB-INF/tags" %> <html> <body> <demo:hello/> </body> </html>
執行這個JSP網頁,將會傳回以下的內容:
<html> <body> <table border="1"> <tr><td>Hello! World!</td></tr> </table> </body> </html>
Tag File實際上會轉譯為Simple Tag,以Tomcat為例的話,您可以在work\Catalina\localhost\myjsp\org\apache\jsp\tag\web下找到轉譯之後的*.java與*.class檔案,名稱為hello_tag.java與hello_tag.class,是繼承SimpleTagSupport的類別。
在Tag File中可以使用out、config、request、response、session、application、jspContext等隱含物件,前六個的使用與JSP網頁中所使用的隱含物件是相同的,jspContext在轉譯之後,實際上則是JspContext物件。
在Tag File中可以使用<jsp:invoke>與<jsp:doBody>兩個標籤,前者可以用來處理Fragment,後者可以用來決定要不要處理標籤間的本體文字,這在之後我們會再介紹。
在Tag File中可以使用的指令元素有taglib、include、tag、attribute、variable五個,前兩者的使用方式與在JSP網頁中是相同的,tag指令則類似於JSP網頁中的page指令,用於指定與Tag File相關的屬性(像是pageEncoding、body-content等),attribute用以指定標籤的屬性,而variable用於設定Tag File的Scripting Variable,以傳回JSP網頁中使用,後三者詳細的使用會在之後作介紹。