通过使用自定义标签,我们可以将实现复杂的逻辑在页面用简单的标签来加以展示。下面我们来实现一个非常简单的自定义标签,期望通过这个简单的实例引领各位进入自定义标签的领域。我们准备定义的这个自定义标签所实现的功能是在JSP页面中显示出版权信息,并且在以后的博文中,我们还会对它进行升级改造。
首先,打开编辑器,创建以下Java代码:
代码如下:
package com.yanzhijun;
import java.io.*;
import javax.servlet.jsp.*;
import javax.servlet.jsp.tagext.*;
public class CopyRightTag extends TagSupport
{
public int doEndTag()
{
try
{
String copyPre = "颜志军版权所有 ©2008";
String info = new String(copyPre.getBytes(), "ISO8859_1");
pageContext.getOut().println(info);
}
catch(IOException e){}
return EVAL_PAGE;
}
}
上述代码编辑完成后,编译并生成class文件。并将编译之后的字节码文件连同包名一同放入准备使用当前标签的WEB应用的WEB-INFclasses目录之下。例如WEB应用在名为test的目录之下,则将上述代码编译时生成的com目录全部拷贝至testWEB-INFclasses之下即可。
注意:在编译上述代码时,如果不是在集成的环境中进行,例如直接在命令行通过执行javac命令进行编译工作,那么需要手工在环境变量CLASSPATH中添加包javax.servlet.jsp所在的位置,对于Tomcat而言,这个包的位置是Tomcat安装目录下lib目录中的jsp-api.jar。
随后将以下XML格式的文件存入到名为testlib.tld的文件中,文件testlib.tld要存储于目录WEB-INFtlds之下。
代码如下:
?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"
taglib
tlibversion1.0/tlibversion
jspversion1.1/jspversion
shortnameyzj/shortname
tag
namecopyright/name
tagclasscom.yanzhijun.CopyRightTag/tagclass
bodycontentempty/bodycontent
attribute/
/tag
/taglib
至此,我们已经完成了一个自定义标签,随后我们就可以在JSP文件中对其进行使用了。例如有如下JSP文件:
代码如下:
%@ taglib uri="WEB-INF/tlds/testlib.tld" prefix="yzj" %
html
head
meta http-equiv="Content-Type" content="text/html; charset=gb2312" /
title自定义标签简单示例/title
/head
body
p这里是正文内容/p
yzj:copyright/
/body
/html
在浏览器中访问该JSP文件,可以看到,在页面底部,显示了“颜志军版权所有 ©2008”的信息,这正是我们定义的这个自己定义标签的作用。
通过上面的过程,已经实现了自定义标签,并对其进行使用测试。关于其原理、机制、要注意的细节等问题,在请等待随后的博文。 猜你喜欢