JSP自訂標籤實驗原文:兔八哥筆記3:JSP自訂標籤實驗
一、概述
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) 可以被s cript使用的標籤:
定義了id和type屬性的標籤可以被標籤後面的s criptlet使用。
<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教程相關部分:java.sun.com/webservices/docs/1.0/tutorial/doc/JSPTags.html">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>
以下為jsp2.0
<?xml version="1.0" encoding="UTF-8" ?>
<taglib version="2.0">
<description>test</description>
<tlib-version>1.0</tlib-version>
<tag>
<description>hello world</description>
<name>title</name>
<body-content>EMPTY</body-content>
<tag-class>com.test.tag.helloworld</tag-class>
<attribute>
<name>title</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</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,輸入:jsp/hello.jsp">http://localhost:8080/myjsp/hello.jsp
posted @ 2006-11-23 10:09 James.Ying 閱讀(...) 評論(...) 編輯 收藏
重新整理評論重新整理頁面返回頂部
部落格園首頁博問新聞快閃記憶體程式員招聘知識庫
公告
Copyright 2013 James.Ying