一、概述
?????? JSP中有一塊重要的技術:自定義標簽(Custom Tag),最近這幾天在學習Struts的時候發現Struts中使用了很多自定義標簽,如html、bean等。所以我就做了個簡單的試驗,學習一下這種技術。
?????? 首先介紹一下這種技術吧!
1.優點:
取代了JSP中的Java程序,并且可以重復使用,方便不熟悉Java編程的網頁設計人員。
2.開發流程:
(1)?????? 編寫JSP,在JSP中使用自定義標簽。
(2)?????? 在web.xml中指定JSP中使用的標簽的.tld(標簽庫描述文件)文件的位置。
(3)?????? .tld文件中指定標簽使用的類。
3. 自定義標簽的分類:
(1)?????? 簡單標簽:如< mytag:helloworld/>
(2)?????? 帶屬性標簽:如<imytag:checkinput dbname = “<myBean.getDBName()>”/>
(3)?????? 帶標簽體的標簽:
在自定義標簽的起始和結束標簽之間的部分為標簽體(Body)。Body的內容可以是JSP中的標準標簽,也可以是HTML、腳本語言或其他的自定義標簽。
<mytag:checkinput dbname = “<myBean.getDBName()>”>
????? <mytag:log message=”Table Name”>
<mytag:checkinput />
(4)?????? 可以被Script使用的標簽:
定義了id和type屬性的標簽可以被標簽后面的Scriptlet使用。
<mytag:connection id = “oraDB” type = “DataSource” name = “Oracle”>
<%oraDB.getConnection(); %>
?
4.接口及其他
實際上,自定義標簽的處理類實現了Tag Handler對象。JSP技術在javax.servlet.jsp.tagext中提供了多個Tag Handler接口,JSP1.2中定義了Tag、BodyTag、IterationTag接口,在JSP2.0中新增了SimpleTag接口。JSP還提供了上述接口的實現類TagSupport、BodyTagSupport和SimpleTagSupport(SimpleTagSupport只在JSP2.0中才有)。BodyTagSupport實現了BodyTag、Tag和IterationTag接口。
?
接口及其方法
Tag接口
方法
SimpleTag
dotage
Tag
doStartTag,doEndTag,release
IterationTag
doStartTag,doAfterTag,release
BodyTag
doStartTag,doEndTag,release,doInitBody,doAfterBody
?
下表引自Sun的JSP在線教程。
Tag Handler Methods?
Tag Handler Type
Methods
Simple
doStartTag, doEndTag, release
Attributes
doStartTag, doEndTag, set/getAttribute1...N, release
Body, Evaluation and No Interaction
doStartTag, doEndTag, release
Body, Iterative Evaluation
doStartTag, doAfterBody, doEndTag, release
Body, Interaction
doStartTag, doEndTag, release, doInitBody, doAfterBody, release
?
下表中的EVAL是evaluate的縮寫,意思是:評價, 估計, 求...的值,在下列的返回值中的意思是執行。
返回值
意義
SKIP_BODY
表示不用處理標簽體,直接調用doEndTag()方法。
SKIP_PAGE
忽略標簽后面的JSP內容。
EVAL_PAGE
處理標簽后,繼續處理JSP后面的內容。
EVAL_BODY_BUFFERED
表示需要處理標簽體。
EVAL_BODY_INCLUDE
表示需要處理標簽體,但繞過setBodyContent()和doInitBody()方法
EVAL_BODY_AGAIN
對標簽體循環處理。
?
具體用法可以查看其他參考資料。
Sun的Java教程相關部分:http://java.sun.com/webservices/docs/1.0/tutorial/doc/JSPTags.html
?
?
二、實驗
1.試驗介紹
下面的實驗就是基于上述開發流程開發的。
(1)在JSP中指定taglib的uri:<%@ taglib uri="/helloworld" prefix="mytag" %>。
(2)在web.xml中配置tag-location:
<taglib>
??????????? <taglib-uri>/helloworld</taglib-uri>
??????????? <taglib-location>/WEB-INF/helloworld.tld</taglib-location>
?????? </taglib>
?????? (3)在tag-location中指定的.tld文件中定義實現標簽的處理類:
?? <short-name>mytag</short-name>
?? <tag>
????? <name>helloworld</name>
????? <tag-class>mytag.HelloWorldTag</tag-class>
????? <body-content>empty</body-content>
? </tag>
(4)執行處理類mytag.HelloWorldTag的doStartTag和doEndTag方法,然后將結果輸入到JSP中,和JSP中的內容一起輸出。實際上自定義標簽和JSP中的其他的內容被WebServer一起編譯成servlet。
?
?
2. 完成后的試驗的目錄結構
應用myjsp放在Tomcat的webapps下。
myjsp中包含J2EE標準目錄結構:WEB-INF和hello.jsp。WEB-INF中包含子目錄classes和lib及web.xml,tld文件可以放在WEB-INF下,也可以放在WEB-INF的子目錄下。
?
?
3.開始實驗
3.1.編寫JSP
?
< !—hello.jsp的源碼 -- >
<%@ page contentType="text/html; charset=GBK" %>
<%@ taglib uri="/helloworld" prefix="mytag" %>
<html>
<head>
<title>
jsp1
</title>
</head>
<body bgcolor="#ffffc0">
<h1>
下面顯示的是自定義標簽中的內容
</h1>
?
<br><br>
<mytag:helloworld></mytag:helloworld>
?
<br>
?
</form>
</body>
</html>
?
3.2.編寫web.xml
?
< !—web.xml的源碼 -- >
<?xml version="1.0" encoding="UTF-8"?>
<!-- edited with XMLSPY v5 rel. 4 U (http://www.xmlspy.com) by Williams (501) -->
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
<taglib>
??????? <taglib-uri>/helloworld</taglib-uri>
??????? <taglib-location>/WEB-INF/helloworld.tld</taglib-location>
</taglib>
</web-app>
?
3.3? 編寫tld文件
?
< !—helloworld.tld的源碼 -- >
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
?? "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
<taglib>
?? <tlib-version>1.0</tlib-version>
?? <jsp-version>1.2</jsp-version>
?? <short-name>mytag</short-name>
?? <tag>
?????? <name>helloworld</name>
?????? <tag-class>mytag.HelloWorldTag</tag-class>
?????? <body-content>empty</body-content>
?? </tag>
</taglib>
?
3.4? 編寫標簽實現類
?
< !—標簽的實現類HelloWorldTag.class的源碼 -- >
package mytag;???
?
import java.io.IOException;
import javax.servlet.jsp.*;
import javax.servlet.jsp.tagext.*;
?
public class HelloWorldTag extends TagSupport {????
? public HelloWorldTag() {
? }
? public int doStartTag() throws JspTagException{
??? return EVAL_BODY_INCLUDE;
? }
? public int doEndTag() throws JspTagException{
??? try {
????? pageContext.getOut().write("Hello World");
??? }
??? catch (IOException ex) {
????? throw new JspTagException("錯誤");
??? }
??? return EVAL_PAGE;
? }
}
?
3.5? 執行效果
部署到Tomcat的WebApps目錄下,啟動Tomcat,輸入:http://localhost:8080/myjsp/hello.jsp
?
“Hello World”就是我們定義的標簽部分的處理類輸出的結果。
3.6 ?注意:
這個試驗我做了2天,總是報錯,弄得很是灰心,開始時以為tld文件或web.xml文件配置不正確,但怎么也找不到原因。
今晚我終于找到原因了,是因為.class文件一定要放在classes文件夾中,我放到了lib中。
.jar或servlet文件要放在lib目錄中,而.class要放在classes目錄中,如果要放到lib目錄中,必須把mytag中的文件打包成.jar文件,然后把mytag.jar放到lib目錄中。
??
希望你不要犯我犯過的這個錯誤!^_^
有時間我會再寫一篇介紹Struts詳細處理流程的筆記。
這篇筆記整理的的確是JSP1.2的自定義標簽,在JSP2.0中xml文件的格式變了,其他的就不太了解了!但我想變化應該不會太大,另外標準是向下兼容的,感興趣的朋友可以看看,這是我的學習筆記,可能會對別人有些用處,所以貼出來獻丑了!