API文檔:css
//將所在jsp頁面的pageContext注入進來,目的是爲了在後面的方法中可以訪問到jsp頁面對象的pageContext屬性
setPageContext()
//設置此標籤的父標籤
setParent()
//將標籤中的屬性注入到此class的屬性,不需要本身實現但要提供屬性的get與set方法
setAttribute()
//在開始標籤屬性設置後調用。假設返回SKIP_BODY則忽略標籤之中的內容,假設返回EVAL_BODY_INCLUDE則將標籤體的內容進行輸出
doStartTag()
//在結束標籤以前調用,返回SKIP_PAGE跳過整個jsp頁面後面的輸出,返回EVAL_PAGE運行頁面餘下部分
doEndTag()
//生命週期結束時調用
release()
PrintTextTag.javajava
package com.lingdu.tag;
import java.io.IOException;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.PageContext;
import javax.servlet.jsp.tagext.Tag;
public class PrintTextTag implements Tag {
Tag parent;
PageContext pageContext;
@Override
public int doEndTag() throws JspException {
try {
//輸出一句話
this.pageContext.getOut().append("Hello, I am a tag");
} catch (IOException e) {
e.printStackTrace();
}
return PrintTextTag.SKIP_BODY;
}
@Override
public int doStartTag() throws JspException {
// TODO Auto-generated method stub
return 0;
}
@Override
public Tag getParent() {
// TODO Auto-generated method stub
return null;
}
@Override
public void release() {
// TODO Auto-generated method stub
}
@Override
public void setPageContext(PageContext arg0) {
this.pageContext = arg0;
}
@Override
public void setParent(Tag arg0) {
this.parent = arg0;
}
}
在WEB-INF中新建一個pt.tld文件web
寫入配置文件api
<?xml version="1.0" encoding="UTF-8"?>
<taglib version="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/j2ee web-jsptaglibrary_2_0.xsd">
<tlib-version>1.0</tlib-version>
<jsp-version>2.0</jsp-version>
<short-name>Example TLD</short-name>
<tag>
<!-- 定義標籤的名字 -->
<name>hi</name>
<!-- 引用的類 -->
<tag-class>com.lingdu.tag.PrintTextTag</tag-class>
<body-content>empty</body-content>
</tag>
</taglib>
引用pt.tld配置文件:markdown
<%@ taglib prefix="pt" uri="/WEB-INF/pt.tld"%>
pt.jsp源代碼:oracle
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ taglib prefix="pt" uri="/WEB-INF/pt.tld"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
<pt:hi/>
</body>
</html>
PrintTextAttr.javaapp
package com.lingdu.tag;
import java.io.IOException;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.PageContext;
import javax.servlet.jsp.tagext.Tag;
public class PrintTextAttr implements Tag {
Tag parent;
PageContext pageContext;
String username;
@Override
public int doEndTag() throws JspException {
try {
this.pageContext.getOut().append("帶body的標籤");
if(this.getUsername().equals("lingdu")){
this.pageContext.getOut().append("lingdu");
}else{
this.pageContext.getOut().append("You don't enter lingdu !");
}
} catch (IOException e) {
e.printStackTrace();
}
return this.SKIP_BODY;
}
public String getUsername(){
return username;
}
public void setUsername(String username){
this.username = username;
}
@Override
public int doStartTag() throws JspException {
// TODO Auto-generated method stub
return 0;
}
@Override
public Tag getParent() {
// TODO Auto-generated method stub
return null;
}
@Override
public void release() {
// TODO Auto-generated method stub
}
@Override
public void setPageContext(PageContext arg0) {
this.pageContext = arg0;
}
@Override
public void setParent(Tag arg0) {
this.parent = arg0;
}
}
在WEB-INF中新建一個pt.tld文件jsp
寫入配置文件ide
<?xml version="1.0" encoding="UTF-8"?> <taglib version="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/j2ee web-jsptaglibrary_2_0.xsd"> <tlib-version>1.0</tlib-version> <jsp-version>2.0</jsp-version> <short-name>Example TLD2</short-name> <tag> <!-- 定義標籤名字 --> <name>pt2</name> <!-- 指定類的路徑 --> <tag-class>com.lingdu.tag.PrintTextAttr</tag-class> <body-content>empty</body-content> <attribute> <!-- 本身定義定義屬性 --> <name>username</name> <!-- 是不是必須屬性 --> <required>false</required> <!-- 使用標籤時可否夠使用表達式來動態指定數據 --> <rtexprvalue>true</rtexprvalue> </attribute> </tag> </taglib>
引用pt.tld配置文件:
<%@ taglib prefix="pt" uri="/WEB-INF/pt.tld"%>
pt2.jsp源代碼:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ taglib prefix="pt2" uri="/WEB-INF/pt2.tld"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
<% //測試屬性 request.setAttribute("username", "lingdu"); %>
<pt2:pt2 username="${username }"/>
</body>
</html>
將測試屬性去掉
Element: //Description
tlib-version: //Tag庫的版本號
jsp-version: //Tag庫所需要的jsp的版本號
short-name: //助記符,tag的一個別名(可選)
uri: //用於肯定一個惟一的tag庫
display-name: //被可視化工具用來顯示的名稱(可選)
small-icon: //被可視化工具用來顯示的小圖標(可選)
large-icon: //被可視化工具用來顯示的大圖標(可選)
description: //對tag庫的描寫敘述(可選)
listener: //參見如下listener元素
tag: //參見如下tag 元素
Listener元素: //一個tag庫可能定義一些類作爲它的事件偵聽類,這些類在TLD中被稱爲listener 元素。jspserver將會實例化這些偵聽類。並且註冊它們。Listener元素中有一個叫listener-class的子元素,這個元素的值必須是該偵聽類的完整類名。
每個tag元素在tag庫中都要指出它的名字、類名、腳本變量、tag的屬性。當中腳本變量的值可以直接在TLD中定義或經過tag附加信息的類來取得。每個屬性描寫敘述了這個屬性可否夠省略,它的值可否夠經過<%=…%>這種JSP語法來得到,以及屬性的類型。每個tag在TLD中相應一個tag元素。下表是tag元素的子元素:
name: //獨一無二的元素名
tag-class: //Tag標籤相應的tag處理類
tei-class: //javax.servlet.jsp.tagext.TagExtraInfo的子類,用於表達腳本變量(可選)
body-content: //Tag標籤body的類型
display-name: //被可視化工具用來顯示的名稱(可選)
small-icon: //被可視化工具用來顯示的小圖標(可選)
large-icon: //被可視化工具用來顯示的大圖標(可選)
description: //此tag標籤的描寫敘述
variable: //提供腳本變量的信息 (可選)
attribute: //Tag標籤的屬性名