---
title: "JAVA/JSP学习系列之七(Orion下自定义Tag)"
author: "fanjava"
date: "2004-06-27T13:44:00Z"
tags: []
slug: "java-jsp-orion-tag"
draft: false
lastmod: "2004-06-27T13:44:00Z"
id: 602012
url: "https://fanjava.iteye.com/blog/602012"
---

一、前言 (本文译自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的头如下：

&lt;?xml version="1.0" encoding="ISO-8859-1" ?&gt;  
&lt;!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN"  
"http://java.sun.com/j2ee/dtds/web-jsptaglibrary\_1\_1.dtd"&gt;

3.描叙标签库

&lt;taglib&gt;

&lt;tlibversion&gt;1.0&lt;/tlibversion&gt;

&lt;jspversion&gt;1.1&lt;/jspversion&gt;

&lt;shortname&gt;mt&lt;/shortname&gt; &lt;uri&gt;http://www.orionserver.com/tutorials/tagtut/lesson1/mytags.jar&lt;/uri&gt;

&lt;info&gt;My first Tag library&lt;/info&gt;

4.描叙标签

&lt;tag&gt;

&lt;name&gt;helloWorld&lt;/name&gt;

&lt;tagclass&gt;com.acme.mytags.HelloWorld&lt;/tagclass&gt;

&lt;bodycontent&gt;empty&lt;/bodycontent&gt;

&lt;info&gt;A Hello world Tag&lt;/info&gt;

&lt;/tag&gt;

5.结束

&lt;/taglib&gt;

四、打包

名称为：mytags.jar

其目录结构为：

com/acme/mytags/HelloWorld.class

META-INF/taglib.tld

五、在jsp文件中使用自定义标签

建立hello.jsp如下：

&lt;%@ taglib uri="mytags.jar" prefix="mt" %&gt;

&lt;HTML&gt;

&lt;HEAD&gt;

&lt;TITLE&gt;Hello World!&lt;/TITLE&gt;

&lt;/HEAD&gt; &lt;BODY BGCOLOR="#FFFFFF"&gt;

&lt;HR&gt;

&lt;mt:helloWorld/&gt;

&lt;HR&gt;

&lt;/BODY&gt;

&lt;/HTML&gt;

六、测试运行

在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](http://www.wodejia.net/softdownload/java/orion_tag01.zip)