自定义标签之HelloWorld

标签扩展是一个JAVA类，它是运行一个或者二个接口的JAVABEAN。在JSP规范内标签具有比JAVABEAN更丰富的运行时协议，因为
1：初始化可以包含属性，没有这些属性标签就不能运行 ，而JAVABEAN的构造 函数 参数 为空
2：设置和获取属性不会涉及到所有的类，在BEAN中只有少量的逻辑控制。
3：JSP页面中的BEAN没有 默认设置上下文，也就是说，BEAN没有一个父类的或者页面上下文对象的默认概念。
JSP所有的标签都实现了javax.servlet.jsp.tagext.JspTag接口。这个接口是一个标记接口，它有二个子接口：
1：一个是SimpleTag，它是JSP2.0新增加的接口，代表了简单的标签。
2：第二个是Tag接口，它是经典的，必须实现的接口，它有一个直接子接口就是IterationTag
IterationTag用于开发出抚今追昔的标签，它有一个简单的实现类为TagSupport。在开发时，我们只要从TagSupport扩展就可以开发出抚今追昔标签了。IterationTag还有一个子接口，就是BodyTag,这种标签允许带有Body。BodyTag也有一个实现类，就是BodyTagSupport，在开发BodyTag时，往往直接从它继承就可以了。当然了，我们在开发自己的标签时除了继承原有的类外，也可以直实现Tag接口。

HelloWorld标签开发
传统的标签必须实现javax.servlet.jsp.tagext.Tag接口，在这个接口中，主要定义的是和标签声明周期相关的方法，比如doStartTag() ,doEndTag() 等。在Tag中，可以通过pageContext对象访问JSP页面 的上下文。下面结合标签的生命周期讨论下标签的处理过程。JSP1.2标签的生命周期如下
1：当容器创建一个新的标签实例后，通过setPageContext设置标签的页面上下文。
2：使用setParent方法设置这个标签的上一级标签。如果没有上一级嵌套，设置为空。
3：设置标签的属性。这个属性在标签库描述文件中定义。如果没有定义属性就不调用此类方法。
4：调用 doStartTag方法，这个方法可以返回EVAL_BODY_INCLUDE和SKIP_BODY。当返回EVAL_BODY_INCLUDE时，就计算标签的BODY，如果返回SKIP_BODY，就不计算标签的BODY。
5：调用doEndTag方法，这个方法可以返回EVAL_PAGE或者SKIP_PAGE。当返回EVAL_PAGE时，容器将在标签结束时继续计算JSP页面的其他部分;如果返回SKIP_PAGE，容器将在标签结束时停止计算JSP页面的其他部分。
6：调用release方法释放标签程序占用的任何资源。
在开发标签时，可以有两种选择，一种是直接实现原始接口，另一种是从TagSupport类继承。下面我使用二种不同的方式来写一个HelloWorld标签程序

一：实现Tag接口
1：开发实现类

package  eflylab;

import  javax.servlet.jsp. * ;
import  javax.servlet.jsp.tagext. * ;
import  java.util.Hashtable;
import  java.io.Writer;
import  java.io.IOException;
import  java.util.Date;       

/** */ /**
 *演示怎么实现Tag接口的方式来开发标签程序
 */
public   class  HelloTag_Interface  implements  javax.servlet.jsp.tagext.Tag
{
     private PageContext pageContext;
     private Tag parent;
     public HelloTag_Interface()
     {  
       super();
     }
     
    /** *//**
      *设置标签的页面的上下文
      */
     public void setPageContext(final javax.servlet.jsp.PageContext pageContext) 
     { 
           this.pageContext=pageContext;  
     }
     
    /** *//**
      *设置上一级标签
      */
     public void setParent(final javax.servlet.jsp.tagext.Tag parent) 
     {   
          this.parent=parent;   
     }
     
     /** *//**
      *开始标签时的操作
      */
     public int doStartTag() throws javax.servlet.jsp.JspTagException  
     {   
          return SKIP_BODY;  //返回SKIP_BODY，表示不计算标签体
     }
     
     /** *//**
      *结束标签时的操作
      */
     public int doEndTag() throws javax.servlet.jsp.JspTagException  
     {
           try
           {   
                pageContext.getOut().write("Hello World!你好，世界！");
           }                  
          catch(java.io.IOException e)
          {
                throw new JspTagException("IO Error: " + e.getMessage());
          }  
          return EVAL_PAGE; 
      }
     
     /** *//**
      *release用于释放标签程序占用的资源，比如使用了数据库，那么应该关闭这个连接。
      */
     public void release() {}    
    
    
     public javax.servlet.jsp.tagext.Tag getParent()   
     {    
        return parent;
     }
}

2：编写标签库描述(mytag.tld)
  在WEB-INF\tlds 下新建一个mytag.tld文件

?xml version="1.0" encoding="GBK" ?>

< 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" >
     < description > A tag library exercising SimpleTag handlers. </ description >
     < tlib-version > 1.0 </ tlib-version >

   < short-name > examples </ short-name >
   < uri > /demotag </ uri >
   < description >
    A simple tab library for the examples
   </ description >

  

  < tag >
     < description > Outputs Hello, World,从实现Tag接口起开发 </ description >
         < name > hello_int </ name >
     < tag-class > eflylab.HelloTag_Interface </ tag-class >
     < body-content > empty </ body-content >
     </ tag >
  
</ taglib >

3：在web.xml中配置自定义标签

<? xml version="1.0" encoding="UTF-8" ?>
< web-app  version ="2.4"  
    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-app_2_4.xsd" >
   <!--  要正确在MyEclipse生成的web.xml中使用 tag 元素，必须将上面一行
      http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd 改为
       web-app_2_4.xsd -->
   < taglib >
     < taglib-uri > /demotag </ taglib-uri >
     < taglib-location > /WEB-INF/tlds/mytag.tld </ taglib-location >
   </ taglib >
</ web-app >

4：使用的JSP页面

<% @ taglib uri="/demotag" prefix="hello"  %>
<% @ page contentType="text/html; charset=gb2312" language="java"  %>
< html >
< head >
< title > first cumstomed tag </ title >
< meta  http-equiv ="Content-Type"  content ="text/html; charset=gb2312" >
</ head >

< body >
< p > 以下的内容从Taglib中显示： </ p >
< p >< i >< hello:hello_int /></ i ></ p >
</ body >
</ html >

运行：
以实现Tag接口开发，我们看到我们的实现类中实现了Tag接口中的所有方法，我们比较关心的是doStartTag和doEndTag方法。

二：从TagSupport继承
上面的是从Tag接口开始编写标签库，现在还是以HelloWorld为例，看一下如何从TagSupport类继承

package  eflylab;

import  javax.servlet.jsp. * ;
import  javax.servlet.jsp.tagext. * ;
import  java.util.Hashtable;
import  java.io.Writer;
import  java.io.IOException;
import  java.util.Date;       

/** */ /**
 *演示从TagSupport继承来开发标签
 */
public   class  HelloTag  extends  TagSupport
{
    /** *//**
     *覆盖doStartTag方法
     */
    public int doStartTag() throws JspTagException {
    return EVAL_BODY_INCLUDE;
    }
    
    /** *//**
     *覆盖doEndTag方法
     */
    public int doEndTag()throws JspTagException
    {
        String dateString =new Date().toString();
        try
        {
            pageContext.getOut().write("Hello World hellking.<br>现在的时间是："+dateString);
            
        }
        catch(IOException ex)
        {
            throw new JspTagException("Fatal error:hello tag conld not write to JSP out");
        }
        return EVAL_PAGE;
    }
}
 

在上面代码中，由于从TagSupport继承，因为前面说过，TagSupport是Tag接口的子接口ItrationTag接口的实现类，所以我们可以只覆盖两个方法就开发出了标签 ，这种比较简单，
由于可以在一个TLD文件中定义多个标签，所以我们还是用上面的mytag.tld文件定义这个标签

<? xml version="1.0" encoding="GBK"  ?>

< 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" >
     < description > A tag library exercising SimpleTag handlers. </ description >
     < tlib-version > 1.0 </ tlib-version >
       < short-name > examples </ short-name >
       < uri > /demotag </ uri >
       < description >
        A simple tab library for the examples
       </ description >

  

  < tag >
     < description > Outputs Hello, World,从实现Tag接口起开发 </ description >
         < name > hello_int </ name >
     < tag-class > eflylab.HelloTag_Interface </ tag-class >
     < body-content > empty </ body-content >
</ tag >
    
   < tag >
     < name > hello </ name >
     < tag-class > eflylab.HelloTag </ tag-class >
     < body-content > empty </ body-content >
     < description >
    Simple hello world examples.
    Takes no attribute,and simply generates HTML
     </ description >
   </ tag >
</ taglib >

测试页面

<% @ taglib uri="/demotag" prefix="hello"  %>
<% @ page contentType="text/html; charset=gb2312" language="java"  %>
< html >
< head >
< title > first cumstomed tag </ title >
< meta  http-equiv ="Content-Type"  content ="text/html; charset=gb2312" >
</ head >

< body >

< p > 以下的内容从Taglib中显示： </ p >
< p >< i >< hello:hello /></ i ></ p >
</ body >
</ html >

运行