一、前言 本文将一步一步介绍在
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-apptag
将jar文件和
JSP文件全部放到这个目录下。
然后,访问:
http://localhost:[port]/tag/hello.
JSP 将出现:
-----------------------------
Hello World!
-----------------------------