From Gossip@caterpillar

JSP/Servlet: 簡介 Tag File



 可以來設計一個簡單的Tag File，Tag File通常是存放在WEB-INF/tags/目錄下，下面是設計的簡單Tag File：
  • hello.tag
<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：
  • test.jsp
<%@taglib prefix="caterpillar" tagdir="/WEB-INF/tags" %> 
<html> 
<body> 
  <caterpillar: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網頁中使用，後三者在下一個主題再介紹。