下载与安装

Apache Taglibs 分发版的已发布版本二进制下载可从每个组件的网站获取。

请注意，目前这些分发版是来自 Jakarta Taglibs 时代的旧版本。虽然当前的开发使用 Maven 构建，但二进制版本是在 Ant 构建系统下创建的，且源代码版本也需要 Ant 构建系统。

分发目录结构

分发归档文件将包含以下文件和目录结构

  • LICENSE - Apache 软件基金会许可证的副本，所有 Jakarta 项目软件均在该许可证下分发。
  • README - 一个简短的 README 文件，其中包含可用文档的指引。
  • doc - 一个目录，包含关于整个 JAKARTA-TAGLIBS 项目的文档，包括此文件。包含以下文档
  • JAKARTA-TAGLIBS 项目中包含的每个自定义标签库的目录，其中目录名称与该项目的短名称匹配。每个目录将包含以下文件，其中{library}表示该项目的短名称
    • {library}.tld - 此自定义标签库的标签库描述符文件。此文件通常会被复制到/WEB-INFWeb 应用程序中的子目录，并通过一个<taglib>元素在 Web 应用程序部署描述符（/WEB-INF/web.xml）文件中。
    • {library}.jar - 一个 JAR 文件，包含组成此自定义标签库的 Java 类和相关资源。此文件通常会被复制到/WEB-INF/libWeb 应用程序中的子目录，这将使这些类在您的应用程序中自动可见。
    • {library}-doc.war - 一个 Web 应用程序，包含开发者文档，描述如何在您自己的应用程序中使用此自定义标签库中的标签。此 Web 应用程序可以部署并在任何与 Servlet API 规范 2.2 版或更高版本兼容的 Servlet 容器上执行。
    • {library}-examples.war - 一个 Web 应用程序，包含一个或多个示例，演示此自定义标签库的使用方法。此 Web 应用程序可以部署并在任何与 Servlet API 规范 2.2 版或更高版本兼容的 Servlet 容器上执行。

在您的应用程序中使用自定义标签库

要在您自己的 Web 应用程序中使用 JAKARTA-TAGLIBS 中包含的一个或多个自定义标签库，请遵循以下步骤

  • 将{library}.tld文件复制到/WEB-INF您的 Web 应用程序的子目录中。
  • 将{library}.jar文件复制到/WEB-INF/lib您的 Web 应用程序的子目录中。
  • 安装您希望使用的自定义标签库所需的额外 JAR 文件（请参阅库文档获取信息）到/WEB-INF/lib您的 Web 应用程序的子目录中。
  • 对于您将要使用的每个标签库，添加一个<taglib>元素到您的 Web 应用程序部署描述符（/WEB-INF/web.xml)）文件中。一个示例如下所示
        <taglib>
	<taglib-uri>http://jakarta.apache.org/taglibs/{library}</taglib-uri>
	<taglib-location>/WEB-INF/{library}.tld</taglib-location>
    </taglib>
  • 在您的应用程序中需要使用此自定义标签库中一个或多个标签的每个 JSP 页面顶部，添加一个<%@ taglib %>指令，用于标识您要使用的库的 URI（它必须与您在<taglib-uri>Web 应用程序部署描述符中指定的值匹配），以及您将在此页面中用于标识来自此库的标签的标签名前缀。一个示例如下所示
        <%@ taglib uri="http://jakarta.apache.org/taglibs/{library}" prefix="x" %>
  • 无论何时您想使用此库中的一个标签，您只需将其包含在内，并按照您在taglib指令中描述的方式添加前缀，并包含此标签库文档中描述的属性名称和值。例如，如果您使用的库有一个名为magic的标签，并且您选择了如上所述的“x”前缀，您可能会包含此自定义标签
        <x:magic/>
    或者，如果此标签需要属性或一些主体文本
        <x:magic id="beanName" name="xyz">
	... Some body text and/or nested tags ...
    </x:magic>
  • 请参阅每个自定义标签库随附的文档，以获取该库中可用标签的详细描述。