jsp 自定義標簽

自定義標簽是用戶定義的jsp語言元素。當jsp頁面包含一個自定義標簽時將被轉化為servlet，標簽轉化為對被稱為tag handler的對象的操作，即當servlet執(zhí)行時web container調用那些操作。

jsp標簽擴展可以讓你創(chuàng)建新的標簽并且可以直接插入到一個jsp頁面。 jsp 2.0規(guī)范中引入simple tag handlers來編寫這些自定義標記。

你可以繼承simpletagsupport類并重寫的dotag()方法來開發(fā)一個最簡單的自定義標簽。

創(chuàng)建"hello"標簽

接下來，我們想創(chuàng)建一個自定義標簽叫作<ex:hello>，標簽格式為：

<ex:hello />

要創(chuàng)建自定義的jsp標簽，你首先必須創(chuàng)建處理標簽的java類。所以，讓我們創(chuàng)建一個hellotag類，如下所示：

package com.yapf;

import javax.servlet.jsp.tagext.*;
import javax.servlet.jsp.*;
import java.io.*;

public class hellotag extends simpletagsupport {

  public void dotag() throws jspexception, ioexception {
    jspwriter out = getjspcontext().getout();
    out.println("hello custom tag!");
  }
}

以下代碼重寫了dotag()方法，方法中使用了getjspcontext()方法來獲取當前的jspcontext對象，并將"hello custom tag!"傳遞給jspwriter對象。

編譯以上類，并將其復制到環(huán)境變量classpath目錄中。最后創(chuàng)建如下標簽庫：<tomcat安裝目錄>webapps\root\web-inf\custom.tld。

<taglib>
  <tlib-version>1.0</tlib-version>
  <jsp-version>2.0</jsp-version>
  <short-name>example tld</short-name>
  <tag>
    <name>hello</name>
    <tag-class>com.yapf.hellotag</tag-class>
    <body-content>empty</body-content>
  </tag>
</taglib>

接下來，我們就可以在jsp文件中使用hello標簽：

<%@ taglib prefix="ex" uri="web-inf/custom.tld"%>
<html>
  <head>
    <title>a sample custom tag</title>
  </head>
  <body>
    <ex:hello/>
  </body>
</html>

以上程序輸出結果為：

hello custom tag!

訪問標簽體

你可以像標準標簽庫一樣在標簽中包含消息內容。如我們要在我們自定義的hello中包含內容，格式如下：

<ex:hello>
   this is message body
</ex:hello>

我們可以修改標簽處理類文件，代碼如下：

package com.yapf;

import javax.servlet.jsp.tagext.*;
import javax.servlet.jsp.*;
import java.io.*;

public class hellotag extends simpletagsupport {

   stringwriter sw = new stringwriter();
   public void dotag()
      throws jspexception, ioexception
    {
       getjspbody().invoke(sw);
       getjspcontext().getout().println(sw.tostring());
    }

}

接下來我們需要修改tld文件，如下所示：

<taglib>
  <tlib-version>1.0</tlib-version>
  <jsp-version>2.0</jsp-version>
  <short-name>example tld with body</short-name>
  <tag>
    <name>hello</name>
    <tag-class>com.yapf.hellotag</tag-class>
    <body-content>scriptless</body-content>
  </tag>
</taglib>

現(xiàn)在我們可以在jsp使用修改后的標簽，如下所示:

<%@ taglib prefix="ex" uri="web-inf/custom.tld"%>
<html>
  <head>
    <title>a sample custom tag</title>
  </head>
  <body>
    <ex:hello>
        this is message body
    </ex:hello>
  </body>
</html>

以上程序輸出結果如下所示：

this is message body

自定義標簽屬性

你可以在自定義標準中設置各種屬性，要接收屬性，值自定義標簽類必須實現(xiàn)setter方法， javabean 中的setter方法如下所示：

package com.yapf;

import javax.servlet.jsp.tagext.*;
import javax.servlet.jsp.*;
import java.io.*;

public class hellotag extends simpletagsupport {

   private string message;

   public void setmessage(string msg) {
      this.message = msg;
   }

   stringwriter sw = new stringwriter();

   public void dotag()
      throws jspexception, ioexception
    {
       if (message != null) {
          /* 從屬性中使用消息 */
          jspwriter out = getjspcontext().getout();
          out.println( message );
       }
       else {
          /* 從內容體中使用消息 */
          getjspbody().invoke(sw);
          getjspcontext().getout().println(sw.tostring());
       }
   }

}

屬性的名稱是"message"，所以setter方法??是的setmessage()?，F(xiàn)在讓我們在tld文件中使用的<attribute>元素添加此屬性：

<taglib>
  <tlib-version>1.0</tlib-version>
  <jsp-version>2.0</jsp-version>
  <short-name>example tld with body</short-name>
  <tag>
    <name>hello</name>
    <tag-class>com.yapf.hellotag</tag-class>
    <body-content>scriptless</body-content>
    <attribute>
       <name>message</name>
    </attribute>
  </tag>
</taglib>

現(xiàn)在我們就可以在jsp文件中使用message屬性了，如下所示：

<%@ taglib prefix="ex" uri="web-inf/custom.tld"%>
<html>
  <head>
    <title>a sample custom tag</title>
  </head>
  <body>
    <ex:hello message="this is custom tag" />
  </body>
</html>

以上實例數(shù)據(jù)輸出結果為：

this is custom tag

你還可以包含以下屬性：

屬性	描述
name	定義屬性的名稱。每個標簽的是屬性名稱必須是唯一的。
required	指定屬性是否是必須的或者可選的,如果設置為false為可選。
rtexprvalue	聲明在運行表達式時，標簽屬性是否有效。
type	定義該屬性的java類類型。默認指定為 string
description	描述信息
fragment	如果聲明了該屬性,屬性值將被視為一個 jspfragment。

以下是指定相關的屬性實例：

.....
    <attribute>
      <name>attribute_name</name>
      <required>false</required>
      <type>java.util.date</type>
      <fragment>false</fragment>
    </attribute>
.....

如果你使用了兩個屬性，修改tld文件，如下所示：

.....
    <attribute>
      <name>attribute_name1</name>
      <required>false</required>
      <type>java.util.boolean</type>
      <fragment>false</fragment>
    </attribute>
    <attribute>
      <name>attribute_name2</name>
      <required>true</required>
      <type>java.util.date</type>
    </attribute>
.....

JSP基礎