JavaWeb高级编程 -- 篇7

编写自定义标签和函数库

为了使用标签文件中定义的标签，可以使用taglib中的tagdir特性帮助你完成：

<%@ taglib prefix="myTags" tagdir="/WEB-INF/tags" %>

tagdir目录中所有的.tag或者.tagx文件都将被绑定到myTags命名空间。

为编写自定义的标签和函数库，必须了解JSP标签库XSD和使用它编写标签的方式。
关于JSP标签库XSD有一件重要的事情需要注意：模式使用了严格的元素顺序，这意味着所有使用的元素必须严格按照特定的顺序出现，否则该TLD文件将是无效的。

<description>JSTL 1.2 core library</description>  
<display-name>JSTL core</display-name>
<tlib-version>1.2</tlib-version>
<short-name>c</short-name>
<uri>http://java.sun.com/jsp/jstl/core</uri>

关于以上代码：

• 元素<description>和<display>提供了XML工具可以显示有用的名称，但与TLD的实际内容无关并且是可选的。如果需要，可以添加许多<description>和<display>，这样可以为不同的语言指定不同的显示名称和描述。
• 元素<icon>为可选元素，这里没有出现，它必须出现在<display-name>和<tlib-version>之前。
• <tlib-version>是必须元素。它定义了标签库的版本，其中只能使用数字和圆点。
• <short-name>表示该标签库推荐使用，也是默认的前缀，也是必须的，不能包括空白，或者以数字或下划线开头。
• <uri>定义了该标签库的URI。

元素<tag>是TLD的主要元素，负责定义标签库中的标签。

<tag>
    <description>
        catches throwable
    </description>
    <name>catch</name>
    <tag-class>org.apache.taglibs.standard.tag.common.core.catchTag</tag-class>
    <body-content>JSP</body-content>
    <attribute>
        <description>
            name of the exported scoped variable for the exception thrown from a nested action.
        </description>
        <name>var</name>
        <required>false</required>
        <rtexprvalue>false</rtexprvalue>
    </attribute>
</tag>

如<taglib>一样，它可以由0个或多个嵌套的<description>、<display-name>和<icon>元素。在这些元素之后需要一个<name>元素，它将指定JSP标签的名称在本例中，完整的标签名称为<c:catch>，c是标签库<short-name>，catch是标签的名称。一个标签明显只可以有一个名称。接下来是<tag-class>元素，它表示负责执行标签的标签处理器类。
接下来是<body-content>指定了标签中允许嵌套的内容类型。
在<body-content>之后是0个或多个<variable>元素，该元素提供了使用该标签定义的结果变量的相关信息。
在标签的<variable>元素之后，可以定义0个或多个<attribute>，它将为标签定义可用的特性。

<attribute>标签之后是<dynamic-attributes>，该属性不常见，只可以指定该布尔元素一次或者忽略它。默认值为假，用于表示是否允许通过<attribute>元素指定特性值。
在<dynamic-attributes>之后是可选的<example>元素，为标签的使用提供样例。

标签文件实际上就是一种JSP，只不过使用的语义稍有不同。
JAR库中的标签文件必须定义在TLD中，另外，如果希望将一个或多个标签文件分配到相同的命名空间，那么需要在TLD中定义这些标签，即使它们不再JAR文件中。
在TLD的所有<tag>元素之后，可以添加0个或多个<tag-file>元素，定义属于库的标签文件。

<tag-file>
    <description>this tag outputs bar.</description>  
    <name>foo</name>
    <path>/WEB-INF/tags/foo.tag</path>
</tag-file>

在<tag-file>元素中可选<description>'<display-name>和<icon>元素。

<name>指定前缀之后的标签名;

<path>指定实现自定义标签的.tag文件所在的路径。
在TLD中定义标签文件之后，就可以使用<function>元素定义0个或多个JSP函数。

<function>
    <description>
    ...
    <description>
    <name>...</name>
    <function-class>
    url
    </function-class>
    <function-signature>
    ...
    </function-signature>
    <example>
    ...
    </example>
</function>

<function-class>标注一个标准Java类的完全限定名称，函数签明实际上是此类的静态方法签名。任何公共类上的所有公共静态方法都可以通过这种方式成为JSP函数。

在TLD中所有的<tag>、<tag-file>和<function>标签之后，可以使用<taglib-extension>元素定义0个或多个标签库扩展。
相对于page指令，标签文件有一个tag指令。该指令将替换JSP page指令的必要功能，并且替换了TLD文件的<tag>元素中的许多配置。
创建自定义标签的最简单的方式就是：编写一个标签使用含有tagdir特性的taglib指令。

<%@ taglib prefix="template" tagdir="/WEB-INF/tags/temple" %>