自定义标签之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>

运行