JAVA/JSP学习系列之七(Orion下自定义Tag)
程序员文章站
2024-02-26 12:06:40
一、前言 (本文译自orion官方站点) 本文将一步一步介绍在orion application server下定义自己的标签，然后，实现该标签的功能，最后用一个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的头如下：
<?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>
<info>my first tag library</info>
4.描叙标签
<tag>
<name>helloworld</name>
<tagclass>com.acme.mytags.helloworld</tagclass>
<bodycontent>empty</bodycontent>
<info>a hello world tag</info>
</tag>
5.结束
</taglib>
四、打包
名称为：mytags.jar
其目录结构为：
com/acme/mytags/helloworld.class
meta-inf/taglib.tld
五、在jsp文件中使用自定义标签
建立hello.jsp如下：
<%@ taglib uri="mytags.jar" prefix="mt" %>
<html>
<head>
<title>hello world!</title>
</head> <body bgcolor="#ffffff">
<hr>
<mt:helloworld/>
<hr>
</body>
</html>
六、测试运行
在orion目录下，建立如下结构，其中，tag是自己建立的，前面的目录是本来就有的。
e:\orion\default-web-app\tag
将jar文件和jsp文件全部放到这个目录下。
然后，访问：
http://localhost:[port]/tag/hello.jsp
将出现：
--------------------------------------------------------------------------------
hello world!
--------------------------------------------------------------------------------
七、恭喜，你已经成功了！
附：mytags.jar和hello.jsp 文件本站下载地址：
http://www.wodejia.net/softdownload/java/orion_tag01.zip
本文将一步一步介绍在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>
<info>my first tag library</info>
4.描叙标签
<tag>
<name>helloworld</name>
<tagclass>com.acme.mytags.helloworld</tagclass>
<bodycontent>empty</bodycontent>
<info>a hello world tag</info>
</tag>
5.结束
</taglib>
四、打包
名称为：mytags.jar
其目录结构为：
com/acme/mytags/helloworld.class
meta-inf/taglib.tld
五、在jsp文件中使用自定义标签
建立hello.jsp如下：
<%@ taglib uri="mytags.jar" prefix="mt" %>
<html>
<head>
<title>hello world!</title>
</head> <body bgcolor="#ffffff">
<hr>
<mt:helloworld/>
<hr>
</body>
</html>
六、测试运行
在orion目录下，建立如下结构，其中，tag是自己建立的，前面的目录是本来就有的。
e:\orion\default-web-app\tag
将jar文件和jsp文件全部放到这个目录下。
然后，访问：
http://localhost:[port]/tag/hello.jsp
将出现：
--------------------------------------------------------------------------------
hello world!
--------------------------------------------------------------------------------
七、恭喜，你已经成功了！
附：mytags.jar和hello.jsp 文件本站下载地址：
http://www.wodejia.net/softdownload/java/orion_tag01.zip