JSP 中自定义标签的 TLD 文件如何编写？

推荐答案

// www.javascriptcn.com code example
<?xml version="1.0" encoding="UTF-8" ?>
<taglib xmlns="http://java.sun.com/xml/ns/j2ee"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"
        version="2.0">

    <tlib-version>1.0</tlib-version>
    <short-name>mytaglib</short-name>
    <uri>/WEB-INF/tlds/mytaglib.tld</uri>

    <tag>
        <name>hello</name>
        <tag-class>com.example.HelloTag</tag-class>
        <body-content>empty</body-content>
        <attribute>
            <name>name</name>
            <required>true</required>
            <rtexprvalue>true</rtexprvalue>
        </attribute>
    </tag>
</taglib>

本题详细解读

1. TLD 文件的基本结构

TLD（Tag Library Descriptor）文件是一个XML文件，用于描述自定义标签库的元数据。它定义了标签库的版本、标签名称、标签处理类、标签属性等信息。

2. 关键元素解析

• <taglib>: 根元素，定义了整个标签库的命名空间和版本信息。

  • xmlns: 指定了XML命名空间。
  • xsi:schemaLocation: 指定了XML Schema的位置。
  • version: 指定了标签库的版本。

• <tlib-version>: 指定标签库的版本号。

• <short-name>: 指定标签库的简短名称，通常用于在JSP页面中引用标签库。

• <uri>: 指定标签库的URI，通常指向TLD文件的位置。

• <tag>: 定义了一个具体的标签。

  • <name>: 指定标签的名称。
  • <tag-class>: 指定标签处理类的全限定名。
  • <body-content>: 指定标签体的内容类型，常见的有empty、JSP、scriptless等。
  • <attribute>: 定义标签的属性。
    • <name>: 指定属性的名称。
    • <required>: 指定属性是否为必填项。
    • <rtexprvalue>: 指定属性是否支持运行时表达式（如EL表达式）。

3. 示例解析

在示例中，定义了一个名为hello的标签，其处理类为com.example.HelloTag。该标签有一个必填属性name，并且支持运行时表达式。

4. 使用示例

在JSP页面中使用该自定义标签时，首先需要引入标签库：

<%@ taglib uri="/WEB-INF/tlds/mytaglib.tld" prefix="mytag" %>

然后可以使用自定义标签：

<mytag:hello name="World" />

这个标签将会调用com.example.HelloTag类来处理，并传递name属性的值。