直播中
本文將一步一步介紹在Orion Application Server下定義自己的標(biāo)簽,然后,實(shí)現(xiàn)該標(biāo)簽的功能,最后用一個(gè)jsp例子測(cè)試。
二、建立標(biāo)簽,實(shí)現(xiàn)該標(biāo)簽的功能。
1.命名package為:com.acme.mytags(為了和原文相同,我不做改動(dòng))
package com.acme.mytags;
2.import相關(guān)class
import javax.servlet.jsp.*;
import javax.servlet.jsp.tagext.*;
3.實(shí)現(xiàn)javax.servlet.jsp.tagext.Tag接口:
public class HelloWorld implements Tag
{
4.定義局部變量
private PageContext pageContext;
private Tag parent;
5.調(diào)用標(biāo)簽開(kāi)始的實(shí)現(xiàn)方法
public int doStartTag() throws javax.servlet.jsp.JspException
{
return SKIP_BODY;
}
注意:這個(gè)方法返回 SKIP_BODY,就是標(biāo)簽的body為空的時(shí)候,將返回這個(gè)值,否則將返回:EVAL_BODY_INCLUDE
6.調(diào)用標(biāo)簽結(jié)束的實(shí)現(xiàn)方法
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文件的自定義標(biāo)簽結(jié)束地方輸出“Hello World!”
7.還不夠,我們還要寫(xiě)下面的方法:
public void release() {}
對(duì)于本簡(jiǎn)單的例子,上面的方法不需要任何實(shí)現(xiàn)。
8.JSP的容器要調(diào)用下面的方法:
public void setPageContext(final javax.servlet.jsp.PageContext pageContext) {
this.pageContext=pageContext;
}
JSP容器通過(guò)上面的方法調(diào)用標(biāo)簽,而且上面的方法用來(lái)設(shè)置標(biāo)簽的PageContext.
9.JSP的容器還要調(diào)用下面的方法:
public void setParent(final javax.servlet.jsp.tagext.Tag parent)
{
this.parent=parent;
}
JSP容器通過(guò)上面的方法設(shè)置標(biāo)簽的parent-Tag,因?yàn)槊總€(gè)標(biāo)簽的PageContext都要保留它的parent標(biāo)簽。
10.最后,實(shí)現(xiàn)方法:
public javax.servlet.jsp.tagext.Tag getParent()
{
return parent;
}
}
11. 編譯標(biāo)簽。
三、描敘標(biāo)簽
現(xiàn)在將要寫(xiě)一個(gè)描敘文件,描敘該標(biāo)簽。
1.建立一個(gè)taglib.tld文件,
2.taglib.tld是一個(gè)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.描敘標(biāo)簽庫(kù)
<taglib>
<tlibversion>1.0</tlibversion>
<jspversion>1.1</jspversion>
<shortname>mt</shortname> <uri>http://www.orionserver.com/tutorials/tagtut/lesson1/mytags.jar</uri>
<info>My first Tag library</info>
4.描敘標(biāo)簽
<tag>
<name>helloWorld</name>
<tagclass>com.acme.mytags.HelloWorld</tagclass>
<bodycontent>empty</bodycontent>
<info>A Hello world Tag</info>
</tag>
5.結(jié)束
</taglib>
四、打包
名稱為:mytags.jar
其目錄結(jié)構(gòu)為:
com/acme/mytags/HelloWorld.class
META-INF/taglib.tld
五、在jsp文件中使用自定義標(biāo)簽
建立hello.jsp如下:
<%@ taglib uri="mytags.jar" prefix="mt" %>
<HTML>
<HEAD>
<TITLE>Hello World!</TITLE>
</HEAD> <BODY BGCOLOR="#FFFFFF">
<HR>
<mt:helloWorld/>
<HR>
</BODY>
</HTML>
六、測(cè)試運(yùn)行
在orion目錄下,建立如下結(jié)構(gòu),其中,tag是自己建立的,前面的目錄是本來(lái)就有的。
E:\orion\default-web-app\tag
將jar文件和jsp文件全部放到這個(gè)目錄下。
然后,訪問(wèn):
http://localhost:[port]/tag/hello.jsp
將出現(xiàn):
--------------------------------------------------------------------------------
Hello World!
--------------------------------------------------------------------------------
七、恭喜,你已經(jīng)成功了!
附:mytags.jar和hello.jsp 文件本站下載地址:
http://www.wodejia.net/softdownload/java/orion_tag01.zip