JSP學習筆記(九)-----JSP標籤庫

js|筆記

1.JSP標籤庫（也稱自訂庫）可看成是一套產生基於XML指令碼的方法，它經由JavaBeans來支援。在概念上說，標籤庫是非常簡單和可以重用的代碼構造。它可以大大簡化你在頁面中輸入各種錄入框的代碼（諸如此類的代碼：＜input type="text" name="taxpayerName" value = " ,＜select name="collectionItemCode" class="required" style="width:200" ...），並使之結構化。
    2.標籤庫（Tag libraries）提供了建立可重用代碼塊的簡單方式。但是和COM和J2EE不同的是，你不需要掌握任何額外的技能就可以建立標籤庫：如果你會編寫JSP頁面，你就會建立標籤庫。最後，標籤庫還改進了Web應用程式的維護性。這種對維護性的改進表現在：輕易地在JSP頁面上就實現了基於XML的可定製介面。
    3.一個簡單的標籤由下面的元素構成：
⑴ JavaBeans：為了得到Java與生具來的物件導向的好處，可重用的代碼應該放到一個獨立的代碼容器中。這些JavaBeans並不是標籤庫的一部分。不過它是你的程式碼程式庫用來執行相關任務的基本代碼塊。
⑵ 標籤處理：這是標籤庫的真正核心。一個標籤處理器將引用它需要的任何資源（你的JavaBeans）和訪問你的JSP頁面的全部資訊（pageContext對象）。JSP頁面也會將所有已經被設定的標籤屬性和JSP頁面上的標籤體中的內容傳送給標籤處理器。在標籤處理器處理完畢後，它將發回輸出到你的JSP頁面進行處理。
⑶ 標籤庫的描述（tld檔案）：這是一個簡單的XML檔案，它記錄著標籤處理器的屬性、資訊和位置。JSP容器通過這個檔案來得知從哪裡及如何調用一個標籤庫。
⑷ 網站的web.xml檔案：這是你網站的初始設定檔案，在這個檔案中，你定義了網站中用到的自訂標籤，以及哪個tld檔案用來描述每個自訂的標籤。
⑸ 分發檔案（一個WAR或者JAR檔案）：如果你想重用自訂標籤的話，你需要一個方法來將它由一個項目轉移到另一個項目中。將標籤庫打包為一個JAR檔案是一個簡單而且有效方式。
⑹ 在你的JSP檔案中作標籤庫聲明：很簡單，如果要用到該標籤的話，只要在頁面聲明一下就可以，其後，你就可以在該JSP頁面的任何地方使用它。
下面是一個執行個體
1. 先編寫標籤處理常式，ATMTag.java
//用標籤處理常式來定義客戶標籤的工作
import javax.servlet.jsp.*;
//匯入標籤類的驅動
import javax.servlet.jsp.tagext.*;
import java.io.*;
import java.sql.*;
import java.math.*;
import java.util.*;
//實現TagSupport或BodyTagSupport介面
public class ATMTag extends TagSupport
{
Connection connect = null;
Statement state = null;
ResultSet result = null;
public ATMTag() throws ClassNotFoundException
{
Class.forName("sun.jdbc.odbc.JdbcOdbcDriver");
}
//抽象類別Tag的方法，標籤處理常式的初始化
public int doStartTag() throws JspTagException
{
//指導JSP引擎處理標籤的體內容
return EVAL_BODY_INCLUDE;
}
//執列標籤任務
public int doEndTag() throws JspTagException
{
try
{
//把輸出寫到JSP頁面
JspWriter out=pageContext.getOut();
connect=DriverManager.getConnection("jdbc:odbc:test","sa","");

String strQuery = " Select cCounter_id, cAddress,mCashBalance from Counter where mCashBalance＜=10000; " ;
System.out.println("Query: "+strQuery);
state = connect.createStatement();
ResultSet result = state.executeQuery(strQuery);
String sId=null;
String sAddress=null;
String sBalance=null;
Vector v=new Vector();
while(result.next())
{
sId = result.getString(1);
sAddress = result.getString(2);
sBalance = result.getString(3);
v.add(sId);
v.add(sAddress);
v.add(sBalance);
v.add(";");
}
for(int i=0;i＜v.size();i++)
{
String str=(String)v.elementAt(i);
pageContext.getOut().write(str);
}
}catch(Exception ioe)
{
System.out.println(" Error in getting results"+ioe.toString());
}
//指出對JSP頁面其餘部分求值
return EVAL_PAGE;
}
}

2. 編寫TLD檔案的代碼：
//XML驗證文檔
＜?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＞
//標籤庫依賴的JSP版本
＜jspversion＞1.1＜/jspversion＞
//標籤庫名
＜shortname＞ATMjsp＜/shortname＞
//關於標籤庫的詳細資料
＜info＞A Tag library＜/info＞
＜tag＞
//定義標籤的名
＜name＞ATM＜/name＞
//指出標籤處理常式類
＜tagclass＞ATMTag＜/tagclass＞
//此標籤體的定義
＜body-content＞JSP＜/body-content＞
//關於此標籤與其功能的附加資訊
＜info＞Outputs of the ATM counter＜/info＞
＜/tag＞
＜/taglib＞

3. 錯誤頁面errorpage.jsp的代碼:

＜html＞
＜body＞
＜%@ page isErrorPage="true" %＞
＜%=exception.getMessage() %＞
＜/body＞
＜/html＞

4． 編寫JSP檔案：ATM.jsp
＜%@ page import="ATMTag" %＞
＜%@ taglib uri="ATMjsp.tld" prefix="ATMjsp" %＞
＜%@ page errorPage="errorpage.jsp" %＞
＜!DocType HTML Public "-//W3C//DTD HTML 4.0 Translational//EN "＞
＜html＞
＜h3 align=center＞ATM counters that needs Cash＜/h3＞
＜table＞
＜tr＞＜td＞＜/td＞＜td＞＜ATMjsp:ATM/＞＜/td＞＜/tr＞
＜/table＞
＜/html＞