JAVA/JSP学习系列 Orion下自定义Tag

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