jsp中自定義標(biāo)簽用法實(shí)例分析

更新時(shí)間：2015年09月28日 11:51:07 作者：土豆-地瓜

這篇文章主要介紹了jsp中自定義標(biāo)簽用法,以實(shí)例形式較為詳細(xì)的分析了jsp自定義標(biāo)簽的功能、定義及具體實(shí)現(xiàn)技巧,具有一定參考借鑒價(jià)值,需要的朋友可以參考下

本文實(shí)例講述了jsp中自定義標(biāo)簽用法。分享給大家供大家參考。具體如下：

這里簡(jiǎn)單的寫了一個(gè)自定義標(biāo)簽，自己定義標(biāo)簽的好處就是在jsp頁(yè)面中可以使用自己定義的功能，完全與Java代碼分離

1. tld文件如下：

首先是要寫×.tld文件，當(dāng)項(xiàng)目隨著服務(wù)器啟動(dòng)的時(shí)候，會(huì)檢查項(xiàng)目中有沒(méi)有*tld文件。
寫的tld文件

<?xml version="1.0" encoding="UTF-8" ?>
<taglib xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
  http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd"
  version="2.1">
  <!-- 定義版本 -->
  <tlib-version>1.0</tlib-version>
  <!-- 定義名字 -->
  <short-name>apsliyuan</short-name>
  <!-- 定義uri -->
  <uri>http://my.oschina.net/aps</uri>
  <!-- 定義自己的類 -->
  <tag>
    <!-- name 就是在jsp中顯示的標(biāo)簽名字，<aps:hellowTag/> -->
    <name>hellowTag</name>
    <!-- 自己寫的標(biāo)簽類的完整路徑 -->
    <tag-class>cn.itcast.apsliyuan.tag.HellowtTag</tag-class>
    <!-- jsp中主題中是不是要顯示內(nèi)容，有四個(gè)屬性， 如果為empty的話。在jsp頁(yè)面中標(biāo)簽就不能定義自己的內(nèi)容了，否則會(huì)報(bào) Servlet.service() 
      for servlet jsp threw exception org.apache.jasper.JasperException: /index.jsp(12,8) 
      According to TLD, tag aps:hellowTag must be empty, but is not 異常
     -->
    <body-content>JSP</body-content>
  </tag>
<!-- 
  這里沒(méi)有寫屬性，有時(shí)間補(bǔ)上
 -->
  <tag>
    <name>ApsliyuanTag</name>
    <tag-class>cn.itcast.apsliyuan.tag.ApsliyuanTag</tag-class>
    <body-content>JSP</body-content>
  </tag>
</taglib>

2. 自定義標(biāo)簽類java代碼如下：

//自定義標(biāo)簽的類
package cn.itcast.apsliyuan.tag;
import java.io.IOException;
import java.text.SimpleDateFormat;
import java.util.Date;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.TagSupport;
public class HellowtTag extends TagSupport{
  /**
   * 
   */
  private static final long serialVersionUID = 1781703371130382609L;
  @Override
  public int doStartTag() throws JspException {
    // TODO Auto-generated method stub
    JspWriter out = pageContext.getOut();
    SimpleDateFormat format=new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
    try {
      out.print(format.format(new Date()));
    } catch (IOException e) {
      // TODO Auto-generated catch block
      e.printStackTrace();
    }
    return EVAL_BODY_INCLUDE;
  }
  @Override
  public int doEndTag() throws JspException {
    // TODO Auto-generated method stub
    JspWriter out = pageContext.getOut();
    try {
      out.print("<br/> <hr/>標(biāo)簽執(zhí)行完畢了");
    } catch (IOException e) {
      // TODO Auto-generated catch block
      e.printStackTrace();
    }
    return EVAL_PAGE;
  }
}

3. jsp引入自己定義標(biāo)簽代碼如下：

//jsp中引入自己定義的標(biāo)簽
<%@ page language="java" contentType="text/html; charset=UTF-8"
  pageEncoding="UTF-8"%>
  <%@taglib uri="http://my.oschina.net/aps" prefix="aps" %>
  <%@taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>index.jsp</title>
</head>
<body>
  現(xiàn)在的時(shí)間是：<aps:hellowTag> </aps:hellowTag><br/>
  <hr/>
  我愛(ài)的人是： <aps:ApsliyuanTag/>
</body>
</html>

4. TagSupport代碼如下：

//看看TagSupport中的源代碼， 這個(gè)是適配器模式
public class TagSupport implements IterationTag, Serializable {
  public static final Tag findAncestorWithClass(Tag from,
      // TCK signature test fails with generics
      @SuppressWarnings("unchecked")
      Class klass) {
  boolean isInterface = false;
  if (from == null ||
    klass == null ||
    (!Tag.class.isAssignableFrom(klass) &&
     !(isInterface = klass.isInterface()))) {
    return null;
  }
  for (;;) {
    Tag tag = from.getParent();
    if (tag == null) {
    return null;
    }
    if ((isInterface && klass.isInstance(tag)) ||
      klass.isAssignableFrom(tag.getClass()))
    return tag;
    else
    from = tag;
  }
  }
  /**
   * Default constructor, all subclasses are required to define only
   * a public constructor with the same signature, and to call the
   * superclass constructor.
   *
   * This constructor is called by the code generated by the JSP
   * translator.
   */
  public TagSupport() { }
  /**
   * Default processing of the start tag, returning SKIP_BODY.
   *
   * @return SKIP_BODY
   * @throws JspException if an error occurs while processing this tag
   *
   * @see Tag#doStartTag()
   */
  public int doStartTag() throws JspException {
    return SKIP_BODY;
  }
  /**
   * Default processing of the end tag returning EVAL_PAGE.
   *
   * @return EVAL_PAGE
   * @throws JspException if an error occurs while processing this tag
   *
   * @see Tag#doEndTag()
   */
  public int doEndTag() throws JspException {
  return EVAL_PAGE;
  }
  /**
   * Default processing for a body.
   *
   * @return SKIP_BODY
   * @throws JspException if an error occurs while processing this tag
   *
   * @see IterationTag#doAfterBody()
   */
  public int doAfterBody() throws JspException {
  return SKIP_BODY;
  }
  // Actions related to body evaluation
  /**
   * Release state.
   *
   * @see Tag#release()
   */
  public void release() {
  parent = null;
  id = null;
  if( values != null ) {
    values.clear();
  }
  values = null;
  }
  /**
   * Set the nesting tag of this tag.
   *
   * @param t The parent Tag.
   * @see Tag#setParent(Tag)
   */
  public void setParent(Tag t) {
  parent = t;
  }
  /**
   * The Tag instance most closely enclosing this tag instance.
   * @see Tag#getParent()
   *
   * @return the parent tag instance or null
   */
  public Tag getParent() {
  return parent;
  }
  /**
   * Set the id attribute for this tag.
   *
   * @param id The String for the id.
   */
  public void setId(String id) {
  this.id = id;
  }
  /**
   * The value of the id attribute of this tag; or null.
   *
   * @return the value of the id attribute, or null
   */
  public String getId() {
  return id;
  }
  /**
   * Set the page context.
   *
   * @param pageContext The PageContext.
   * @see Tag#setPageContext
   */
  public void setPageContext(PageContext pageContext) {
  this.pageContext = pageContext;
  }
  /**
   * Associate a value with a String key.
   *
   * @param k The key String.
   * @param o The value to associate.
   */
  public void setValue(String k, Object o) {
  if (values == null) {
    values = new Hashtable<String, Object>();
  }
  values.put(k, o);
  }
  /**
   * Get a the value associated with a key.
   *
   * @param k The string key.
   * @return The value associated with the key, or null.
   */
  public Object getValue(String k) {
  if (values == null) {
    return null;
  } else {
    return values.get(k);
  }
  }
  /**
   * Remove a value associated with a key.
   *
   * @param k The string key.
   */
  public void removeValue(String k) {
  if (values != null) {
    values.remove(k);
  }
  }
  /**
   * Enumerate the keys for the values kept by this tag handler.
   *
   * @return An enumeration of all the keys for the values set,
   *   or null or an empty Enumeration if no values have been set.
   */
  public Enumeration<String> getValues() {
  if (values == null) {
    return null;
  }
  return values.keys();
  }
  // private fields
  private  Tag     parent;
  private  Hashtable<String, Object>  values;
  /**
   * The value of the id attribute of this tag; or null.
   */
  protected String   id;
  // protected fields
  /**
   * The PageContext.
   */
  protected PageContext pageContext;
}

doStartTag的返回值

在doStartTag返回的值決定的body部分的數(shù)據(jù)如何顯示。

兩個(gè)返回值：

0 – SKIP_BODY – 常量。不顯示body。
1－EVAN_BODY_INCLUDE ;包含body部分的數(shù)據(jù)，正常顯示。
3：在doEndTag也有兩個(gè)返回值

決定后面的頁(yè)面部分是否顯示：

SKIP_PAGE : 不再顯示后面的頁(yè)面部分。

EVAL_PAGE : 顯示后面的page部分。

希望本文所述對(duì)大家的JSP程序設(shè)計(jì)有所幫助。

您可能感興趣的文章: