自定义JSP标签实战-优快云博客

通过自定义标签显示日期为例

(一) 没有正文的标签实现

(1):定义标签处理类

import java.io.IOException;
import java.util.Date;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.Tag;
import javax.servlet.jsp.tagext.TagSupport;
//无正文标签类继承的是TagSupport类实现的接口是Tag。如果有正文的标签类继承的是BodyTagSupport类实现的接口是BodyTag
public class DateTagNoBody extends TagSupport {
@Override
public int doStartTag() throws JspException {
  HttpServletRequest request;
  // 是TagSupport类中定义的一个属性，它是javax.servlet.jsp.PageContext的对象
  request = (HttpServletRequest) pageContext.getRequest();
  java.text.SimpleDateFormat formater = new java.text.SimpleDateFormat("yyyy-MM-dd");
  String date = formater.format(new Date());
  JspWriter out = pageContext.getOut();
  try {
   out.print(date);
  } catch (IOException e) {
   e.printStackTrace();
  }
  // doStartTag() 方法返回 SKIP_BODY 。当然其原因是我们的简单日期标记没有正文。
  return Tag.SKIP_BODY;
}
}

(2) 定义tld文件

(3) jsp 页面动态引用

<%@ page language="java" pageEncoding="UTF-8"%>
<%@ taglib uri="/WEB-INF/datetag.tld" prefix="c"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
</head>
<body>
<c:displayDate/>
</body>
</html>

注意：动态引用和静态引用的区别。

为了进行静态引用，首先必须将下面的项加入到 web.xml 文件中：
<?xml version="1.0" encoding="ISO-8859-1" ?>
<Web-app>
   <taglib>
      <taglib-uri>myTags</taglib-uri>
      <taglib-location>/WEB-INF/lib/DateTagLib.tld</taglib-location>
   </taglib>
</Web-app>
然后，将 JSP 声明加入到所有需要使用自定义标记库的页面中：
<%@ taglib uri="myTags" prefix="c" %>
指定的 uri 属性与在 web.xml 文件中指定的 taglib-uri 值相匹配。

在进行标记库的静态引用时，JSP 声明必须查询 web.xml 文件以执行库查询。这意味着如果移动或者重命名了库，或者希望在 web.xml 文件中加入更多的库，就必须停止服务器、更新 web.xml 文件、然后重新启动服务器。动态方法让 JSP 页直接指向 TLD 位置，因而是在解释 JSP 页面时进行处理。

(二) 没有正文的但带有属性的标签实现

(1):定义标签处理类

import java.io.IOException;
import java.util.Date;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.Tag;
import javax.servlet.jsp.tagext.TagSupport;
//无正文标签类继承的是TagSupport类实现的接口是Tag。如果有正文的标签类继承的是BodyTagSupport类实现的接口是BodyTag
public class DateTagNoBody extends TagSupport {

private String pattern;
@Override
public int doStartTag() throws JspException {
  HttpServletRequest request;
  // 是TagSupport类中定义的一个属性，它是javax.servlet.jsp.PageContext的对象
  request = (HttpServletRequest) pageContext.getRequest();
  java.text.SimpleDateFormat formater = new java.text.SimpleDateFormat(pattern);
  String date = formater.format(new Date());
  JspWriter out = pageContext.getOut();
  try {
   out.print(date);
  } catch (IOException e) {
   e.printStackTrace();
  }
  // doStartTag() 方法返回 SKIP_BODY 。当然其原因是我们的简单日期标记没有正文。
  return Tag.SKIP_BODY;
}

//必须实现setXX()方法
public void setPattern(String pattern){
  this.pattern = pattern;
}
}

(2) 定义tld文件

<?xml version="1.0" encoding="UTF-8"?>
<taglib>
   <tlibversion>1.0</tlibversion>
   <jspversion>1.1</jspversion>
<tag>
    <name>displayDate</name>
    <tagclass>cn.com.chenlly.tag.DateTagNoBody</tagclass>
    <bodycontent>empty</bodycontent>
    
    <attribute>
       <name>pattern</name> 
       <type>String</type> 
       <requried>false</requried> 
       <rtexprvale>false</rtexprvale> 
</attribute>
</tag>
</taglib>

(3) jsp 页面动态引用

(三) 有正文的且带有属性的标签实现

(1):定义标签处理类

public class BodyTag extends BodyTagSupport {

private int count;

private HttpServletRequest reqeust;

private JspWriter out;

public void init() {
reqeust = (HttpServletRequest) pageContext.getRequest();
out = pageContext.getOut();
}

@Override
public int doStartTag() throws JspException {
  init();
  return this.EVAL_BODY_INCLUDE;
}

//设置当前标签体
@Override
public void setBodyContent(BodyContent bodyContent) {
  this.bodyContent = bodyContent;
  System.out.println("setBodyContent...");
}

//需要初始化bodyContent
@Override
public void doInitBody() throws JspException {
System.out.println("init.....");
}

@Override
public int doAfterBody() throws JspException {
  if (count >= 1) {
   try {
    out.println(count);
    out.println("<Br>");
   } catch (IOException e) {
    e.printStackTrace();
   }
   count --;
   return this.EVAL_BODY_AGAIN;
  } else {
   return this.SKIP_BODY;
  }
}

@Override
public int doEndTag() throws JspException {
  java.text.SimpleDateFormat formater = new java.text.SimpleDateFormat(
    "yyyy-MM-dd");
  String date = formater.format(new Date());
  try {
   out.print(date);
  } catch (IOException e) {
   e.printStackTrace();
  }
  return this.EVAL_PAGE;
}

// 必须实现setXX()方法
public void setCount(int count) {
this.count = count;
}
}

(2) 定义tld文件

<?xml version="1.0" encoding="UTF-8"?>
<taglib>
   <tlibversion>1.0</tlibversion>
   <jspversion>1.1</jspversion>
<tag>
    <name>iterator</name>
    <tagclass>cn.com.chenlly.tag.BodyTag</tagclass>
    <bodycontent>jsp</bodycontent>
    
    <attribute>
       <name>count</name> 
       <type>int</type> 
       <requried>false</requried> 
       <rtexprvale>false</rtexprvale> 
</attribute>
</tag>
</taglib>

(3) jsp 页面动态引用

<%@ page language="java" pageEncoding="UTF-8"%>
<%@ taglib uri="/WEB-INF/bodytag.tld" prefix="c"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
</head>
<body>
   <c:iterator count="10">HelloWorld!</c:iterator>
   <%
   out.println("Bye Bye");
    %>
</body>
</html>

效果图：

执行顺序

doStartTag()->setBodyContent()->doInitBody()->doAfterTag()->doEndTag()
如果doStartTag()返回的是EVAL_BODY_INCLUDE执行doAfterTag()方法,
如果它返回SKIP_BODY就执行doEndTag()方法。
setBodyContent()方法用于设置标签体内容，如果在计算BodyContent时需要进行一些初始化工作，
则在doInitBody()方法中完成。标签体内容执行完后，会调用doAfterBody()方法
在doAfterTag()方法中返回EVAL_BODY_AGAIN来重复执行doAfterTag()方法
返回SKIP_BODY值则执行doEndTag()方法。
在doEndTag()方法中返回EVAL_PAGE值,则执行此标签的后的其它代码,
返回SKIP_PAGE则不执行此页面的其它代码。

Jsp自定义标签实现