自定义标签开发步骤(传统标签)

初涉“标签库(Tag Library)”，以一个简单的hello标签开演示开发自定义标签的基本步骤:

 

一、新建一个包test，包中新建一个标签类HelloTag.java，代码如下： 

 

package  test;


import  java.io.IOException;

import  javax.servlet.jsp.JspException;
import  javax.servlet.jsp.JspWriter;
import  javax.servlet.jsp.PageContext;
import  javax.servlet.jsp.tagext.Tag;

public   class  HelloTag  implements  Tag  ... {
    private PageContext pageContext;
    private Tag parent;
    public int doEndTag() throws JspException ...{
        JspWriter out = pageContext.getOut();
        try...{
            out.println("欢迎来到琉璃仙境.");
        }catch(IOException e)...{
            System.err.println(e.toString());
        }
        return EVAL_PAGE;
    }

    public int doStartTag() throws JspException ...{
        return SKIP_BODY;
    }

    public Tag getParent() ...{
        return parent;
    }

    public void release() ...{

    }

    public void setPageContext(PageContext arg0) ...{
        this.pageContext = arg0;
    }

    public void setParent(Tag arg0) ...{
        this.parent = arg0;
    }

}

 

二、在WEB-INF中建立tlds文件夹，在tlds文件夹中加入标签描述文件MyTaglib.tld，内容如下：

 

<? xml version="1.0" encoding="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 http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"
    version ="2.0" >
     < description > Custom Tag Library </ description >
     < tlib-version > 1.0 </ tlib-version >
     < short-name > my </ short-name >
    
     <!-- uri>/mytag</uri -->

     < tag >
         < name > hello </ name >
         < tag-class > test.HelloTag </ tag-class >
         < body-content > empty </ body-content >
     </ tag >
    
</ taglib >

 

三、修改WEB-INF目录下的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 
    http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd" >

     < jsp-config >
         < taglib >
             < taglib-uri > /mytag </ taglib-uri >
             < taglib-location > /WEB-INF/tlds/MyTaglib.tld </ taglib-location >
         </ taglib >
     </ jsp-config >
</ web-app >

 

四、编写hello.jsp调用已定义的hello标签，内容如下：

 

< %@ page  contentType ="text/html;charset=gb2312"  % >
< %@ taglib  uri ="/mytag"  prefix ="my"  % >
< html >
     < head >< title >< my:hello /></ title ></ head >
    
     < body >< my:hello /></ body >
</ html >

 

注：自定义标签有三种引用方式，第一种方式，就如上所述在web.xml文件中设置<tablib>元素。第二种方式，直接将页面的tablib指令的uri属性指定为TLD文件的位置。第三种方式，在TLD文件中设置<uri>元素。