码迷,mamicode.com
首页 > Web开发 > 详细

JSP1.x 自定义标签

时间:2015-01-22 09:28:39      阅读:215      评论:0      收藏:0      [点我收藏+]

标签:jsp   标签   

Tag接口

任何一个标签都对应着一个java类,该类必须实现Tag接口,JSP遇到一个标签后后,将通过一个tld文件查找该标签的实现类,并运行该类的相关方法

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.PageContext;
import javax.servlet.jsp.tagext.Tag;
 
public class TagTestimplements Tag {
      private Tag parent;
      private PageContext pageContext;
 
      @Override
      public int doEndTag() throws JspException{  //标签结束时执行
             JspWriter out =pageContext.getOut();
             try{
                    out.println("……");
             }catch(IOExceptione){
                    throw new JspException(e);
             }
             return EVAL_PAGE;
      }
 
      @Override
      public int doStartTag() throwsJspException {  //标签开始时执行
             return SKIP_BODY;
      }
 
      @Override
      public Tag getParent() {
             // TODO Auto-generated method stub
             return null;
      }
 
      @Override
      public void release() {
             // TODO Auto-generated method stub
 
      }
 
      @Override
      public void setPageContext(PageContextarg0) {
             // TODO Auto-generated method stub
 
      }
 
      @Override
      public void setParent(Tag arg0) {
             // TODO Auto-generated method stub
 
      }
 
}


doStartTag方法可以返回两种参数,如果为SKIP_BODY,表示标签体内的内容不被输出,如果为EVAL_BODY_INCLUDE,则执行标签体内的代码

doEndTag也可以返回两种参数,如果为SKIP_PAGE,表示不执行标签后面的内容。如果为EVAL_PAGE,则执行标签后面的内容

此类中有两个属性,parent和pageContext,parent为该标签的父标签(或者是上一层的标签),pageContext为运行该标签的JSP页面,这两个参数都是JSP在运行时通过setter方法注射进去的

 

Tag实现类有了,还需要tld文件(TagLibrary Descriptor)

 

<?xml version="1.0" ecoding="UTF-8">
 
<taglib 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
      version="2.0">
 
      <tlibversion>1.0</tlibversion>
      <jspversion> 1.1</jspversion>
      <shortname>tagname</shortname>
      <uri>http://www.clf.com/tags</uri>
      <info>A simple tag test</info>
 
<tag>
      <name>tagname</name>
      <tagclass>com.chen.tags.TagTest</tagclass>
      <bodycontent>JSP</ bodycontent>
      <info>tag information</info>
</tag>
 
</taglib>

 

shortname也就是推荐使用的prefix,uri就是引用这个标签库时使用的uri

bodycontent为标签体的限制,有三种取值

empty:不允许有标签体的存在,如果有会抛出异常

JSP:允许有标签体存在,可以为JSP代码

tagdependent:允许有标签体存在,但是标签里的JSP代码不会被执行

 

如果tld文件位于/WEB-INF/下面,Tomcat会自动加载;如果位于其他位置,可以在web.xm中配置

<jsp-config>
      <taglib>
             <taglib-uri> http://www.clf.com/tags</taglib-uri>
             <taglib-location>/WEB-INF/taglib.tld</taglib-location>
      </taglib>
</jsp-config>

TagSupport

多数情况下不需要直接实现Tag接口,使用TagSupport类就可以了,此类是java提供的一个模板类,一般来说,只需要实现doStartTag方法和doEndTag方法就可以了

 

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.tagext.TagSupport;
 
 
public class Tagtest extends TagSupport {
      private int num1;
      private int num2;
 
      @Override
      public int doEndTag() throws JspException{
             try {
             this.pageContext.getOut().println("两数相加等于:"+(num1+num2));
             } catch (Exception e) {
                   
             }
             return EVAL_PAGE;
      }
 
      @Override
      public int doStartTag() throwsJspException {
             return super.doStartTag();
      }
 
      public int getNum1() {
             return num1;
      }
 
      public void setNum1(int num1) {
             this.num1 = num1;
      }
 
      public int getNum2() {
             return num2;
      }
 
      public void setNum2(int num2) {
             this.num2 = num2;
      }
 
}

 

配置文件

 

<tag>
      <name>add</name>
      <tagclass>com.chen.tags.TagTest</tagclass>
      <bodycontent>JSP</bodycontent>
      <info>tag information</info>
      <attribute>
             <name>num1</name>
             <required>true</required >
             <rtexprvalue>true</rtexprvalue >
      </attribute>
      <attribute>
             <name>num2</name>
             <required>true</required >
             <rtexprvalue>true</rtexprvalue >
      </attribute>
</tag>

 

name代表属性的名字,required代表是否是必需的,rtexprvalue代表此属性是否允许使用EL表达式

以上这个标签这样使用:

<taglib:addnum1=”2” num2=”3”/>

则页面会输出2和3 的相加之和

 

BodyTagSupport

BodyTagSupport是Tag接口的子类,专门处理带标签体的标签

public class ToLowerCaseTag extends BodyTagSupport{
      public int doEndTag throws JspException{
             //获取标签体内的代码
             String contend = this.getBodyContent().getString();
      try{
             this.pageContent.getOut().println(content.toLowerCase());
      }catch(Exception e){   }
             return EVAL_PAGE;
      }
}

只要在setBodyContent()方法之后被调用的方法中,都可以使用getBodyContent()方法获取标签体的内容,一般为doAfterBody()或者doEndTag()

BodyTagSupport的执行流程如下:

1.当容器创建一个新的标签实例后,通过setPageContext来设置标签的页面上下文.

2.使用setParent方法设置这个标签的上一级标签,如果没有上一级嵌套,设置为null.

3.设置标签的属性,这个属性在标签库描述文件中定义,如果没有定义属性,就不调用此类方法.

4.调用doStartTag方法,这个方法可以返回EVAL_BODY_INCLUDE和SKIP_BODY,当返回EVAL_BODY_INCLUDE时,就计算标签的body,如果返回SKIP_BODY,就不再计算标签的body,如果为EVAL_BODY_BUFFERED,则不会输出,而是将标签体内容通过setBodyContent()方法注射到标签类中,然后就可以使用getBodyContent()取得标签体的内容

5.调用setBodyContent设置当前的BodyContent.

6.调用doInitBody,如果计算BodyContent时需要进行一些初始化,就在这个方法中进行.

7.每次计算完Body后调用doAfterBody,如果返回EVAL_BODY_AGAIN,表示继续计算一次Body,直到返回SKIP_BODY才继续往下执行.

8.调用doEndTag方法,这个方法可以返回EVAL_PAGE或者SKIP_PAGE,当返回EVAL_PAGE时,容器将在标签结束时继续计算JSP页面其他的部分;如果返回SKIP_PAGE,容器将在标签结束时停止计算JSP页面其他的部分.

9.调用release()方法释放标签程序占用的任何资源。

 技术分享

 

public class LoopTag extends BodyTagSupport{
      private int times;
     
      public int doStartTag() throwsJspException{
             times = 5;
             return super.doStartTag();
      }
 
      public int doAfterBody() throwsJspException{
             if(times-- >0){ 只要times大于零继续循环,同时times自减
                    try{
                    this.getPreviousOut().println(this.getBodyContent().getString());
                    }catch(Exception e){  }
                    return EVAL_BODY_AGAIN;  //继续执行
             }else{
                    return SKIP_BODY;
             }
      }
}

以上定义了一个循环标签

<taglib:loop>loop.</taglib:loop>

会得到如下输出:

loop.

loop. loop.

loop. loop. loop.

loop. loop. loop.loop.

loop. loop. loop.loop. loop.

 

实际上,doAfterBody方法内的输出是写到bodyContent缓存中的

BodyTagSupport中,里面的标签可以通过getparent()方法获得上层的标签

 

JSP1.x 自定义标签

标签:jsp   标签   

原文地址:http://blog.csdn.net/u012152619/article/details/43014597

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!