JSP:自定义标签的实现步骤及小例

转载 2015年11月20日 15:03:38

一个非常好的自定义标签的例子就是有权限才显示相应的超链接,这个就可以用自定义标签来完成,在doTag中判断是否有权限。

1. 步骤

  * 标签处理类(标签也是一个对象,那么就需要先有类!)
  * tld文件,它是一个xml
  * 页面中使用<%@taglib%>来指定tld文件的位置

2. 标签处理类JspTag---{Tag、SimpleTag}
  SimpleTag接口:
  * void doTag():每次执行标签时都会调用这个方法;
  * JspTag getParent():返回父标签(非生命周期方法)
  * void setParent(JspTag):设置父标签
  * void setJspBody(JspFragment):设置标签体
  * void seetJspContext(JspContext):设置jsp上下文对象,它儿子是PageContext


  其中doTag()会在其他三个方法之后被tomcat调用。就是Tomcat在解析JSP页面的时候遇到了你定义的标签,

那么就到tld文件中找到相应的类反射生成对象,调用那几个set方法(是不是有点像注入的意思),然后调用doTag。


3. 配置tld文件

tld文件一般都放到WEB-INF之下,这样保证客户端访问不到!
  <tag>
      <name>myTag1</name> 指定当前标签的名称
      <tag-class>cn.itcast.tag.MyTag1</tag-class> 指定当前标签的标签处理类!
      <body-content>empty</body-content> 指定标签体的类型,我们这里使用的是空标签!
  </tag>

4. 页面中指定tld文件位置

<%@ taglib prefix="it" uri="/WEB-INF/tlds/itcast-tag.tld" %>
导标签库,就是为页面指定tld文件的位置!


标签体内容

  * empty:无标签体!
  * JSP:jsp2.0已经不在支持这个类型了!表示标签体内容可以是:java脚本,可以是标签,可以是el表达式
  * scriptless:只能是EL表达式,也可以是其他的标签!
  * tagdependent:标签体内容不会被执行,而是直接赋值标签处理类!

不再执行标签下面内容的标签!在标签处理类中的doTag()中使用SkipPageException来结束!
  Tomcat会调用标签处理类的doTag()方法,然后Tomcat会得到SkipPageException,它会跳过本页面其他内容!翻看源码即知。

标签属性

步骤:
1. 给你的标签处理类添加属性!
  为标签处理类添加属性,属性至少要且一个set方法!这个set方法会在doTag()方法之前被tomcat执行!所在doTag()中就可以使用属性了。

2. 在tld文件中对属性进行配置

      <attribute>
          <name>test</name> 指定属性名
          <required>true</required> 指定属性是否为必需的
          <rtexprvalue>true</rtexprvalue> 指定属性是否可以使用EL

      </attribute>


例子

public class MyTag1 implements SimpleTag {
    private PageContext pageContext;
    private JspFragment body;

    /**
     * 所有的setXxx()方法都会在doTag()方法之前被tomcat调用!
     * 所在doTag()中就可以使用tomcat传递过来的对象了。
     */
    @Override
    public void doTag() throws JspException, IOException {
        pageContext.getOut().print("Hello Tag!");
    }

    @Override
    public JspTag getParent() {
        return null;
    }

    @Override
    public void setJspBody(JspFragment body) {
        this.body = body;
    }

    @Override
    public void setJspContext(JspContext context) {    
        this.pageContext = (PageContext) context;
    }

    public void setParent(JspTag arg0) {}
}


/**
 * SimpleTagSupport它实现了SimpleTag接口。
 *   它已经把所有的tomcat传递的数据都保存起来了!而且还提供了get方法供子类调用!
 * @author cxf
 *
 */
public class MyTag2 extends SimpleTagSupport {
    @Override
    public void doTag() throws JspException, IOException {
        this.getJspContext().getOut().print("再 Hello 一次 Tag!");
    }
}

public class MyTag3 extends SimpleTagSupport {
    @Override
    public void doTag() throws JspException, IOException {
        Writer out = this.getJspContext().getOut();//获取当前jsp页面的输出流
        out.write("******************<br/>");
        this.getJspBody().invoke(out);//执行标签体内容,把结果写到指定的流中,即页面上。
        out.write("<br/>******************");
    }
}
public class MyTag4 extends SimpleTagSupport {
    @Override
    public void doTag() throws JspException, IOException {
        this.getJspContext().getOut().print("只能看到我,下面什么都没有!");
        throw new SkipPageException();//抛出这个异常后,在本标签后面的内容,将看不到!
    }
}
public class MyTag5 extends SimpleTagSupport {
    private boolean test;

    /*
     * 这个方法会由tomcat来调用,并且在doTag()之前
     */
    public void setTest(boolean test) {
        this.test = test;
    }

    @Override
    public void doTag() throws JspException, IOException {
        if(test) {
            /*
             * 执行标签体
             */
            this.getJspBody().invoke(null);//如果传递的输出流为null,表示使用的就是当前页面的out!
        }
    }
}

tld文件定义

<?xml version="1.0" encoding="UTF-8" ?>

<taglib xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd"
    version="2.1">
   
  <tlib-version>1.0</tlib-version>
  <short-name>itcast</short-name>
  <uri>http://www.itcast.cn/tags/it-1.0</uri>
 
  <tag>
      <name>myTag1</name>
      <tag-class>cn.itcast.tag.MyTag1</tag-class>
      <body-content>empty</body-content>
  </tag>
 
  <tag>
      <name>myTag2</name>
      <tag-class>cn.itcast.tag.MyTag2</tag-class>
      <body-content>empty</body-content>
  </tag>
 
  <tag>
      <name>myTag3</name>
      <tag-class>cn.itcast.tag.MyTag3</tag-class>
      <body-content>scriptless</body-content>
  </tag>
 
  <tag>
      <name>myTag4</name>
      <tag-class>cn.itcast.tag.MyTag4</tag-class>
      <body-content>empty</body-content>
  </tag>
 
  <tag>
      <name>myTag5</name>
      <tag-class>cn.itcast.tag.MyTag5</tag-class>
      <body-content>scriptless</body-content>
      <attribute>
          <name>test</name>
          <required>true</required>
          <rtexprvalue>true</rtexprvalue>
      </attribute>
  </tag>
</taglib>
在页面中使用标签

<%@ taglib prefix="it" uri="/WEB-INF/tlds/itcast-tag.tld" %>

<it:myTag5 test="${empty param.xxx }">
  <h1><it:myTag4/></h1>
</it:myTag5>

<h1><it:myTag1/></h1>
<h2><it:myTag2/></h2>
<hr/>
<%
request.setAttribute("xxx", "zhangSan");
%>
<h3>
<it:myTag3>${xxx }</it:myTag3>
</h3>
<h3>
<it:myTag3>我是张三</it:myTag3>
</h3>

JSP入门之自定义标签

第二部分简单讲解:主要讲解el表达式,核心标签库。本章主要讲解:自定义标签库;404页面,505页面,错误页面配置方法...
  • peace1213
  • peace1213
  • 2015年12月15日 10:16
  • 2888

jsp中自定义标签的执行过程

jsp中自定义标签的执行过程 标签处理器的生命周期
  • u013905744
  • u013905744
  • 2017年06月16日 11:33
  • 406

JSTL中的自定义标签的编码步骤

javax.servlet.jsp.tagext.SimpleTag中的方法: void doTag():遇到自定义标签时由服务器调用执行。 JspTag getParent():得到父标签的引用...
  • wangyanming123
  • wangyanming123
  • 2016年09月05日 19:36
  • 162

实现jsp自定义标签

如何在jsp页面中写自定义标签 这里我要实现一个自定义标签的小例子,我把用户名存在cookie中,在登录界面我要从cookie中取出用户名 一.创建和使用一个tag library的基本步骤: 1...
  • sheng_xinjun
  • sheng_xinjun
  • 2016年11月15日 17:42
  • 615

开发第一个JSP自定义标签(Tag)

开发和使用JSP自定义标签过程:1.开发标签实现类.  HelloTag_Interface.java文件内容:import javax.servlet.jsp.tagext.Tag;import j...
  • lip009
  • lip009
  • 2006年10月10日 22:39
  • 9607

jsp自定义标签下拉框

package com.soft.test; import java.sql.*; import sun.jdbc.odbc.ee.ConnectionPool; public cl...
  • xinghui_liu
  • xinghui_liu
  • 2012年01月16日 14:13
  • 752

jsp自定义标签实现分页

jsp自定义标签分页
  • dfdsggdgg
  • dfdsggdgg
  • 2016年05月24日 18:22
  • 2824

【自定义标签开发】01-标签简介和开发第一个标签

自定义标签简介 自定义标签主要用于移除Jsp页面中的java代码。 要使用自定义标签移除jsp页面中的java代码,只需要完成以下两个步骤: 1.编写一个实现Tag接口的java类,把页面java代...
  • u013517797
  • u013517797
  • 2016年04月05日 16:02
  • 1340

JSP自定义标签开发Foreach迭代标签

对于JSP中的容器,进行迭代的方法最好就是使用标签,当然,SUN提供了JSTL标签库,但是我打算自己开发这个标签。 首先得考虑对于单关键字容器和多关键字容器,分别对应Collection 和Map,...
  • a352193394
  • a352193394
  • 2012年01月28日 11:38
  • 3669

jsp自定义标签及简单实例

1.引言 本文将介绍JSP标签的一些基本概念以及如何开发及使用自定义标签。带领大家迈上Java Web开发的又一新台阶. 2.什么是自定义标签 2.1.用户自定义的Java语言元素,实质是运...
  • longwei000
  • longwei000
  • 2016年03月24日 11:40
  • 907
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:JSP:自定义标签的实现步骤及小例
举报原因:
原因补充:

(最多只允许输入30个字)