標簽是一種xml元素,通過標簽可以使JSP網頁變得簡潔并且易于維護,還可以方便地實現同一個JSP文件支持多種語言版本。由于標簽是XML元素,所以它的名稱和屬性都是大小寫敏感的
2.標簽庫(Taglibrary):由一系列功能相似、邏輯上互相聯系的標簽構成的集合稱為標簽庫。
3.標簽庫描述文件(TagLibraryDescriptor):標簽庫描述文件是一個XML文件,這個文件提供了標簽庫中類和JSP中對標簽引用的映射關系。它是一個配置文件,和web.xml是類似的。4.標簽處理類(TagHandleClass): 標簽處理類是一個java類,這個類繼承了TagSupport或者擴展了SimpleTag接口,通過這個類可以實現自定義JSP標簽的具體功能 兩種標簽 可以定義兩種類型的標簽:javax.servlet.jsp.tagext.Tagjavax.servlet.jsp.tagext.BodyTag 有標簽體的標簽必須實現BodyTagSupport 接口。<jsptag:mapscope=“session”name=“tagMap”>body </jsptag:map> 也可能沒有標簽體: <jsptag:map/> 無標簽體的簡單標簽可以實現TagSupport 接口。
二、自定義JSP標簽的格式:1. <%@taglibPRefix=”someprefix”uri=”/sometaglib”%> 為了使到JSP容器能夠使用標簽庫中的自定義行為,必須滿足以下兩個條件:
1)從一個指定的標簽庫中識別出代表這種自定義行為的標簽
2)找到實現這些自定義行為的具體類 第一個必需條件-找出一個自定義行為屬于那個標簽庫-是由標簽指令的前綴(TaglibDirective'sPrefix)屬性完成,所以在同一個頁面中使用相同前綴的元素都屬于這個標簽庫。
每個標簽庫都定義了一個默認的前綴,用在標簽庫的文檔中或者頁面中插入自定義標簽。所以,你可以使用除了諸如jsp,jspx,java,servlet,sun,sunw(它們都是在JSP白皮書中指定的保留字)之類的前綴。
uri屬性滿足了以上的第二個要求。為每個自定義行為找到對應的類。這個uri包含了一個字符串,容器用它來定位TLD文件。在TLD文件中可以找到標簽庫中所有標簽處理類的名稱
2.當web應用程序啟動時,容器從WEB-INF文件夾的目錄結構的META-INF搜索所有以.tld結尾的文件。也就是說它們會定位所有的TLD文件。對于每個TLD文件,容器會先獲取標簽庫的URI,然后為每個TLD文件和對應的URI創建映射關系。
在JSP頁面中,我們僅需通過使用帶有URI屬性值的標簽庫指令來和具體的標簽庫匹配
三、自定義JSP標簽的處理過程:1.在JSP中引入標簽庫:
<%@taglibprefix=”taglibprefix”uri=”tagliburi”%>
2.在JSP中使用標簽庫標簽
3.Web容器根據第二個步驟中的prefix,獲得第一個步驟中聲明的taglib的uri屬性值
4.Web容器根據uri屬性在web.xml找到對應的元素(4、5兩步可以不要)
5.從元素中獲得對應的元素的值
<taglib> <taglib-uri>/myTag</taglib-uri> <taglib-location>/WEB-INF/myTag.tld</taglib-location></taglib> <taglib-uri>對應tld文件中的<uri>,<taglib-location>指出tld文件的位置。
6.Web容器根據元素的值從WEB-INF/目錄下找到對應的.tld文件
7.從.tld文件中找到與tagname對應的元素
8.從元素中獲得對應的元素的值9.Web容器根據元素的值創建相應的taghandleclass的實例10.Web容器調用這個實例的doStartTag/doEndTag方法完成相應的處理
四、創建和使用一個TagLibrary的基本步驟:1.創建標簽的處理類(TagHandlerClass)
2.創建標簽庫描述文件(TagLibraryDescrptorFile)
3.在web.xml文件中配置元素
4.在JSP文件中引人標簽庫
五、創建標簽庫描述文件(TagLibraryDescriptor):1.標簽庫描述文件,簡稱TLD,采用XML文件格式,定義了用戶的標簽庫。TLD文件中的元素可以分成3類:
A.:標簽庫元素
B.:標簽元素
C.:標簽屬性元素2.標簽庫元素用來設定標簽庫的相關信息,它的常用屬性有:
A.shortname:指定TagLibrary默認的前綴名(prefix)
B.uri:設定TagLibrary的惟一訪問表示符
3.標簽元素用來定義一個標簽,它的常見屬性有: A.name:設定Tag的名字 B.tagclass:設定Tag的處理類 C.bodycontent:設定標簽的主體(body)內容 (1)tagdependent:標簽體內容直接被寫入BodyContent,由自定義標簽類來進行處理,而不被JSP容器解釋,
如下:<test:myList> selectname,agefromusers</test:myList> (2)JSP:接受所有JSP語法,如定制的或內部的tag、scripts、靜態HTML、腳本元素、JSP指令和動作。
如:<my:test> <%=request.getProtocol()%> //②</my:test> (3)empty:空標記,即起始標記和結束標記之間沒有內容。下面幾種寫法都是有效的,
<test:mytag/>
<test:mytaguname="Tom"/>
<test:mytag></test:mytag>
(4)scriptless:接受文本、EL和JSP動作。如上述②使用<body-content>scriptless</body-content>則報錯,具體可參考后面附源碼。 4.標簽屬性元素用來定義標簽的屬性,它的常見屬性有: A.name:屬性名稱 B.required:屬性是否必需的,默認為false C.rtexprvalue:屬性值是否可以為request-time表達式,也就是類似于<%=„%>的表達式
例子:WEB-INF/tlds/test.tld <?xmlversion="1.0"encoding="UTF-8"?> <taglibversion="2.0"xmlns="http://java.sun.com/xml/ns/j2ee"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2eeweb-jsptaglibrary_2_0.xsd">
<tlib-version>1.0</tlib-version> <short-name>test</short-name>//標簽庫名,也稱為前綴。比如“c:outvalue=""/”里的“c”
<uri>/WEB-INF/tlds/test</uri>//在jsp頁面上引用的路徑
<tag> <name>out</name>//定義標簽的名例如“test:outvalue=""/”里的"out”,
<tag-class>gdufs.tags.OutputTag</tag-class>//指出標簽處理程序類記著帶包名
<body-content>empty</body-content>//如果沒有標簽體,設置empty,如果有標簽休必須設置JSP
<attribute> <name>name</name>//屬性名字。例如test:outvalue=""/里的value。名字可任意取,只要類里提供相應的set方法即可。 <required>false</required>//是否必填屬性 <rtexprvalue>false</rtexprvalue>//是否支持運行時表達式取值就是是否可以是${}方式傳值。"
</attribute>
</tag>
</taglib>
六、如何創建標簽處理類:1.引入必需的資源: 2.繼承TagSupport類并覆蓋doStartTag()/doEndTag()方法
TagSupport類簡介: 1.處理標簽的類必須擴展javax.servlet.jsp.TagSupport.
2.TagSupport類的主要屬性: A.parent屬性:代表嵌套了當前標簽的上層標簽的處理類 B.pageContex屬性:代表Web應用中的javax.servlet.jsp.PageContext對象,通過此對象可向jsp頁面中輸出信息 3.JSP容器在調用doStartTag或者doEndTag方法前,會先調用setPageContext和setParent方法,設置pageContext和parent。因此在標簽處理類中可以直接訪問pageContext變量 4.在TagSupport的構造方法中不能訪問pageContext成員變量,因為此時JSP容器還沒有調用setPageContext方法對pageContext進行初始化
七、TagSupport處理標簽的方法:1.TagSupport類提供了兩個處理標簽的方法: publicintdoStartTag()throwsJspException
publicintdoEndTag()throwsJspException 2.doStartTag:但JSP容器遇到自定義標簽的起始標志,就會調用doStartTag()方法。 doStartTag()方法返回一個整數值,用來決定程序的后續流程。
A.Tag.SKIP_BODY:表示?>„之間的內容被忽略 B.Tag.EVAL_BODY_INCLUDE:表示標簽之間的內容被正常執行 3.doEndTag:但JSP容器遇到自定義標簽的結束標志,就會調用doEndTag()方法。doEndTag()方法也返回一個整數值,用來決定程序后續流程。 A.Tag.SKIP_PAGE:表示立刻停止執行網頁,網頁上未處理的靜態內容和JSP程序均被忽略任何已有的輸出內容立刻返回到客戶的瀏覽器上。 B.Tag_EVAL_PAGE:表示按照正常的流程繼續執行JSP網頁
在jsp中使用自定義標簽:1.如果Web應用中用到了自定義JSP標簽,則必須在web.xml文件中加入元素,它用于聲明所引用的標簽所在的標簽庫 /WEB-INF/ltds/test.tld 2.:設定TagLibrary的惟一標示符,在Web應用中將根據它來引用TagLibray3.:指定和TagLibrary對應的TLD文件的位置 4.在JSP文件中需要加入<%@taglib%>指令來聲明對標簽庫的引用。例如:<%@taglibprefix=“somePrefix”uri="/someuri"%> 5.prefix表示在JSP網頁中引用這個標簽庫的標簽時的前綴,uri用來指定TagLibrary的標識符
例子:test.jsp <%@pagecontentType="text/html"%>
<%@pagepageEncoding="UTF-8"%>
<%@pagelanguage="java"%> <%@tagliburi="/WEB-INF/tlds/test.tld"prefix="t"%>
<html>
<body> TestTag:<t:outname="TEST"/><br>標簽后面的內容 </body><!--沒有標簽體-->
</html>
八、BodyTagSupport處理標簽的方法:要開發帶標簽體的標簽,可實現BodyTag接口,也可從BodyTag接口的實現類BodyTagSupport繼承,為簡化開發,推薦從BodyTagSupport類繼承開發。 BodyTagSupport默認doStartTag()返回EVAL_BODY_BUFFERED/doInitBody()什么也不做/doAfterBody()返回SKIP_BODY 下面是自定義tag的執行過程(由上至下),對于以上各常量的實際運用為: 注意其中的doInitBody/setBodyContent方法在自定義標簽實現了BodyTag接口或繼承BodyTagSupport才可以使用
Tag方法 | 可返回的靜態常量 |
doStartTag | SKIP_BODY、EVAL_BODY_INCLUDE、EVAL_BODY_AGAIN/EVAL_BODY_BUFFERED |
doInitBody | 做標簽一些初始化工作,無返回值 |
setBodyContent | 在doInitBody之后執行,使用setBodyContent得到JSP頁面中標簽體之間內容 |
doAfterBody | 最終必須返回SKIP_BODY,否則可能導致OutOfMemoryError |
doEndTag | SKIP_PAGE/EVAL_PAGE |
編寫標簽對應的實現類時,需要重載BodyTagSupport類幾個方法:doStartTag(),setBodyContent(),doInitBody(),doAfterBody(),doEndTag(),他們執行順序如下: doStartTag()→doInitBody()→setBodyContent()→doAfterBody()→doEndTag() doStartTag()方法可返回EVAL_BODY_INCLUDE或SKIP_BODY,如果返回EVAL_BODY_INCLUDE則繼續執行;如果返回SKIP_BODY則接下來的doInitBody(),setBodyContent(),doAfterBody()三個方法不會被執行,而直接執行doEndTag()方法。 setBodyContent()方法用于設置標簽體內容,如果在此之前要作一些初始化工作,則在doInitBody()方法中完成。
標簽體內容執行完后,會調用doAfterBody()方法,此方法可返回EVAL_BODY_TAG,SKIP_BODY,EVAL_PAGE或SKIP_PAGE。如果返回EVAL_BODY_TAG則會再次設置標簽體內容,直到返回SKIP_BODY;如果返回EVAL_PAGE則標簽體執行完后會繼續執行JSP頁面中接下來的部分;如果返回SKIP_PAGE,則JSP頁面的后續內容將不再執行。
【實例】開發帶標簽體的標簽:bodyTag1本實例將要開發一個帶標簽體的標簽bodyTag1,這個標簽有一個屬性countNum,用于設置輸出標簽體內容的次數,輸出內容為當前的系統時間。
(1)第一步:開發標簽實現類。
BodyTag1.java
1 package body; 2 import javax.servlet.jsp.JspWriter; 3 import javax.servlet.jsp.tagext.BodyTagSupport; 4 5 public class bodyTag1 extends BodyTagSupport{ 6 7 private int countNum=0;//循環顯示時間的次數 8 9 private int currentNum=1;//當前執行次數 10 11 //----標簽開始時調用此方法-------12 public int doStartTag(){ 13 14 try{15 JspWriter out=pageContext.getOut();16 out.print("標簽開始了:<br>");17 if(countNum>0)18 return EVAL_BODY_TAG; 19 else20 return SKIP_BODY; 21 }22 catch(Exception e){ 23 System.out.println(e); 24 return SKIP_BODY; 25 } 26 }27 //----標簽體執行完后調用此方法---- 28 public int doAfterBody(){ 29 try{30 JspWriter out=pageContext.getOut();31 out.print("第"+currentNum+"次執行標簽體。標簽體執行完畢。<br>"); 32 if(countNum>1){//如果還需要執行標簽體 33 countNum--; 34 currentNum++;35 return EVAL_BODY_TAG; 36 }else 37 return SKIP_BODY; 38 }catch(Exception e){ 39 System.out.println(e); 40 return SKIP_BODY; 41 } 42 }43 //----標簽結束時調用此方法------- 44 public int doEndTag(){ 45 try{46 JspWriter out=pageContext.getOut(); 47 //----輸出標簽體的內容----48 bodyContent.writeOut(bodyContent.getEnclosingWriter()); out.print("標簽結束了。"); 49 }catch(Exception e){ 50 System.out.println(e); 51 }52 return EVAL_PAGE; } 53 public int getCountNum() { 54 return countNum; 55 }56 public void setCountNum(int countNum) { 57 this.countNum = countNum;58 this.currentNum=1; 59 } 60 }
執行標簽體并不會直接輸出標簽體中的內容,因此本實例在doEndTag()方法中一次性把執行的結果輸出。
(2)第二步:編寫標簽描述tld文件。 因為本章所有實例共用一個Web應用,故本例在myTag.tld文件中增加內容。在<taglib>與</taglib>之間增加的內容如下:
1 <!--bodyTag1--> 2 <tag> 3 <!--標簽名稱--> 4 <name>bodyTag1</name> 5 <!--標簽對應的處理類--> 6 <tag-class>body.bodyTag1</tag-class> 7 <!--標簽體內容,有標簽體則設為jsp--> 8 <body-content>jsp</body-content><!--標簽的屬性聲明--> 9 <attribute>10 <name>countNum</name>11 <required>true</required>12 <rtexprvalue>true</rtexprvalue>13 </attribute>14 </tag>
對于屬性countNum的聲明中,<required>設置為true,表示此屬性為必輸項;<rtexprvalue>設置為true,表示標簽體支持運行時的表達式取值,如果為false則表示標簽體為一個靜態文本,默認情況下設置為true。
(3)第三步:在Web應用的web.xml文件中聲明標簽庫引用。(不是必須的)
1 <taglib>2 <taglib-uri>/myTag</taglib-uri>3 <taglib-location>/WEB-INF/myTag.tld</taglib-location>4 </taglib>
4)第四步:在JSP頁面中聲明并調用標簽。
UseBodyTag1.jsp
1 <%@tagliburi="/myTag"prefix="myTag"%> 2 <%@pagecontentType="text/html;charset=GB2312"%> 3 <%@pageimport="java.util.Date"%> 4 <html> 5 <head> 6 <title>開發帶有標簽體的標簽</title> 7 </head> 8 <body> 9 下面是應用這個帶有屬性的自定義標簽的結果:<br>10 <myTag:bodyTag1countNum="6">11 現在的時間是:<%=newDate()%><br>12 </myTag:bodyTag1>13 </body>14 </html>15
運行結果:
JSP2.0中為了簡化標簽的復雜性,增加了制作SimpleTag的標簽類SimpleTagSupport類。SimpleTagSupport類是實現SimpleTag接口的。它只需要實現一個doTag()方法即可,而不需要一堆回傳值 例子:1、處理類
1 package gdufs.tag; 2 import javax.servlet.jsp.tagext.SimpleTagSupport; 3 import javax.servlet.jsp.*; import java.io.*; 4 public class SimpleHelloTag extends SimpleTagSupport{ 5 public void doTag() throws JspException,IOException{ 6 JspWriter out=this.getJspContext().getOut(); 7 out.println("hello world"); 8 } 9 } 10 package gdufs.tag; 11 import javax.servlet.jsp.*; import java.io.*; 12 import javax.servlet.jsp.tagext.*; 13 public class SimpleTextProcessTag extends SimpleTagSupport{ 14 //要處理標簽體的文本內容,使用StringWriter 15 public void doTag() throws JspException,IOException{ //標簽體內容 16 JspFragment frag=this.getJspBody(); 17 JspWriter out=this.getJspContext().getOut(); 18 StringWriter sout=new StringWriter(); 19 //1.標簽體的內容寫到字符串輸出流對象sout 20 frag.invoke(sout); 21 //2.獲得標簽體的文本內容 22 String msg=sout.toString(); 23 //3.處理并輸出(逗號轉換成空格) 24 out.println(msg.replaceAll(","," ")); 25 } 26 } 27 package gdufs.tag; 28 import javax.servlet.jsp.*; import java.io.*; 29 import javax.servlet.jsp.tagext.SimpleTagSupport; import javax.servlet.jsp.tagext.JspFragment; 30 public class SimpleTextTag extends SimpleTagSupport{ 31 public void doTag() throws JspException,IOException{ 32 //fragment封裝了標簽體 33 JspFragment fragment=this.getJspBody(); 34 //將標簽體的內容寫到指定的輸出流,null表示寫入預設的getJspContext.getOut()取得的輸出流對象 35 fragment.invoke(null); 36 } 37 }
新聞熱點
疑難解答