JSP 自定义标签之一 简单实例

  在JSP中使用自定义标签可以达到这样的目的,事实上,我们所熟知的各类框架基本上都是通过自定义标签的形式来实现的。

  通过使用自定义标签,我们可以将实现复杂的逻辑在页面用简单的标签来加以展示。下面我们来实现一个非常简单的自定义标签,期望通过这个简单的实例引领各位进入自定义标签的领域。我们准备定义的这个自定义标签所实现的功能是在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-INF\classes目录之下。例如WEB应用在名为test的目录之下,则将上述代码编译时生成的com目录全部拷贝至test\WEB-INF\classes之下即可。

  注意:在编译上述代码时,如果不是在集成的环境中进行,例如直接在命令行通过执行javac命令进行编译工作,那么需要手工在环境变量CLASSPATH中添加包javax.servlet.jsp所在的位置,对于Tomcat而言,这个包的位置是Tomcat安装目录下lib目录中的jsp-api.jar。

  随后将以下XML格式的文件存入到名为testlib.tld的文件中,文件testlib.tld要存储于目录WEB-INF\tlds之下。

  

复制代码 代码如下:

  <?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>

  <tlibversion>1.0</tlibversion>

  <jspversion>1.1</jspversion>

  <shortname>yzj</shortname>

  <tag>

  <name>copyright</name>

  <tagclass>com.yanzhijun.CopyRightTag</tagclass>

  <bodycontent>empty</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”的信息,这正是我们定义的这个自己定义标签的作用。

  通过上面的过程,已经实现了自定义标签,并对其进行使用测试。关于其原理、机制、要注意的细节等问题,在请等待随后的博文。