[有书共享]JavaWeb高级编程

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" %>
#Java##读书笔记#
全部评论

相关推荐

点赞 评论 收藏
转发
点赞 收藏 评论
分享
牛客网
牛客企业服务