JSP本身定義標籤

JSP本身定義標籤


API文檔:
css

http://docs.oracle.com/javaee/7/api/html


1

2

//將所在jsp頁面的pageContext注入進來,目的是爲了在後面的方法中可以訪問到jsp頁面對象的pageContext屬性
setPageContext()

//設置此標籤的父標籤
setParent()       

//將標籤中的屬性注入到此class的屬性,不需要本身實現但要提供屬性的get與set方法
setAttribute()   

//在開始標籤屬性設置後調用。假設返回SKIP_BODY則忽略標籤之中的內容,假設返回EVAL_BODY_INCLUDE則將標籤體的內容進行輸出
doStartTag()  

//在結束標籤以前調用,返回SKIP_PAGE跳過整個jsp頁面後面的輸出,返回EVAL_PAGE運行頁面餘下部分
doEndTag() 

//生命週期結束時調用
release()

無body。無屬性的標籤



一、建立一個類,實現Tag接口

3




PrintTextTag.java
java

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;

    }

}

二、建立.tld配置文件



在WEB-INF中新建一個pt.tld文件
web

4




寫入配置文件
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>

三、在jsp中使用本身定義標籤



引用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>

5




有body,有屬性的標籤

6


一、建立一個類。實現Tag接口



PrintTextAttr.java
app

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;

    }

}

二、建立.tld配置文件



在WEB-INF中新建一個pt.tld文件
jsp

7




寫入配置文件
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>

三、在jsp中使用本身定義標籤



引用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>

8



將測試屬性去掉

9




tld文件具體解釋


<taglib>的子元素


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庫中都要指出它的名字、類名、腳本變量、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標籤的屬性名
相關文章
相關標籤/搜索