一、前言 (本文譯自Orion官方站點)
本文將一步一步介紹在Orion Application Server下定義自己的標籤,然後,實作該標籤的功能,最後用一個jsp範例測試。
二、建立標籤,實現該標籤的功能。
1.命名package為:com.acme.mytags(為了跟原文相同,我不做改動)
package com.acme.mytags;
2.import相關class
import javax.servlet.jsp.*;
import javax.servlet.jsp.tagext.*;
3.實作javax.servlet.jsp.tag .Tag介面:
public class HelloWorld implements Tag
{
4.定義局部變數
private PageContext pageContext
; Tag parent;
5.呼叫標籤開始的實作方法
public int doStartTag() throws javax.servlet.jsp.JspException
{
}
注意:這個方法回傳SKIP_BODY,就是標籤的body為空的時候,將傳回這個值,否則會回傳:EVAL_BODY_INCLUDE
6.標籤結束的實現方法
public int doEndTag() throws javax.servlet.jsp.JspException
{
try
{
pageContext.getOut().write('Hello World!');
}
catch(java.io.IOException e)
{
throw new JspException('IO Error: ' e.getMessage());
}
return EVAL_PAGE;
}
這樣將在jjsp文件的自訂標籤結束地方輸出「Hello World!」
7.還不夠,我們還要寫下面的方法:
public void release() {}
對於本簡單的例子,上面的方法不需要任何實作。
8.JSP的容器要呼叫下面的方法:
public void setPageContext(final javax.servlet.jsp.PageContext pageContext) {
this.pageContext=Context;
}
JSP容器透過上面的方法呼叫標籤,而且上面的方法用來設定標籤的PageContext.
9.JSP的容器還要呼叫下面的方法:
public void setParent(final javax.servlet.jsp.tagext.Tag parent)
{
this.parent=parent;
this.parent=parent; 🎜>
JSP容器透過上面的方法設定標籤的parent-Tag,因為每個標籤的PageContext都要保留它的parent標籤。
10.最後,實現方法:
public javax.servlet.jsp.tagext.Tag getParent()
{
return parent;
}
}
11. 編譯標籤。
三、描敘標籤
現在將要寫一個描敘文件,描敘標籤。
1.建立一個taglib.tld文件,
2.taglib.tld是一個XML格式的文字文件,XML的頭如下:
'http ://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd'>
3.描敘標籤庫
1.0
1.1
mt http://www.orionserver.com/tutorials/tagtut/lesson1/mytags.jar
My first Tag library
4.描敘標籤
helloWorld
com.acme.mytags.HelloWorld
empty
A Hello world Tag
empty
A Hello world Tag
A Hello world Tag >
5.結束
四、打包
名稱為:mytags.jar
其目錄結構為:
com/acme/mytags/HelloWorld.class
META-INF/taglib.tld
五、在jsp檔案中使用自訂標籤
建立hello.jsp如下:
六、測試運行
在orion目錄下,建立如下結構,其中,tag是自己建立的,前面的目錄是本來就有的。
E:oriondefault-web-app ag
將jar檔和jsp檔全部放到這個目錄下。
然後,造訪:
http://localhost:[port]/tag/hello.jsp
將出現:
------- -------------------------------------------------- ---------
Hello World!
-------------------------------- ----------------------------------
七、恭喜,你已經成功了!
附:mytags.jar與hello.jsp 檔案本站下載位址: