一、基本概念: ************************************************************************************* 1.標(biāo)簽(Tag): 標(biāo)簽是一種XML元素,通過(guò)標(biāo)簽可以使JSP網(wǎng)頁(yè)變得簡(jiǎn)潔并且易于維護(hù),還可以方便地實(shí)現(xiàn)同一個(gè)JSP文件支持多種語(yǔ)言版本。由于標(biāo)簽是XML元素,所以它的名稱和屬性都是大小寫(xiě)敏感的 2.標(biāo)簽庫(kù)(Tag library): 由一系列功能相似、邏輯上互相聯(lián)系的標(biāo)簽構(gòu)成的集合稱為標(biāo)簽庫(kù)。 3.標(biāo)簽庫(kù)描述文件(Tag Library Descriptor): 標(biāo)簽庫(kù)描述文件是一個(gè)XML文件,這個(gè)文件提供了標(biāo)簽庫(kù)中類和JSP中對(duì)標(biāo)簽引用的映射關(guān)系。它是一個(gè)配置文件,和web.xml是類似的。 4.標(biāo)簽處理類(Tag Handle Class): 標(biāo)簽處理類是一個(gè)Java類,這個(gè)類繼承了TagSupport或者擴(kuò)展了SimpleTag接口,通過(guò)這個(gè)類可以實(shí)現(xiàn)自定義JSP標(biāo)簽的具體功能 ************************************************************************************* 二、自定義JSP標(biāo)簽的格式: ************************************************************************************* 1.<% @ taglib prefix=”someprefix” uri=”/sometaglib” %> 為了使到JSP容器能夠使用標(biāo)簽庫(kù)中的自定義行為,必須滿足以下兩個(gè)條件: 1.從一個(gè)指定的標(biāo)簽庫(kù)中識(shí)別出代表這種自定義行為的標(biāo)簽 2.找到實(shí)現(xiàn)這些自定義行為的具體類 第一個(gè)必需條件-找出一個(gè)自定義行為屬于那個(gè)標(biāo)簽庫(kù)-是由標(biāo)簽指令的前綴(Taglib Directive‘s Prefix)屬性完成,所以在同一個(gè)頁(yè)面中使用相同前綴的元素都屬于這個(gè)標(biāo)簽庫(kù)。每個(gè)標(biāo)簽庫(kù)都定義了一個(gè)默認(rèn)的前綴,用在標(biāo)簽庫(kù)的文檔中或者頁(yè)面中插入自定義標(biāo)簽。所以,你可以使用除了諸如jsp,jspx,java,servlet,sun,sunw(它們都是在JSP白皮書(shū)中指定的保留字)之類的前綴。 uri屬性滿足了以上的第二個(gè)要求。為每個(gè)自定義行為找到對(duì)應(yīng)的類。這個(gè)uri包含了一個(gè)字符串,容器用它來(lái)定位TLD文件。在TLD文件中可以找到標(biāo)簽庫(kù)中所有標(biāo)簽處理類的名稱 2.<someprefix:sometag key=”somevalue”/> 當(dāng)web應(yīng)用程序啟動(dòng)時(shí),容器從WEB-INF文件夾的目錄結(jié)構(gòu)的META-INF搜索所有以.tld結(jié)尾的文件。也就是說(shuō)它們會(huì)定位所有的TLD文件。對(duì)于每個(gè)TLD文件,容器會(huì)先獲取標(biāo)簽庫(kù)的URI,然后為每個(gè)TLD文件和對(duì)應(yīng)的URI創(chuàng)建映射關(guān)系。 在JSP頁(yè)面中,我們僅需通過(guò)使用帶有URI屬性值的標(biāo)簽庫(kù)指令來(lái)和具體的標(biāo)簽庫(kù)匹配 ************************************************************************************* 三、自定義JSP標(biāo)簽的處理過(guò)程: ************************************************************************************* 1.在JSP中引入標(biāo)簽庫(kù):<% @ taglib prefix=”taglibprefix” uri=”tagliburi” %> 2.在JSP中使用標(biāo)簽庫(kù)標(biāo)簽:<prefix : tagname attribute=”tagattribute”> 3.Web容器根據(jù)第二個(gè)步驟中的prefix,獲得第一個(gè)步驟中聲明的taglib的uri屬性值 4.Web容器根據(jù)uri屬性在web.xml找到對(duì)應(yīng)的<taglib>元素 5.從<taglib>元素中獲得對(duì)應(yīng)的<taglib-location>元素的值 6.Web容器根據(jù)<taglib-location>元素的值從WEB-INF/目錄下找到對(duì)應(yīng)的.tld文件 7.從.tld文件中找到與tagname對(duì)應(yīng)的<tag>元素 8.湊<tag>元素中獲得對(duì)應(yīng)的<tag-class>元素的值 9.Web容器根據(jù)<tag-class>元素的值創(chuàng)建相應(yīng)的tag handle class的實(shí)例 10. Web容器調(diào)用這個(gè)實(shí)例的doStartTag/doEndTag方法完成相應(yīng)的處理 ************************************************************************************* 四、創(chuàng)建和使用一個(gè)Tag Library的基本步驟: ************************************************************************************* 1.創(chuàng)建標(biāo)簽的處理類(Tag Handler Class) 2.創(chuàng)建標(biāo)簽庫(kù)描述文件(Tag Library Descrptor File) 3.在web.xml文件中配置<tag>元素 4.在JSP文件中引人標(biāo)簽庫(kù) ************************************************************************************* 五、TagSupport類簡(jiǎn)介: ************************************************************************************* 1.處理標(biāo)簽的類必須擴(kuò)展javax.servlet.jsp.TagSupport. 2.TagSupport類的主要屬性: A.parent屬性:代表嵌套了當(dāng)前標(biāo)簽的上層標(biāo)簽的處理類 B.pageContex屬性:代表Web應(yīng)用中的javax.servlet.jsp.PageContext對(duì)象 3.JSP容器在調(diào)用doStartTag或者doEndTag方法前,會(huì)先調(diào)用setPageContext和setParent方法,設(shè)置pageContext和parent。因此在標(biāo)簽處理類中可以直接訪問(wèn)pageContext變量 4.在TagSupport的構(gòu)造方法中不能訪問(wèn)pageContext成員變量,因?yàn)榇藭r(shí)JSP容器還沒(méi)有調(diào)用 setPageContext方法對(duì)pageContext進(jìn)行初始化 ************************************************************************************* 六、TagSupport處理標(biāo)簽的方法: ************************************************************************************* 1.TagSupport類提供了兩個(gè)處理標(biāo)簽的方法: public int doStartTag() throws JspException public int doEndTag() throws JspException 2.doStartTag:但JSP容器遇到自定義標(biāo)簽的起始標(biāo)志,就會(huì)調(diào)用doStartTag()方法。 doStartTag()方法返回一個(gè)整數(shù)值,用來(lái)決定程序的后續(xù)流程。 A.Tag.SKIP_BODY:表示<prefix:someTag>…</prefix:someTag>之間的內(nèi)容被忽略 B.Tag.EVAL_BODY_INCLUDE:表示標(biāo)簽之間的內(nèi)容被正常執(zhí)行 3.doEndTag:但JSP容器遇到自定義標(biāo)簽的結(jié)束標(biāo)志,就會(huì)調(diào)用doEndTag()方法。doEndTag ()方法也返回一個(gè)整數(shù)值,用來(lái)決定程序后續(xù)流程。 A.Tag.SKIP_PAGE:表示立刻停止執(zhí)行網(wǎng)頁(yè),網(wǎng)頁(yè)上未處理的靜態(tài)內(nèi)容和JSP程序均被 忽。略任何已有的輸出內(nèi)容立刻返回到客戶的瀏覽器上。 B.Tag_EVAL_PAGE:表示按照正常的流程繼續(xù)執(zhí)行JSP網(wǎng)頁(yè) ************************************************************************************* 七、用戶自定義的標(biāo)簽屬性: ************************************************************************************* 如果在標(biāo)簽中還包含了自定義的屬性,例如: <prefix:Mytag attribute1="value1"> ... </prefix:Mytag> 那么在標(biāo)簽處理類中應(yīng)該將這個(gè)屬性作為成員變量,并且分別提供設(shè)置和讀取屬性的方法。 ************************************************************************************* 八、創(chuàng)建標(biāo)簽處理類的步驟: ************************************************************************************* 1.創(chuàng)建包含JSP網(wǎng)頁(yè)靜態(tài)文本的文件(即是要替換自定義JSP標(biāo)簽的文本) 2.在Web應(yīng)用啟動(dòng)時(shí)裝載靜態(tài)文本 3.創(chuàng)建標(biāo)簽處理類 ************************************************************************************* 九、如何創(chuàng)建包含JSP網(wǎng)頁(yè)靜態(tài)文本的文件: ************************************************************************************* 1.使用java.util.Properties類來(lái)存放要替換網(wǎng)頁(yè)中自定義JSP標(biāo)簽的靜態(tài)文本 2.Properties類代表了一系列屬性的集合,其實(shí)例既可以被保存到流中,也可以從流中加 載。這些文本以key/value的形式存放在WEB-INF目錄下,例如key=value,在屬性列表中 這些key/value都是String類型的 ************************************************************************************* 十、Properties類的常用API: ************************************************************************************* 1.setProperty(String key, String value):調(diào)用Hashtable類的put方法添加屬性 2.getProperty(String key):獲取屬性列表中key對(duì)應(yīng)的屬性值 3.load(InputStream in):從輸入流對(duì)象InputStream中讀取屬性列表(Properties list) 4.store(OutputStream out,String comment):使用適當(dāng)?shù)母袷綄傩粤斜淼膶傩詫?duì)寫(xiě)入輸 出流對(duì)象中,默認(rèn)使用ISO-88590-1編碼格式,以行的方式處理輸入。屬性的key/value之 間以”=、:”配對(duì),以回車、換行分隔key/value對(duì) ************************************************************************************* 十一、ServletContext類的常用API: ************************************************************************************* 1.getContext(String uripath):返回服務(wù)器中uripath所代表的ServletContext對(duì)象 2.getInitParameter(String name):返回ServletConfig對(duì)象中name參數(shù)的值 3.getMineType(String file):返回file參數(shù)代表的文件的MIME類型 4.getRequestDispatcher(String path):返回path代表的RequestDispacher對(duì)象 5.getResourceAsStream(String path):以輸入流的形式返回path對(duì)應(yīng)的資源,在輸入留中對(duì)象可以為任意形式的數(shù)據(jù),path參數(shù)必須以“/”開(kāi)始且相對(duì)于Context Root ************************************************************************************* 十二、如何使用ServletContxt讀取并保存屬性文件: ************************************************************************************* 1.創(chuàng)建java.util.Properties類對(duì)象 2.獲取ServletContext對(duì)象 3.將屬性文件以輸入流的形式讀入到某個(gè)輸入流對(duì)象中 4.將輸入流對(duì)象加載到Properties對(duì)象中 5.將Properties對(duì)象保存到ServletContext對(duì)象中 ************************************************************************************* 十三、如何在Web應(yīng)用啟動(dòng)時(shí)裝載靜態(tài)文本: ************************************************************************************* 1.創(chuàng)建繼承了HttpServlet類的子類,在web.xml中配置這Servlet時(shí)設(shè)置load-on-startup屬性: <servlet> <servlet-name>someclass</servlet-name> <servlet-class>somepackage.SomeClass</servlet-clas <load-on-startup>1</load-on-startup> </servlet> 2.在這個(gè)Servlet的init()方法中創(chuàng)建java.util.Properties類 3.獲取當(dāng)前Web應(yīng)用的ServletContext對(duì)象 4.將WEB-INF目錄下的屬性文件讀入到輸入流InputStream中: InputStream in = context.getResourceAsString("WEB-INF/someproperties.properties"); 5.將輸入流加載到屬性對(duì)象中 ps.load(in); 6.將屬性對(duì)象保存到上下文中。 context.setAttribute("attributeName",ps); ************************************************************************************* 十四、如何創(chuàng)建標(biāo)簽處理類: ************************************************************************************* 1.引入必需的資源: import javax.servlet.jsp.*; import javax.servlet.http.*; import java.util.*; import java.io.*; 2.繼承TagSupport類并覆蓋doStartTag()/doEndTag()方法 3.從ServletContext對(duì)象中獲取java.util.Properties對(duì)象 4.從Properties對(duì)象中獲取key對(duì)應(yīng)的屬性值 5.對(duì)獲取的屬性進(jìn)行相應(yīng)的處理并輸出結(jié)果 ************************************************************************************* 十五、創(chuàng)建標(biāo)簽庫(kù)描述文件(Tag Library Descriptor): ************************************************************************************* 1.標(biāo)簽庫(kù)描述文件,簡(jiǎn)稱TLD,采用XML文件格式,定義了用戶的標(biāo)簽庫(kù)。TLD文件中的元素可以分成3類: A.<taglib>:標(biāo)簽庫(kù)元素 B.<tag>:標(biāo)簽元素 C.<attribute>:標(biāo)簽屬性元素 2.標(biāo)簽庫(kù)元素<taglib>用來(lái)設(shè)定標(biāo)簽庫(kù)的相關(guān)信息,它的常用屬性有: A.shortname: 指定Tag Library默認(rèn)的前綴名(prefix) B.uri: 設(shè)定Tag Library的惟一訪問(wèn)表示符 3.標(biāo)簽元素<tag>用來(lái)定義一個(gè)標(biāo)簽,它的常見(jiàn)屬性有: A.name: 設(shè)定Tag的名字 B.tagclass: 設(shè)定Tag的處理類 C.bodycontent: 設(shè)定標(biāo)簽的主體(body)內(nèi)容 1).empty:表示標(biāo)簽中沒(méi)有body 2).JSP:表示標(biāo)簽的body中可以加入JSP程序代碼 3).tagdependent:表示標(biāo)簽中的內(nèi)容由標(biāo)簽自己去處理 4.標(biāo)簽屬性元素<attribute>用來(lái)定義標(biāo)簽的屬性,它的常見(jiàn)屬性有: A.name:屬性名稱 B.required:屬性是否必需的,默認(rèn)為false C.rtexprvalue:屬性值是否可以為request-time表達(dá)式,也就是類似于<%=…%>的表達(dá)式 ************************************************************************************* 十六、在Web應(yīng)用中使用標(biāo)簽: ************************************************************************************* 1.如果Web應(yīng)用中用到了自定義JSP標(biāo)簽,則必須在web.xml文件中加入<taglib>元素,它用于聲明所引用的標(biāo)簽所在的標(biāo)簽庫(kù) <taglib> <taglib-uri>/sometaglib</taglib-uri> <taglib-location>/WEB-INF/someTLD.tld</taglib-location> </taglib> 2.<taglib-uri>:設(shè)定Tag Library的惟一標(biāo)示符,在Web應(yīng)用中將根據(jù)它來(lái)引用Tag Libray 3.<taglib-location>:指定和Tag Library對(duì)應(yīng)的TLD文件的位置 4.在JSP文件中需要加入<% @ taglib% >指令來(lái)聲明對(duì)標(biāo)簽庫(kù)的引用。例如: <% @ taglib prefix = “somePrefix” uri = "/someuri" %> 5.prefix表示在JSP網(wǎng)頁(yè)中引用這個(gè)標(biāo)簽庫(kù)的標(biāo)簽時(shí)的前綴,uri用來(lái)指定Tag Library的標(biāo)識(shí)符,它必須和web.xml中的<taglib-uri>屬性保持一致。 ************************************************************************************* |
|