JAVA/JSP學習系列之七(Orion下自定義Tag)
2020-06-01 23:26:03
供稿:網友
一、前言 (本文譯自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的頭如下:
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN"
"http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd">
3.描敘標簽庫
<taglib>
<tlibversion>1.0</tlibversion>
<jspversion>1.1</jspversion>
<shortname>mt</shortname> <uri>http://www.orionserver.com/tutorials/tagtut/lesson1/mytags.jar</uri>