JSP入门实例教程6-jsp自定义标签讲解 - 百家拳原创软件教程网

自定义标签是个好东西，他使得很多复杂的逻辑封装成一个标签放在jsp页面上。便于维护，增加可读性。

Test.jsp

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <title>百家拳技术软件教程网</title>
  </head>

  <body>
    This is my JSP page. <br>
    Date : <%= new java.util.Date().toString() %> <br>
    File : <input value="<%= request.getServletPath() %>" />
  </body>
</html>

为了将这个这个Test.jsp改成自定义标签方法，我们分别使用简单标签和内容标签两种不同的方式实现。

1. 简单标签

由于我们需要输出两个内容(日期和文件名)，因此我们为标签创建一个参数。你可以直接编译DemoTag.java文件，但是你会发现提示很多的错误（找不到相应的类）这是因为你没有载入jsp－api.jar的包，而jsp－api.jar包放在tomcat的安装里的\common\lib中，你可以将jsp－api.jar复制粘贴到你的jdk的安装目录\jre\lib\ext中，这次你再调用就可以成功编译了。具体代码：

DemoTag.java

package com.mycompany;

import java.util.Date;

import javax.servlet.http.*;
import javax.servlet.jsp.*;
import javax.servlet.jsp.tagext.*;

public class DemoTag extends TagSupport {

  public int doStartTag() throws JspException {
    try {
      HttpServletRequest request = (HttpServletRequest)pageContext.getRequest();
      JspWriter out = pageContext.getOut();

      if (parameter.compareToIgnoreCase("filename") == 0)
        out.print(request.getServletPath());
      else
        out.print(new Date());

    } catch (java.io.IOException e) {
      throw new JspTagException(e.getMessage());
    }

    return SKIP_BODY;
  }

  private String parameter = "date";

  public void setParameter(String parameter) {
    this.parameter = parameter;
  }

  public String getParameter() {
    return parameter;
  }
}

接下来，我们创建标签文件 MyTagLib.tld。标签文件其实只是一个XML格式的说明文件，内容也很简单。

MyTagLib.tld

<?xml version="1.0" encoding="ISO-8859-1"?>
<taglib>
<tlib-version>1.0</tlib-version>
<jsp-version>1.2</jsp-version>

<tag>
  <name>demo</name>
  <tag-class>com.mycompany.DemoTag</tag-class>
  <body-content>empty</body-content>
  <attribute>
    <name>parameter</name>
    <required>false</required>
    <rtexprvalue>true</rtexprvalue>
  </attribute>
</tag>

</taglib>

在这个标签文件中，我们将我们创建的标签取名 demo，并声明了类型和参数(parameter)。将该文件保存在 /WEB-INF 下面。
当然，我们还需要将我们自定义的标签添加到 web.xml 中，否则还是无法使用。

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.4" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

  <jsp-config>
    <taglib>
      <taglib-uri>/WEB-INF/MyTagLib</taglib-uri>
      <taglib-location>/WEB-INF/MyTagLib.tld</taglib-location>
    </taglib>
  </jsp-config>

</web-app>

你可能在别处看到过类似的声明，只是没有外面的 jsp-config，但是我们使用的是DTD 2.4，如果不加，Eclipse 会提示出错。

到此为止，我们的自定义标签算是创建完毕。接下来，我们可以开始改写那个JSP文件来分离代码了。

Test1.jsp

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<%@taglib uri="/WEB-INF/MyTagLib" prefix="mytag"%>

<%@ page contentType="text/html;charset=GB2312" %>
<html>
  <head>
    <title>百家拳技术软件教程网</title>
  </head>

  <body>
    This is my JSP page. <br>
    Date : <mytag:demo parameter="date" /><br>
    File : <mytag:demo parameter="filename" />
  </body>
</html>

上面这些想必你已经很熟悉，我就不做多说了。

2. 内容标签

创建过程和上面大抵相同，只是程序文件和配置内容有些差异。

DemoTag2.java

package com.mycompany;

import java.io.IOException;
import java.util.Date;

import javax.servlet.http.*;
import javax.servlet.jsp.*;
import javax.servlet.jsp.tagext.*;

public class DemoTag2 extends BodyTagSupport {

  public int doStartTag() throws JspTagException {
    return EVAL_BODY_BUFFERED;
  }

  public int doEndTag() throws JspTagException {
    String body = this.getBodyContent().getString();
    HttpServletRequest request = (HttpServletRequest)pageContext.getRequest();

    body = body.replace("$date", new Date().toString());
    body = body.replace("$filename", request.getServletPath());

    try {
      pageContext.getOut().print(body);
    }
    catch (IOException e) {
      throw new JspTagException(e.getMessage());
    }

    return SKIP_BODY;
  }
}

我们将新的标签 DemoTag2 加入到上面的标签文件中。

MyTagLib.tld

web.xml 文件无需修改。

看看同时使用两种标签的Test.jsp效果。

Test2.jsp

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<%@taglib uri="/WEB-INF/MyTagLib" prefix="mytag"%>

下一节我们将讲一讲JSTL+EL语言的应用例子

例子下载