開發第一個JSP自訂標籤

開發和使用JSP自訂標籤過程:

1.開發標籤實作類別.
  HelloTag_Interface.java檔案內容:

import javax.servlet.jsp.tagext.Tag;
import javax.servlet.jsp.PageContext;
import javax.servlet.jsp.JspException;
import java.io.*;
import javax.servlet.jsp.JspTagException;

/** *//**
 * 以實現Tag介面的方式來開發標籤程式
 */
public class HelloTag
    implements Tag ...{

  private PageContext pageContext;
  private Tag parent;

  public HelloTag()...{
    super();
  }

  /** *//**
   * 設定標籤的頁面上下文
   * @param pageContext
   */
  public void setPageContext(PageContext pageContext) ...{
    this.pageContext=pageContext;
  }

  /** *//**
   * 設定上一級標籤
   * @param t
   */
  public void setParent(Tag parent) ...{
    this.parent=parent;
  }

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

  /** *//**
   * 開始標籤時的操作
   * @return
   * @throws JspException
   */
  public int doStartTag() throws JspException ...{
    return this.SKIP_BODY;//返回SKIP_BODY，表示不計算標籤體
  }

  /** *//**
   * 結束標籤時的操作
   * @return
   * @throws JspException
   */
  public int doEndTag() throws JspException ...{
    try ...{
      pageContext.getOut().write("Hello World!");
    }
    catch (IOException ex) ...{
      throw new JspTagException("IO Error:"+ex.getMessage());
    }

    return this.EVAL_PAGE;
  }

  /** *//**
   * Release 用於釋放標籤程式佔用的資源，比如使用了資料庫連接，那麼應該關閉這個串連
   */
  public void release() ...{
  }
}  

 

2.編寫標籤庫描述.
  在WEB-INF/目錄下新建立一個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>my</short-name>
   <uri>/mytag</uri>
   <description>學習標籤</description>

   <tag>
      <description>輸出Hello World</description>
      <name>hello</name>
      <tag-class>HelloTag</tag-class>
      <body-content>empty</body-content>
   </tag>
</taglib>

3.配置自訂標籤到工程中.
  在web.xml檔案裡添加:

 

<web-app>
...
   <taglib>
      <taglib-uri>/mytag</taglib-uri>
      <taglib-location>/WEB-INF/mytag.tld</taglib-location>
   </taglib>
...
</web-app>

 

4.在JSP檔案中使用自訂標籤.
  編寫mytag.jsp檔案:

 

<%...@ taglib uri="/mytag" prefix="hello" %>