JAVA/JSP學習系列之七

一、前言 (本文譯自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.tagext.Tag介面：

public class HelloWorld implements Tag

{

4.定義局部變數

private PageContext pageContext;

private Tag parent;

5.調用標籤開始的實現方法

public int doStartTag() throws javax.servlet.jsp.JspException

{

return SKIP_BODY;

}

注意：這個方法返回 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;

}

這樣將在jsp檔案的自訂標籤結束地方輸出“Hello World!”

7.還不夠，我們還要寫下面的方法：

public void release() {}

對於本簡單的例子，上面的方法不需要任何實現。

8.JSP的容器要調用下面的方法：

public void setPageContext(final javax.servlet.jsp.PageContext pageContext) {

this.pageContext=pageContext;

}

JSP容器通過上面的方法調用標籤，而且上面的方法用來設定標籤的PageContext.

9.JSP的容器還要調用下面的方法：

public void setParent(final javax.servlet.jsp.tagext.Tag 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

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 檔案本站：

http://www.wodejia.net/softdownload/java/orion_tag01.zip（出處：viphot.com）