JavaWeb高级编程 -- 篇7
编写自定义标签和函数库
为了使用标签文件中定义的标签,可以使用taglib中的tagdir特性帮助你完成:
tagdir目录中所有的.tag或者.tagx文件都将被绑定到myTags命名空间。
为编写自定义的标签和函数库,必须了解JSP标签库XSD和使用它编写标签的方式。
关于JSP标签库XSD有一件重要的事情需要注意:模式使用了严格的元素顺序,这意味着所有使用的元素必须严格按照特定的顺序出现,否则该TLD文件将是无效的。
JSTL 1.2 core library
JSTL core
1.2
c
http://java.sun.com/jsp/jstl/core
关于以上代码:
元素和提供了XML工具可以显示有用的名称,但与TLD的实际内容无关并且是可选的。如果需要,可以添加许多和,这样可以为不同的语言指定不同的显示名称和描述。
元素为可选元素,这里没有出现,它必须出现在和之前。
是必须元素。它定义了标签库的版本,其中只能使用数字和圆点。
表示该标签库推荐使用,也是默认的前缀,也是必须的,不能包括空白,或者以数字或下划线开头。
定义了该标签库的URI。
元素是TLD的主要元素,负责定义标签库中的标签。
catches throwable
catch
org.apache.taglibs.standard.tag.common.core.catchTag
JSP
name of the exported scoped variable for the exception thrown from a nested action.
var
false
false
如一样,它可以由0个或多个嵌套的、和元素。在这些元素之后需要一个元素,它将指定JSP标签的名称在本例中,完整的标签名称为,c是标签库,catch是标签的名称。一个标签明显只可以有一个名称。接下来是元素,它表示负责执行标签的标签处理器类。
接下来是指定了标签中允许嵌套的内容类型。
在之后是0个或多个元素,该元素提供了使用该标签定义的结果变量的相关信息。
在标签的元素之后,可以定义0个或多个,它将为标签定义可用的特性。
标签之后是,该属性不常见,只可以指定该布尔元素一次或者忽略它。默认值为假,用于表示是否允许通过元素指定特性值。
在之后是可选的元素,为标签的使用提供样例。
标签文件实际上就是一种JSP,只不过使用的语义稍有不同。
JAR库中的标签文件必须定义在TLD中,另外,如果希望将一个或多个标签文件分配到相同的命名空间,那么需要在TLD中定义这些标签,即使它们不再JAR文件中。
在TLD的所有元素之后,可以添加0个或多个元素,定义属于库的标签文件。
this tag outputs bar.
foo
/WEB-INF/tags/foo.tag
在元素中可选'和元素。
指定前缀之后的标签名;
指定实现自定义标签的.tag文件所在的路径。
在TLD中定义标签文件之后,就可以使用元素定义0个或多个JSP函数。
...
...
url
...
...
标注一个标准Java类的完全限定名称,函数签明实际上是此类的静态方法签名。任何公共类上的所有公共静态方法都可以通过这种方式成为JSP函数。
在TLD中所有的、和标签之后,可以使用元素定义0个或多个标签库扩展。
相对于page指令,标签文件有一个tag指令。该指令将替换JSP page指令的必要功能,并且替换了TLD文件的元素中的许多配置。
创建自定义标签的最简单的方式就是:编写一个标签使用含有tagdir特性的taglib指令。