當(dāng)jsp的內(nèi)置標(biāo)簽和jstl標(biāo)簽庫(kù)內(nèi)的標(biāo)簽都滿足不了需求,這時(shí)候就需要開(kāi)發(fā)者自定義標(biāo)簽。
自定義標(biāo)簽下面我們先來(lái)開(kāi)發(fā)一個(gè)自定義標(biāo)簽,然后再說(shuō)它的原理吧!
自定義標(biāo)簽的開(kāi)發(fā)步驟步驟一
編寫(xiě)一個(gè)普通的java類,繼承TagSupport類~
package com.vmaxtam.dotest;import javax.servlet.jsp.tagext.TagSupport;public class MyTagTest extends TagSupport { }
步驟二
重寫(xiě)父類的setPageContext方法,用于得到當(dāng)前jsp頁(yè)面的pageContext對(duì)象。
public class MyTagTest extends TagSupport { PRivate PageContext pageContext; @Override public void setPageContext(PageContext pageContext) { this.pageContext=pageContext; }}
步驟三
重寫(xiě)父類的doStartTag方法,里面寫(xiě)上你定義的標(biāo)簽的java操作,這里我定義的標(biāo)簽用作向?yàn)g覽器輸出一大段信息:
@Override public int doStartTag() throws JspException { try { pageContext.getResponse().getWriter().write("這是我寫(xiě)的一大段信息:ABCDEFGHIJKLMNOPQRSTUVWXYZ"); } catch (IOException e) { e.printStackTrace(); throw new RuntimeException(e); } return super.doStartTag(); }
這樣就完成一個(gè)標(biāo)簽處理程序了~別著急,寫(xiě)完程序我們還需要注冊(cè)它。
步驟四
在你的web應(yīng)用目錄下,找到WEB-INF文件夾,在里面新建一個(gè)tld類型的文件
然后再里面注冊(cè)你的標(biāo)簽吧:
<?xml version="1.0" encoding="ISO-8859-1" ?><!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"><taglib> <tlib-version>1.0</tlib-version><!-- 代表標(biāo)簽庫(kù)的版本號(hào) --> <jsp-version>1.2</jsp-version><!-- 代表jsp的版本 --> <short-name>mtt</short-name><!-- 你的標(biāo)簽庫(kù)的簡(jiǎn)稱 --> <uri>http://vmaxtam.com/mytag</uri><!-- 你標(biāo)簽庫(kù)的引用uri --> <tag> <name>mytah</name><!-- 你定義的標(biāo)簽的名稱 --> <tag-class>com.vmaxtam.dotest.MyTagTest</tag-class><!-- 對(duì)應(yīng)的標(biāo)簽處理程序:包名+類名 --> <body-content>JSP</body-content><!-- 標(biāo)簽體內(nèi)容的格式 --> </tag> </taglib>
如果你忘記了怎么寫(xiě),可以參考jstl里的tld文件~
步驟五
你要在使用你定義的標(biāo)簽的jsp頁(yè)面導(dǎo)入你的標(biāo)簽庫(kù)!就像導(dǎo)入類包一樣
只需在jsp頁(yè)面寫(xiě)上下面內(nèi)容:
<%@taglib uri="http://vmaxtam.com/mytag" prefix="mmt" %>
步驟6
以上5步已經(jīng)把準(zhǔn)備工作都做好了~下面我們來(lái)使用標(biāo)簽吧!
<html> <head> <title>My JSP 'testit.jsp' starting page</title> </head> <body> <mmt:mytag></mmt:mytag> </body></html>
瀏覽器效果如下:
這樣,我們就完成了一次自定義標(biāo)簽了,雖然我們知道步驟,但是不知道為什么這樣就行,所以,下面來(lái)說(shuō)一下它的原理:
自定義標(biāo)簽的原理1)當(dāng)服務(wù)器打開(kāi)時(shí),就會(huì)加載WEB-INF下的資源文件,包括web.xml和tld文件,把它們加載到內(nèi)存
2)我們?cè)跒g覽器輸入http://localhost:8080/TestArea/testit.jsp來(lái)訪問(wèn)jsp頁(yè)面
3)服務(wù)器讀取testit.jsp里的內(nèi)容,當(dāng)讀到
<%@tagliburi="http://vmaxtam.com/mytag"prefix="mmt"%>
這一句的時(shí)候,就會(huì)在內(nèi)存中找是否存在uri為http://vmaxtam.com/mytag的tld文件,找不到就會(huì)報(bào)錯(cuò)
4)繼續(xù)讀取jsp頁(yè)面,讀到<mmt:mytag>這個(gè)標(biāo)簽的時(shí)候,就會(huì)通過(guò)uri去找到tld文件,在tld文件中找到mytab是否被定義,是的話就得到它的tag-class的內(nèi)容,然后去找到它對(duì)應(yīng)的標(biāo)簽處理程序
5)實(shí)例化標(biāo)簽處理程序,利用生成的對(duì)象調(diào)用它里面的方法
這里服務(wù)器對(duì)標(biāo)簽處理程序里的方法也有一定的調(diào)用順序 A)voidsetPageContext(PageContextpc)--傳入pageContext對(duì)象
B)voidsetParent(Tagt)--如果有父標(biāo)簽,傳入父標(biāo)簽對(duì)象,如果沒(méi)有,則傳入null
C)intdoStartTag()--開(kāi)始執(zhí)行標(biāo)簽時(shí)調(diào)用。
D)intdoEndTag()--結(jié)束標(biāo)簽時(shí)調(diào)用
E)voidrelease()--釋放資源
如果你沒(méi)有重寫(xiě)上面的方法,系統(tǒng)將會(huì)調(diào)用它的父類里的方法~
為什么會(huì)是這個(gè)順序調(diào)用,是有證據(jù)的,下面我們來(lái)看看jsp被翻譯為java源文件里的截取:
private boolean _jspx_meth_itcast_005fshowip_005f0(PageContext _jspx_page_context) throws Throwable { PageContext pageContext = _jspx_page_context; JspWriter out = _jspx_page_context.getOut(); // itcast:showIp 1) 實(shí)例化ShowIpTag對(duì)象 gz.itcast.tag.ShowIpTag _jspx_th_itcast_005fshowIp_005f0 = (gz.itcast.tag.ShowIpTag) _005fjspx_005ftagPool_005fitcast_005fshowIp_005fnobody.get(gz.itcast.tag.ShowIpTag.class); 2)調(diào)用setPageContext方法 _jspx_th_itcast_005fshowIp_005f0.setPageContext(_jspx_page_context); 3)調(diào)用setParent方法 _jspx_th_itcast_005fshowIp_005f0.setParent(null); 4)調(diào)用doStartTag方法 int _jspx_eval_itcast_005fshowIp_005f0 = _jspx_th_itcast_005fshowIp_005f0.doStartTag(); 5)調(diào)用doEndTag方法 if (_jspx_th_itcast_005fshowIp_005f0.doEndTag() == javax.servlet.jsp.tagext.Tag.SKIP_PAGE) { _005fjspx_005ftagPool_005fitcast_005fshowIp_005fnobody.reuse(_jspx_th_itcast_005fshowIp_005f0); return true; } _005fjspx_005ftagPool_005fitcast_005fshowIp_005fnobody.reuse(_jspx_th_itcast_005fshowIp_005f0); return false; }控制標(biāo)簽體內(nèi)容與結(jié)束標(biāo)簽后的內(nèi)容
自定義標(biāo)簽可以可控制標(biāo)簽體內(nèi)的文本和結(jié)束標(biāo)簽后的文本是否輸出~
@Override//遇到開(kāi)始標(biāo)簽時(shí)執(zhí)行的方法 public int doStartTag() throws JspException { //return Tag.SKIP_BODY; //標(biāo)簽體內(nèi)容不向?yàn)g覽器輸出 return Tag.EVAL_BODY_INCLUDE;//標(biāo)簽體內(nèi)容向?yàn)g覽器輸出 } @Override//遇到結(jié)束標(biāo)簽后執(zhí)行的方法 public int doEndTag() throws JspException { //return Tag.EVAL_PAGE;//結(jié)束標(biāo)簽后的內(nèi)容輸出到瀏覽器 return Tag.SKIP_PAGE;//結(jié)束標(biāo)簽后的內(nèi)容不輸出到瀏覽器 }
那么如何重復(fù)輸出標(biāo)簽體內(nèi)的文本內(nèi)容呢?TagSupper還提供了一個(gè)doAftetBody方法,我們只需要這樣做:
int i = 4; @Override//每輸出一次標(biāo)簽體的內(nèi)容都會(huì)調(diào)用一次這個(gè)方法 public int doAfterBody() throws JspException { while(true) { if(i>0) { i--; return IterationTag.EVAL_BODY_AGAIN;//再執(zhí)行一次便簽體內(nèi)的內(nèi)容 }else{ break; } } return Tag.SKIP_BODY;//不輸出標(biāo)簽體的內(nèi)容 }
以上的內(nèi)容都是控制標(biāo)簽體的內(nèi)容輸出的問(wèn)題,那么能不能改變標(biāo)簽體力的內(nèi)容呢?
很可惜,用TagSupport是不行,但是我們可以用它的子類BodyTagSupport,那么久寫(xiě)一個(gè)類繼承BodyTagSupport類吧~
public class MyTagTest extends BodyTagSupport { private PageContext pageContext; @Override public void setPageContext(PageContext pageContext) { this.pageContext = pageContext; } @Override public int doStartTag() throws JspException { //返回BodyTag.EVAL_BODY_BUFFERED,表示輸出標(biāo)簽體內(nèi)容 //返回Tag.SKIP_BODY,表示不輸出內(nèi)容 return BodyTag.EVAL_BODY_BUFFERED; //return Tag.SKIP_BODY; } @Override public int doEndTag() throws JspException { //得到BodyContent對(duì)象,它包裝了標(biāo)簽體里的內(nèi)容 BodyContent bodyContent = this.getBodyContent(); //利用getString方法得到字符串 String content = bodyContent.getString(); //改變字符串內(nèi)容,將小寫(xiě)改為大寫(xiě) String change = content.toUpperCase(); //輸出到瀏覽器 try { this.pageContext.getResponse().getWriter().write(change); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); } return Tag.SKIP_PAGE; }}
以上~就是自定義標(biāo)簽的創(chuàng)建步驟會(huì)原理,還有一些標(biāo)簽體內(nèi)容的處理方法,大家覺(jué)得容易嗎?
對(duì),十分的不容易啊,用這種方法定義的標(biāo)簽我們稱為傳統(tǒng)標(biāo)簽,所以這是一個(gè)社會(huì)問(wèn)題,是時(shí)候就會(huì)有人站出來(lái),寫(xiě)出一組代碼來(lái)解決這個(gè)問(wèn)題了,這組代碼稱為:簡(jiǎn)單標(biāo)簽
簡(jiǎn)單標(biāo)簽為什么要學(xué)習(xí)傳統(tǒng)標(biāo)簽學(xué)習(xí)傳統(tǒng)標(biāo)簽是為了以后維護(hù)到一些舊系統(tǒng)!!
簡(jiǎn)單標(biāo)簽比傳統(tǒng)標(biāo)簽簡(jiǎn)單在標(biāo)簽處理器類的編寫(xiě)簡(jiǎn)單了!!!
簡(jiǎn)單便簽的開(kāi)發(fā)步驟同樣的,我們先學(xué)習(xí)簡(jiǎn)單標(biāo)簽的開(kāi)發(fā)步驟,然后再說(shuō)說(shuō)它的原理
步驟一
編寫(xiě)標(biāo)簽處理器類,也就是一個(gè)普通的類,繼承SimpleTagSupport類。然后重寫(xiě)它的doTag()方法:
public class MySimpleTag extends SimpleTagSupport { @Override//當(dāng)遇到標(biāo)簽時(shí)就會(huì)執(zhí)行這個(gè)方法 public void doTag() throws JspException, IOException { System.out.println("執(zhí)行了簡(jiǎn)單標(biāo)簽里的doTag()方法~"); }}
步驟二
在tld文件內(nèi)注冊(cè)這個(gè)標(biāo)簽吧~這個(gè)過(guò)程和傳統(tǒng)標(biāo)簽一樣
<tag> <name>simpletag</name> <tag-class>com.vmaxtam.dotest.MySimpleTag</tag-class> <body-content>scriptless</body-content><!--這里要用這個(gè)處理--> </tag>
步驟三
在JSP文件中導(dǎo)入標(biāo)簽庫(kù)(這個(gè)過(guò)程和傳統(tǒng)標(biāo)簽一樣)
步驟四
使用該標(biāo)簽(這個(gè)過(guò)程和傳統(tǒng)標(biāo)簽一樣)
以上就是簡(jiǎn)單標(biāo)簽的定義過(guò)程了,和傳統(tǒng)標(biāo)簽相比,他簡(jiǎn)單就簡(jiǎn)單在不用重寫(xiě)很多方法。
簡(jiǎn)單標(biāo)簽的原理一)和傳統(tǒng)標(biāo)簽一樣,得到tag-class字符串,找到標(biāo)簽處理程序類
二)實(shí)例化標(biāo)簽處理程序類
三)利用對(duì)象調(diào)用方法。。。。
和傳統(tǒng)標(biāo)簽相比,簡(jiǎn)單標(biāo)簽調(diào)用的方法不相同:
SimpleTag接口的方法執(zhí)行過(guò)程:
1)voidsetJspContext(JspContextpc)--設(shè)置pageContext對(duì)象,傳入pageContext對(duì)象。JspContext是PageContext的父類。在標(biāo)簽處理器類中通過(guò)this.getJspContext()方法得到PageContext對(duì)象。
2)voidsetParent(JspTagparent) --傳入父標(biāo)簽對(duì)象,如果沒(méi)有父標(biāo)簽,則不調(diào)用次方法。通過(guò)getParent方法得到父標(biāo)簽對(duì)象
3)voidsetJspBody(JspFragmentjspBody)--傳入標(biāo)簽體內(nèi)容。標(biāo)簽體內(nèi)容封裝到JspFragment方法中。通過(guò)getJspBody方法得到標(biāo)簽體內(nèi)容。如果沒(méi)簽體,不調(diào)用次方法。
4)voiddoTag() --開(kāi)始標(biāo)簽和結(jié)束標(biāo)簽都執(zhí)行次方法。
為什么是這樣調(diào)用方法呢,也是有證據(jù)的:
private boolean _jspx_meth_itcast_005fsimpleDemo_005f0(PageContext _jspx_page_context) throws Throwable { PageContext pageContext = _jspx_page_context; JspWriter out = _jspx_page_context.getOut(); // itcast:simpleDemo 1)實(shí)例化SimpleDemo對(duì)象 gz.itcast.b_simple.SimpleDemo _jspx_th_itcast_005fsimpleDemo_005f0 = new gz.itcast.b_simple.SimpleDemo(); org.apache.jasper.runtime.AnnotationHelper.postConstruct(_jsp_annotationprocessor, _jspx_th_itcast_005fsimpleDemo_005f0); 2)調(diào)用setJspContext方法,傳入PageContext對(duì)象 _jspx_th_itcast_005fsimpleDemo_005f0.setJspContext(_jspx_page_context); 3)調(diào)用setParent方法,如果沒(méi)有父標(biāo)簽,不執(zhí)行。 4)調(diào)用setJspBody方法,傳入標(biāo)簽體內(nèi)容 _jspx_th_itcast_005fsimpleDemo_005f0.setJspBody(new Helper( 0, _jspx_page_context, _jspx_th_itcast_005fsimpleDemo_005f0, null)); 5)調(diào)用doTag方法,執(zhí)行標(biāo)簽 _jspx_th_itcast_005fsimpleDemo_005f0.doTag(); org.apache.jasper.runtime.AnnotationHelper.preDestroy(_jsp_annotationprocessor, _jspx_th_itcast_005fsimpleDemo_005f0); return false; }控制標(biāo)簽體文本與結(jié)束標(biāo)簽后內(nèi)容是否輸出
我們可以通過(guò)JspFragment對(duì)象來(lái)控制的~
標(biāo)簽體內(nèi)容:
要輸出:在doTag()方法中執(zhí)行jspFrament.invoke()方法
不輸出:什么都不做!!
結(jié)束標(biāo)簽后的內(nèi)容:
要輸出:什么都不做!
不輸出:在doTag()方法中拋出一個(gè)SkipPageException異常~!
@Override public void doTag() throws JspException, IOException { JspFragment jspBody = this.getJspBody(); jspBody.invoke(null); throw new SkipPageException(); }
那么如何循環(huán)輸出標(biāo)簽體內(nèi)容呢,在簡(jiǎn)單標(biāo)簽中實(shí)現(xiàn)十分簡(jiǎn)單,在doTag方法中寫(xiě)上
for(int i=1;i<=5;i++){ jspBody.invoke(null);//默認(rèn)寫(xiě)出都瀏覽器 }改變標(biāo)簽體里的內(nèi)容
在doTag方法中寫(xiě)上:
//4.1 創(chuàng)建一個(gè)臨時(shí)的Writer輸出流(容器) StringWriter writer = new StringWriter(); //4.2 把標(biāo)簽體內(nèi)容拷貝到臨時(shí)的Writer流中 JspFragment jspBody = this.getJspBody(); jspBody.invoke(writer); //4.3 從臨時(shí)的Writer流中取出標(biāo)簽體內(nèi)容 String content = writer.toString(); //4.4 改變標(biāo)簽體內(nèi)容 content = content.toUpperCase(); //4.5 把改變后的內(nèi)容寫(xiě)出到瀏覽器中 //jspBody.invoke(null);如果這樣寫(xiě),那么還是輸出原來(lái)的內(nèi)容 this.getJspContext().getOut().write(content);標(biāo)簽體內(nèi)容的輸出格式
除了能設(shè)置標(biāo)簽體內(nèi)容是否輸出,還能夠設(shè)置它的輸出格式,那么它有什么樣的輸出格式呢?
可以有以下輸出格式:
JSP:表示輸出的標(biāo)簽體內(nèi)容可以包含jsp腳本,且可以執(zhí)行此腳本。此值只能用在傳統(tǒng)標(biāo)簽中。
scriptless:表示輸出的標(biāo)簽體內(nèi)容不能包含jsp腳本,如果包含則報(bào)錯(cuò)。
empty:表示沒(méi)有標(biāo)簽體內(nèi)容。即是空標(biāo)簽。如果不是空標(biāo)簽,則報(bào)錯(cuò)。
tagdependent:表示輸出的標(biāo)簽體內(nèi)容可以包含jsp腳本。但不執(zhí)行jsp腳本(直接原樣輸出)
那么我們要在tld文件內(nèi)設(shè)置文本的輸出格式:
<tag> <name>tagDemo</name> <tag-class>gz.itcast.a_tag.TagDemo1</tag-class> <body-content>JSP</body-content><!--在這里設(shè)置--> </tag>
上面都是在討論標(biāo)簽體內(nèi)容的輸出,標(biāo)簽里還可以設(shè)置屬性的,那么自定義標(biāo)簽如何定義標(biāo)簽的屬性呢?
自定義標(biāo)簽的屬性這個(gè)過(guò)程我們?cè)诤?jiǎn)單標(biāo)簽內(nèi)實(shí)現(xiàn),以下是操作步驟
步驟一
在標(biāo)簽處理器類內(nèi)聲明一個(gè)成員變量,,這個(gè)成員變量就用來(lái)接受標(biāo)簽屬性的值,然后再標(biāo)簽處理器類內(nèi)為這個(gè)成員變量生成一個(gè)setter方法:
public class MySimpleTag extends SimpleTagSupport { private Integer num; public void setNum(Integer num) { this.num = num; }
步驟二
要到tld文件注冊(cè)這個(gè)屬性,屬性藥注冊(cè)在響應(yīng)標(biāo)簽的<Tag>標(biāo)簽內(nèi)
<tag> <name>simpletag</name> <tag-class>com.vmaxtam.dotest.MySimpleTag</tag-class> <body-content>scriptless</body-content> <attribute> <name>num</name> <!-- ??? --> <required>true</required><!-- ???????????????? --> <rtexprvalue>true</rtexprvalue><!-- ???????EL??? --> </attribute> </tag>
步驟三
這樣就可以去使用屬性了~
<body> <mmt:simpletag num="1001">我是標(biāo)簽里的內(nèi)容</mmt:simpletag>我是標(biāo)簽后的內(nèi)容 </body>
上面的內(nèi)容就可以創(chuàng)建一個(gè)基本功能的自定義標(biāo)簽了~
新聞熱點(diǎn)
疑難解答
圖片精選
網(wǎng)友關(guān)注