JSP本身定义标签

时间  2019-11-18
标签 jsp 本身 定义 标签 栏目 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.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;

    }

}

二、建立.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.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;

    }

}

二、建立.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标签的属性名
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程