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）