摘要
在jsp中有一種機制，可以讓你在jsp頁面中插入與html類似的標記。本文介紹jsp定制標記的基本概念和構成，以及如何開發和應用jsp定制標記。
關鍵字
jsp,xml，tld，標記符
什么是標記
使用html語言我們可以這樣去編輯我們的網頁：
<html>
<head>
<title>
hello world
</title>
</head>
<body>
hello world
</body>
</html>
在這里我們把</head>，<title>，<body>稱為標記。html 標記( html markup)是html文檔的控制語言,用于指定瀏覽器顯示和打印文檔的方式.它是用小于號"<"和大于號">"括起來的短語和符號,如 <html>、</body>等。許多html標記以成對的方式出現,如<title>< /title>、<body></body> 等。在jsp中我們也可以定制自己的標記，以供jsp頁面使用，如下例所示
<!—login.jsp-->
<%@ taglib uri="/tlds/taglib.tld" prefix="tagclass" %>
<html>
<head>
<title>login</title>
</head>
<body>
<tagclass:login width="200" height= "100" >
</tagclass:login>
</body>
</html>
在上例中</tagclass:login>就是一個jsp定制標記符。widtht、height是這個標記的屬性。<%@ taglib uri="/tlds/taglib.tld" prefix="tagclass" %>是一個標記庫定義指令，在稍后我們將會討論。在jsp中定制標記符，實質上就是以標記的形式封裝了一個俱有獨立功能的java類。標記的使用減少了直接嵌入jsp頁面的java代碼，方便了頁面的布局，并且有利于代碼的復用，提高了開發的效率。
jsp服務器解析標記的過程
那么當一個標記被嵌入jsp頁面后，jsp服務器是如何對這個標記進行解析的呢？各對象的含義如下所示：
client： 表示客戶端。
jsp-server：jsp服務器。
jsp-page：jsp頁面。
tld： 標記庫描述文件，定義標記和標記的各種屬性和處理文件等。
tagclass 標記處理程序
當一個用戶訪問一個jsp頁面時，這個請求被發送到jsp服務器，jsp服務器會根據這個請求去調用相應的頁面，如果這個頁面中有自定義的標記， jsp服務就會根據頁面指令<%@ taglib>去訪問tld得到處理程序的相關信息，接著調用該處理程序的構造器方法，啟動標記符處理程序,并讀取標記符的屬性和相應值。對每個沒有設置屬性的，調用相應的set方法。當標記符第一次使用時，它的任何屬性都不會做過設置，因此對每個屬性都調用set方法。屬性設置完以后，jsp服務器調用處理程序的dostarttag()，然后再調用doendtag()方法。最后jsp服務器會繼續處理剩下的頁面,在頁面結尾調用release ()方法，清理占用的所有資源。
tld文件
tld(tld:tag library descriptor標記庫描述符)文件，標準的xml格式的標記定義文件，被用來存放標記符的信息，下面就是一個典型的tld文件。
<?xml version="1.0" encoding="iso-8859-1" ?>
<!—xml的版本及其字符集-->
<!doctype taglib
public "-//sun microsystems, inc.//dtd jsp tag library 1.1//en"
"http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd">
<!—文檔類型定義-->
<taglib>
<!—此標記說明我們開始描述一個標記庫-->
<tlibversion>1.0</tlibversion>
<!—標記庫的版本-->
<jspversion>1.1</jspversion>
<!—所使用的jsp的版本-->
<shortname>tagclass</shortname>
<!—缺省的名稱-->
<tag>
<name>login</name>
<!—標記的名稱-->
<tagclass>
tagclass.login.login
<!—處理這個tag的相應的類的名稱-->
</tagclass>
<info>
<!—對本標記符的描述-->
</info>
<attribute>
<!—開始定義標記的屬性-->
<name>height</name>
<!—屬性的名稱-->
<required>true</required>
<!—表示這個屬性是不是必須的-->
<rtexprvalue>true</rtexprvalue>
<!—表示這個屬性是否可以用jsp的程序段的結果輸出-->
</attribute>
<attribute>
<name>width</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
</taglib>
在這個tld文件中定義了只有一個標記符的標記符庫，這個名為login的標記符會調用一個applet以驗證用戶的合法性。處理這個標記的類就是 tagclass.login.login。width、height是這個標記的兩個屬性。屬性是在使用標記符時作為參數發送的值。我們可以在上面的示例中增加幾個標記，也可以為每個標記添加幾個屬性。我們開發標記符庫時不一定非要從頭開始，自己編寫一個全新tld。我們可以使用某個集成的開發的環境，也可以修改上面的例子。
taglib指令
那么當jsp服務器在解析一個標記符時，它是如何定義一個標記庫的呢？這就是taglib指令的主要責任。
taglib 指令
定義一個標記庫以及其自定義標記的前綴.
jsp 語法
<%@ taglib uri="uritotaglibrary" prefix="tagprefix" %>
例子
<%@ taglib uri="/tlds/taglib.tld" prefix="tagclass" %>
<html>
<head>
<title>login</title>
</head>
<body>
<tagclass:login width="200" height= "100" >
</tagclass:login>
</body>
</html>
描述
<% @ taglib %>指令聲明此jsp文件使用了自定義的標記，同時引用標記庫，
也指定了他們的標記的前綴。 你必須在使用自定義標記之前使用<% @ taglib %>指令。
屬性
uri="uritotaglibrary" ：uniform resource identifier (uri)根據標記的前綴對自定義的標記進行唯一的命名，uri可以是一個相對或絕對的路徑。
prefix="tagprefix"：在自定義標記之前的前綴。如上例中的</tagclass:login>
標記符的處理程序(tag handle)
我們還是以一個例子來看下如何實現一個tag handle。首先是看一下它的類圖：
讓我們再看一下它的代碼：
package tagclass.login;
import javax.servlet.jsp.tagext.tagsupport;
import javax.servlet.jsp.*;
import java.io.*;
public class login extends tagsupport
{
public login()
{
super();
}
public int dostarttag() throws jsptagexception
{
jspwriter out = pagecontext.getout();
try
{
out.println("<applet codebase=applet/login/ code=login.class width=200 height=100 > </applet>");
}
catch(exception e)
{
}
return skip_body;
}
publicc int doendtag()throws jsptagexception
{
return eval_page;
}
public void release()
{
super.release();
}
public void setwidth(string language)
{
this.width = width;
}
public string getwidth()
{
return this.width;
}
public void setheight(string height)
{
this.height=height;
}
public string getheight()
{
return this.height;
}
private string width;
private string height;
}
從以上我們可以看出，實現一個簡單的標記符處理程序有幾個要求：①增加一個類，使之繼承 java.servlet.jsp.tagext.tagsupport類。這個類提供了java.servlet.jsp.tagext.tag接口所要求的所有的方法。另外，還需要使用一些基本的api，使jsp容器能夠調用我們自己提供的標記符處理程序。②必須為每個標記符屬性分別創建一個 get<attribute>和set<attribute>方法，jsp容器需要使用這些方法處理程序傳遞參數。③要為標記符處理程序創建一個構造器和自毀器。jsp需要使用構造器啟動處理程序。自毀器是在realease()方法中定義的。在處理程序的生命周期結束時，需要調用自毀器釋放所占用的資源。④創建兩個名為dostarttag()和doendtag()的方法，執行具體的處理和輸出動作。這兩個方法是在處理自定義標記符的起始位置和結束位置調用的。它們的返回值是在tag interface里定義的靜態int，這幾個靜態值分別是：
skip_body隱含0 ：跳過了開始和結束標簽之間的代碼。
eval_body_include隱含1：將body的內容輸出到存在的輸出流中
skip_page隱含5 ： 忽略剩下的頁面。
eval_page隱含6：繼續執行下面的頁
當然標記符也有它自己的缺點。很不方便的封裝過程，有限的功能。對于一些不太復雜和功能單一的邏輯描述，需要傳遞的參數要求不高時，使用jsp標記，要方便的多。對于大多數的商業邏輯應用，還是使用bean要好的多，也宜于servlet控制。
附錄：文章中所用示例的完整代碼
jsp代碼：login.jsp
<%@ taglib uri="/tlds/taglib.tld" prefix="tagclass" %>
<html>
<head>
<title></title>
</head>
<body>
<tagclass:login width="200" height= "100" >
</tagclass:login>
</body>
</html>
標記符描述庫:taglib.tld
<?xml version="1.0" encoding="iso-8859-1" ?>
<!doctype taglib
public "-//sun microsystems, inc.//dtd jsp tag library 1.1//en"
"http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd">
<taglib>
<tlibversion>1.0</tlibversion>
<jspversion>1.1</jspversion>
<shortname>tagclass</shortname>
<tag>
<name>login</name>
<tagclass>
tagclass.login.login
</tagclass>
<info>
</info>
<attribute>
<name>height</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
<attribute>
<name>width</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
</taglib>
標記符處理程序:login.java
package tagclass.login;
import javax.servlet.jsp.tagext.tagsupport;
import javax.servlet.jsp.*;
import java.io.*;
public class login extends tagsupport
{
public login()
{
super();
}
public int dostarttag() throws jsptagexception
{
jspwriter out = pagecontext.getout();
try
{
out.println("<applet codebase=applet/login/ code=login.class width=200 height=100 > </applet>");
}
catch(exception e)
{
}
return skip_body;
}
publicc int doendtag()throws jsptagexception
{
return eval_page;
}
public void release()
{
super.release();
}
public void setwidth(string language)
{
this.width = width;
}
public string getwidth()
{
return this.width;
}
public void setheight(string height)
{
this.height=height;
}
public string getheight()
{
return this.height;
}
private string width;
private string height;
}
標記符處理程序中所使用的applet : login.java
import java.awt.*;
import java.awt.event.*;
import java.applet.*;
public class login extends applet implements actionlistener
{
private string s_username;
private string s_userpassword;
private button b_ok;
private button b_register;
private label l_username;
private label l_userpassword;
private textfield t_username;
private textfield t_userpassword;
private gridlayout g_gridlayout;
public void init()
{
b_ok=new button("ok");
b_register=new button("register");
l_username= new label("name");
l_userpassword=new label("password");
t_username=new textfield();
t_userpassword=new textfield();
b_ok.addactionlistener(this);
b_register.addactionlistener(this);
g_gridlayout=new gridlayout(3,2,10,10);
this.setlayout(g_gridlayout);
//this.setbackground(color.blue);
add(l_username);
add(t_username);
add(l_userpassword);
add(t_userpassword);
add(b_ok);
add(b_register);
}
public void actionperformed(actionevent ev)
{
string s_label=ev.getactioncommand();
if (s_label.equals("ok"))
{
t_username.settext("name");
}
if (s_label.equals("register"))
{
t_userpassword.settext("password");
}
}
public void paint(graphics g)
{
}
}
新聞熱點
疑難解答
