自定义标签

 

自定义标签简介

自定义标签主要用于移除Jsp页面中的java代码。

快速入门：使用自定义标签输出客户机IP

移除jsp页面中的java代码，只需要完成两个步骤：

编写一个实现Tag接口的Java类，并覆盖doStartTag方法，把jsp页面中的java代码写到doStartTag方法中。

编写标签库描述符（tld）文件，在tld文件中对自定义标签进行描述。

完成以上操作，即可在JSP页面中导入和使用自定义标签。

查看tag接口api文档，分析自定义标签的执行流程。

Tag接口的执行流程

JSP引擎将遇到自定义标签时，首先创建标签处理器类的实例对象，然后按照JSP规范定义的通信规则依次调用它的方法。

       1、public void setPageContext(PageContext pc)， JSP引擎实例化标签处理器后，将调用setPageContext方法将JSP页面的pageContext对象传递给标签处理器，标签处理器以后可以通过这个pageContext对象与JSP页面进行通信。

       2、public void setParent(Tag t)，setPageContext方法执行完后，WEB容器接着调用的setParent方法将当前标签的父标签传递给当前标签处理器，如果当前标签没有父标签，则传递给setParent方法的参数值为null。

       3、public int doStartTag()，调用了setPageContext方法和setParent方法之后，WEB容器执行到自定义标签的开始标记时，就会调用标签处理器的doStartTag方法。

       4、public int doEndTag()，WEB容器执行完自定义标签的标签体后，就会接着去执行自定义标签的结束标记，此时，WEB容器会去调用标签处理器的doEndTag方法。

       5、public void release()，通常WEB容器执行完自定义标签后，标签处理器会驻留在内存中，为其它请求服务器，直至停止web应用时，web容器才会调用release方法。

简单标签

由于传统标签使用三个标签接口来完成不同的功能，显得过于繁琐，不利于标签技术的推广， SUN公司为降低标签技术的学习难度，在JSP 2.0中定义了一个更为简单、便于编写和调用的SimpleTag接口来实现标签的功能。实现SimpleTag接口的标签通常称为简单标签。简单标签共定义了5个方法：

setJspContext方法

setParent和getParent方法

setJspBody方法

doTag方法

JspFragment类

javax.servlet.jsp.tagext.JspFragment类是在JSP2.0中定义的，它的实例对象代表JSP页面中的一段符合JSP语法规范的JSP片段，这段JSP片段中不能包含JSP脚本元素。

WEB容器在处理简单标签的标签体时，会把标签体内容用一个JspFragment对象表示，并调用标签处理器对象的setJspBody方法把JspFragment对象传递给标签处理器对象。JspFragment类中只定义了两个方法，如下所示：

getJspContext方法

用于返回代表调用页面的JspContext对象.

public abstract void invoke(java.io.Writer out)

用于执行JspFragment对象所代表的JSP代码片段

参数out用于指定将JspFragment对象的执行结果写入到哪个输出流对象中，如果传递给参数out的值为null，则将执行结果写入到JspContext.getOut()方法返回的输出流对象中。(简而言之，可以理解为写给浏览器)

一、简单标签的使用

1）使用自定义标签控制页面内容（标签体）是否输出

public void doTag() throws JspException, IOException {

       // TODO Auto-generated method stub

       //JspFragment jf=this.getJspBody();//得到标签体对象

       //jf.invoke(this.getJspContext().getOut());

       //jf.invoke(null);

}

2）简单标签控制该自定义标签后的JSP内容是否执行

创建一个标签处理器：

       public void doTag() throws JspException, IOException {

              // TODO Auto-generated method stub

              //JspFragment jf=this.getJspBody();

              //jf.invoke(null);如果没有标签体，抛异常

              throw new SkipPageException();

       }

tld文件进行描述

3）简单标签控制迭代

创建一个标签处理器

public void doTag() throws JspException, IOException {

              // TODO Auto-generated method stub

              JspFragment jf=this.getJspBody();

              for(int i=0;i<count;i++)

                     jf.invoke(null);

}

增加一个属性：count

private int count;

public void setCount(int count) {

       this.count = count;

}

 

<csdn:demo8 count="${data}">

"<%=data+1%>"  rt runtime

4）简单标签控制标签体的内容进行修改

创建一个标签处理器

public void doTag() throws JspException, IOException {

       // TODO Auto-generated method stub

       JspFragment jf=this.getJspBody();

             

       //

       StringWriter sw=new StringWriter();

       jf.invoke(sw);

             

       String content=sw.toString().toUpperCase();

             

       JspWriter jw=this.getJspContext().getOut();

       jw.write(content);

             

}