一、創建自定義標簽基本步驟 1、步驟 標簽處理類(標簽也是一個對象,那麼就需要先有類!) tld文件,它是一個xml 頁面中使用<%@taglib%>來指定tld文件的位置 2、標簽處理類 SimpleTag介面 void doTag():每次執行標簽時都會調用這個方法; JspTag getPar ...
一、創建自定義標簽基本步驟
1、步驟
標簽處理類(標簽也是一個對象,那麼就需要先有類!)
tld文件,它是一個xml
頁面中使用<%@taglib%>來指定tld文件的位置
2、標簽處理類
SimpleTag介面
- void doTag():每次執行標簽時都會調用這個方法;
- JspTag getParent():返回父標簽(非生命周期方法)
- void setParent(JspTag):設置父標簽
- void setJspBody(JspFragment):設置標簽體
- void setJspContext(JspContext):設置jsp上下文對象,它的子類是PageContext
其中doTag()會在其他三個方法之後被Tomcat調用。
3、配置tld文件
tld文件一般都放到WEB-INF之下,這樣保證客戶端訪問不到。
<tag> <name>MyTag1</name> 指定當前標簽的名稱 <tag-class>tag.MyTag1</tag-class> 指定當前標簽的標簽處理類 <body-content>empty</body-content> 指定標簽體的類型,我們這裡使用的是空標簽。 </tag>
4、頁面中指定tld文件位置
二、標簽體內容
1、標簽體內容
- empty:無標簽體。
- JSP:jsp2.0已經不再支持這個類型。表示標簽體內容可以是:Java腳本,可以是標簽,可以是EL表達式。
- scriptless:只能是EL表達式,也可以是其他標簽。
- tagdependent:標簽體內容不會被執行,而是直接賦值標簽處理類。
2、不再執行標簽下麵內容的標簽。
- 在標簽處理類中的doTag()使用SkipPageException來結束。
- Tomcat會調用標簽處理類的doTag()方法,然後Tomcat會得到SkipPageException,它會跳過本頁面其他內容。
三、標簽屬性
步驟:
1、給你的標簽處理類添加屬性。
為標簽處理類添加屬性,屬性至少要且一個set方法,這個set方法會在doTage()方法之前被Tomcat執行,所在doTage()中就可以使用屬性了。
2、在tld文件中對屬性進行配置。
<attribute>
<name>test</name> 指定屬性名
<required>true</required> 指定屬性是否為必需的
<rtexprvalue>true</rtexprvalue> 指定屬性是否可以使用EL表達式
</attribute>
四、示例:
1 package tag;
2
3 import javax.servlet.jsp.JspContext;
4 import javax.servlet.jsp.JspException;
5 import javax.servlet.jsp.PageContext;
6 import javax.servlet.jsp.tagext.JspFragment;
7 import javax.servlet.jsp.tagext.JspTag;
8 import javax.servlet.jsp.tagext.SimpleTag;
9 import java.io.IOException;
10
11 /**
12 * 自定義標簽
13 */
14 public class MyTag1 implements SimpleTag {
15 private PageContext pageContext;
16 private JspFragment body;
17 /**
18 * 所有的setXXX()方法都會在doTag()方法之前被Tomcat調用。
19 * 所有doTag()中就可以使用Tomcat傳遞過來的對象了。
20 * */
21 @Override
22 public void doTag() throws JspException, IOException {
23 pageContext.getOut().print("Hello Tag!");
24 }
25 @Override
26 public void setParent(JspTag jspTag) {}
27 @Override
28 public JspTag getParent() {return null; }
29 @Override
30 public void setJspContext(JspContext context) {
31 this.pageContext = (PageContext) context;
32 }
33 @Override
34 public void setJspBody(JspFragment body) {
35 this.body = body;
36 }
37 }
1 package tag;
2
3 import javax.servlet.jsp.JspException;
4 import javax.servlet.jsp.tagext.SimpleTagSupport;
5 import java.io.IOException;
6
7 /**
8 * SimpleTagSupport它實現了SimpleTag介面。
9 * 它已經把所有的Tomcat傳遞的數據都保存起來了,而且還提供了get方法子類調用。
10 */
11 public class MyTag2 extends SimpleTagSupport {
12 @Override
13 public void doTag() throws JspException, IOException {
14 this.getJspContext().getOut().print("Hello 第二次");
15 }
16 }
1 package tag;
2
3 import javax.servlet.jsp.JspException;
4 import javax.servlet.jsp.tagext.SimpleTagSupport;
5 import java.io.IOException;
6 import java.io.Writer;
7
8 public class MyTag3 extends SimpleTagSupport {
9 @Override
10 public void doTag() throws JspException, IOException {
11 Writer out = this.getJspContext().getOut();//獲取當前jsp頁面的輸出流
12 out.write("****************************<br/>");
13 this.getJspBody().invoke(out);//執行標簽體內容,把結果寫到指定的流中,即頁面上
14 out.write("<br/>****************************");
15 }
16 }
1 package tag;
2
3 import javax.servlet.jsp.JspException;
4 import javax.servlet.jsp.SkipPageException;
5 import javax.servlet.jsp.tagext.SimpleTagSupport;
6 import java.io.IOException;
7
8 public class MyTag4 extends SimpleTagSupport {
9 @Override
10 public void doTag() throws JspException, IOException {
11 this.getJspContext().getOut().print("只能看到我,下麵什麼都沒有!");
12 throw new SkipPageException();//拋出這個異常後,在本標簽後面的內容,將看不到。
13 }
14 }
1 package tag;
2
3 import javax.servlet.jsp.JspException;
4 import javax.servlet.jsp.tagext.SimpleTagSupport;
5 import java.io.IOException;
6
7 /**
8 * 有屬性的標簽
9 */
10 public class MyTag5 extends SimpleTagSupport {
11 private boolean test;
12
13 /**
14 * 這個方法會有Tomcat來調用,併在doTage()之前
15 * */
16 public void setTest(boolean test) {
17 this.test = test;
18 }
19 @Override
20 public void doTag() throws JspException, IOException {
21 /**
22 * 執行標簽體
23 * */
24 if (test) {
25 this.getJspBody().invoke(null);//如果傳遞的輸出流為null,表示使用的就是當前頁面的out。
26 }
27 }
28 }
1 <?xml version="1.0" encoding="UTF-8" ?> 2 3 <taglib xmlns="http://java.sun.com/xml/ns/j2ee" 4 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 5 xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd" 6 version="2.0"> 7 8 <tlib-version>1.0</tlib-version> 9 <short-name>itcast</short-name> 10 <uri>http://www.itcast.cn/tags/it-1.0</uri> 11 <tag> 12 <name>MyTag1</name> 13 <tag-class>tag.MyTag1</tag-class> 14 <body-content>empty</body-content> 15 </tag> 16 <tag> 17 <name>MyTag2</name> 18 <tag-class>tag.MyTag2</tag-class> 19 <body-content>empty</body-content> 20 </tag> 21 <tag> 22 <name>MyTag3</name> 23 <tag-class>tag.MyTag3</tag-class> 24 <body-content>scriptless</body-content> 25 </tag> 26 <tag> 27 <name>MyTag4</name> 28 <tag-class>tag.MyTag4</tag-class> 29 <body-content>empty</body-content> 30 </tag> 31 <tag> 32 <name>MyTag5</name> 33 <tag-class>tag.MyTag5</tag-class> 34 <body-content>scriptless</body-content> 35 <attribute> 36 <name>test</name> 37 <required>true</required> 38 <rtexprvalue>true</rtexprvalue> 39 </attribute> 40 </tag> 41 </taglib>
1 <%@ page contentType="text/html;charset=UTF-8" language="java" %>
2 <%@ taglib prefix="it" uri="/WEB-INF/tlds/itcast.tld" %>
3 <html>
4 <head>
5 <title>$Title$</title>
6 </head>
7 <body>
8
9 <it:MyTag5 test="${empty param.xxx}">
10 <h1><it:MyTag4/></h1>
11 </it:MyTag5>
12 <h1><it:MyTag1/></h1>
13 <h1><it:MyTag2/></h1>
14 <hr/>
15 <%
16 request.setAttribute("xxx","zhangsan");
17 %>
18 <h3><it:MyTag3>${xxx}</it:MyTag3></h3>
19 <h3><it:MyTag3>字元串®</it:MyTag3></h3>
20
21 </body>
22 </html>