a) 创建通用标记库

要安装标记库，您需要执行以下步骤

1. 将标记类捆绑到 jar 文件中。确保包含位于 /WEB-INF 目录中的标记库 {library}.tld 文件
2. 将标记 {library}.jar 文件添加到 CLASSPATH
3. 将 {library}.jar 文件复制到 /WEB-INF/lib 目录
4. 在 /WEB-INF/web.xml 文件中定义标记库元素。例如

     <taglib>
       <taglib-uri>http://jakarta.apache.org/taglibs/{library}</taglib-uri>
       <taglib-location>/WEB-INF/{library}.tld</taglib-location>
     </taglib>
       

5. 在 jsp 页面中定义标记扩展。<taglib-uri> 和 uri 指令必须匹配。prefix 标识 jsp 页面中标记库中的标记。例如

  <%@ taglib uri="http://jakarta.apache.org/taglibs/{library}" prefix="x" %>
    

b) 添加 Jakarta-Taglibs 库

要向 Jakarta-Taglibs 添加标记库子项目，您需要执行以下操作

1. 为项目创建一个顶级目录。
2. 从现有子项目之一复制以下顶级文件
   • build.sh
   • build.bat
   • build.xml
3. 将 taglib.name 属性更改为新的自定义标记库子项目名称
4. 从现有子项目之一复制目录结构
5. 修改顶级 Jakarta-Taglibs build.xml 文件以包含新库

c) 部署标记库

使用 jakarta-taglibs 项目中的构建脚本创建 war 文件。构建 war 文件后，您可以简单地将该文件放置在 $TOMCAT_HOME/webapps 目录中。Tomcat 将加载您的类并创建新上下文。

war 文件应具有以下结构

  META-INF/
  META-INF/MANIFEST.MF
  WEB-INF/
  WEB-INF/classes/
  WEB-INF/lib/
  WEB-INF/lib/{tagLibrary}.jar
  WEB-INF/web.xml
  WEB-INF/{tagLibrary}.tld

如果您不想使用 jar 文件，则可以将所有类文件放置在 /WEB-INF/classes 目录中。

有关 war 文件的更多信息，请参阅 Java Servlet 规范，v2.2。

Hello World 标记处理程序

您可以在 /WEB-INF/classes/basic 目录中找到 Hello World 标记的标记处理程序，因为它属于 basic 包

  package basic;

导入 jsp 和标记类

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

Hello World 标记处理程序实现了 doStartTag() 方法，该方法在遇到开始标记时调用。

    public int doStartTag() throws JspException {
        try {
            pageContext.getOut().print("Hello World");
        } catch (Exception ex) {
            throw new JspException("IO problems");
        }
        return SKIP_BODY;
    }

JSP 容器设置 pageContext，并且标签处理程序可以使用它。 SKIP_BODY 值确保不评估标签主体。

Hello World 标签库描述符

  <?xml version="1.0" encoding="ISO-8859-1" ?>

描述部署描述符 DOCTYPE 的 XML 头。部署描述符包括 Web 应用程序的元素和配置信息。

  <!DOCTYPE taglib
            PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN" 
            "http://java.sun.com/j2ee/dtds/web-jsptaglib_1_1.dtd">

初始标签库描述

  <taglib>
    <!-- The version number of this tag library -->
    <tlibversion>1.0</tlibversion>

    <!-- The JSP specification version required to function -->
    <jspversion>1.1</jspversion>

    <!-- The short name of this tag library -->
    <shortname>utility</shortname>

    <!-- Public URI that uniquely identifies this version of the tag library -->
    <uri>http://jakarta.apache.org/taglibs/utilitytags</uri>

    <!-- General information about this tag library -->
    <info>
          A simple tag library for the examples
    </info>

Hello World 标签描述。

• tagclass 元素将 Hello World 标签处理程序与 Hello World 标签关联
• bodycontent 标签告诉我们该标签不会包含任何主体

  <!-- Hello tag -->
    <tag>
      <name>Hello</name>
      <tagclass>basic.Hello</tagclass>
      <bodycontent>empty</bodycontent>
      <info>
        Print Hello World
      </info>
    </tag>

web.xml 文件

web.xml 文件描述标签库 uri 与标签库描述符位置之间的映射。

此处，唯一的 taglib-uri "http://jakarta.apache.org/taglibs/utilitytags" 与 /WEB-INF/tld/utilitytags.tld 中的标签库描述符关联。

  <web-app>
    <taglib>
       <taglib-uri>
         http://jakarta.apache.org/taglibs/utilitytags
       </taglib-uri>
       <taglib-location>
         /WEB-INF/tld/utilitytags.tld
       </taglib-location>
    </taglib>
  </web-app>

Hello World jsp

以下指令告诉 JSP 容器使用 web.xml 中定义的 "http://jakarta.apache.org/taglibs/utilitytags" uri。"jLib" 被定义为该标签的前缀值。

  <%@ taglib uri="http://jakarta.apache.org/taglibs/utilitytags" prefix="jLib" %>

调用 Hello World 标签。标签名称 "Hello" 在标签库描述符中定义。

  <jLib:Hello/>

If 标签处理程序

BodyTagSupport 类实现 BodyTag 接口，并具有 bodyContent 属性的 getter 方法。

  public class IfTag extends BodyTagSupport {

doStartTag() 方法在遇到开始标签时调用，并调用本地 getPredicate() 方法。如果返回值为 true，则评估标签主体的其余部分，否则跳过它。

  public int doStartTag() {
    if (getPredicate()) return EVAL_BODY_TAG;
    else return SKIP_BODY;
  }

doAfterBody() 在评估某些主体后调用。它不会在空标签或在 doStartTag() 中返回 SKIP_BODY 的标签中调用。

  public int doAfterBody() throws JspException {
    try {
      bodyContent.writeOut(bodyContent.getEnclosingWriter());
      return SKIP_BODY;
    } catch (IOException ex) {
      throw new JspTagException(ex.toString());
    }
  }

如果标签库描述符

  <!-- IF tag -->
    <tag>
      <name>If</name>
      <tagclass>lang.IfTag</tagclass>

If 标签有一个必需的属性。由于 rtexprvalue 设置为 true，因此属性可以将脚本表达式作为值。该值可以在请求时动态计算。

      <attribute>
        <name>predicate</name>
        <required>true</required>
        <rtexprvalue>true</rtexprvalue>
      </attribute>
      <info>
        Conditional Tag.
      </info>
    </tag>  

web.xml 文件

web.xml 文件描述标签库 uri 与标签库描述符位置之间的映射。

此处，唯一的 taglib-uri "http://jakarta.apache.org/taglibs/utilitytags" 与 /WEB-INF/tld/utilitytags.tld 中的标签库描述符关联。

如果 JSP

If 标签需要一个属性。谓词属性包含一个将在运行时评估的脚本。基于谓词属性值，jLib:Hello 标签将被评估或跳过。

  <jlib:if predicate="<%= x==5 %>">
    <jLib:Hello/>   
  </jlib:if>

1. 简介

utilitytags 自定义标签库包含一些基本标签的示例。它展示了多种简单的自定义标签库代码技术。

2. 必备软件

此自定义标签库不需要除支持 JavaServer Pages 规范 1.1 版 的 servlet 容器之外的任何软件。

3. 配置信息

按照以下步骤使用此标签库配置 Web 应用程序

• 将标签库描述符文件 (utilitytags/utilitytags.tld) 复制到 Web 应用程序的 /WEB-INF 子目录。
• 将标签库 JAR 文件 (utilitytags/utilitytags.jar) 复制到 Web 应用程序的 /WEB-INF/lib 子目录。
• 向 /WEB-INF/web.xml 中的 Web 应用程序部署描述符添加一个 <taglib> 元素，如下所示

      <taglib>
          <taglib-uri>http://jakarta.apache.org/taglibs/utilitytags</taglib-uri>
          <taglib-location>/WEB-INF/utilitytags.tld</taglib-location>
      </taglib>
      

要在 JSP 页面中使用此库中的标签，请在每个页面的顶部添加以下指令

    <%@ taglib uri="http://jakarta.apache.org/taglibs/utilitytags" prefix="x" %>

4. 标签文档

utilitytags 标签库包含以下标签

Hello 标签

Hello 标签打印文本“Hello World”。它没有任何属性。

Copy 标签

MacroCopy 标签将属性文本复制到 Writer。

Paste 标签

MacroPaste 标签粘贴由 Writer 指定的文本。

ShowSource 标签

ShowSource 标签采用 jspFile 并将内容复制到 Writer。

Include 标签

Include 标签内联包含指定 URL 的输出。

If 标签

If 标签是一个基本的条件标签。

For 标签

For 标签是一个基本的循环标签。

useBean 标签

useBean 标签将 Java 对象的实例与给定的 ID 关联。

Validate 标签

Validate 标签生成 Javascript 以验证 HTML 表单。