【Java.Web】JSP —— 标签库taglib —— 自定义JSP标签 —— 标签库描述文件 TLD，发布

标签库描述文件

标签库描述文件（Tag Library Descriptor, TLD）,采用XML文件格式，对标签库及库中的标签做了描述。

TLD文件中的元素可以分为3类，

<taglib> —— 标签库元素
<tag> —— 标签元素
<attribute> —— 标签属性元素

标签库元素 <taglib>

标签库元素<taglib>用来设定标签库的相关信息，它的子元素如下：

tlib-version —— 指定标签库的版本
jsp-version —— 指定JSP的版本
short-name —— 指定标签库默认的前缀名prefix
uri —— 设定标签库的唯一访问标识符
info —— 设定标签库的说明信息

标签元素 <tag>

标签元素<tag>元素用来定义一个标签，它的子元素如下：

name —— 设定标签的名字
tag-class —— 设定Tag的处理类
body-content —— 设定标签主体的类型
info —— 设定标签的说明信息

<body-content>子元素用于设定标签主体的类型，可选值包括：

empty —— 标签主体为空
scriptless —— 标签主体不为空，并且包括JSP的EL表达式和动作元素，但不能包含JSP的脚本元素。（动作元素指<jsp:include><jsp:forward>等action，脚本元素指<%! %>, <%% >, <%= %>这3种）
jsp —— 标签主体不为空，并且包含JSP代码。在JSP代码中可包含EL表达式，动作元素和脚本元素
tagdependant —— 标签主体不为空，并且标签主体内容由标签处理类来解析和处理。标签主体的所有代码都会原封不动地传给便签处理类，而不是把标签主体的执行结果传给标签处理类

标签属性元素 <attribute>

用来描述标签的属性，<attribute>元素的子元素如下：

name —— 属性名称
required —— 属性是否是必须的，默认为false
rtexprvalue _—— 属性值是否可以为基于“<%= %>”形式的Java表达式或EL表达式；若为false，只能为普通的字符串；（runtime expression value）

标签库描述文件示例

<?xml version="1.0" encoding="UTF-8"?>
<taglib version="2.1" xmlns:xml="http://www.w3.org/XML/1998/namespace"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd ">
<tlib-version>1.1</tlib-version>
<jsp-version>2.1</jsp-version>
<short-name>mytaglib</short-name>
<uri>/mytaglib</uri>

<tag>
<name>message</name>
<tag-class>com.gof.test.taglib.MessageTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>key</name>
<required>true</required>
</attribute>
</tag>

</taglib>

发布标签库，注册TLD

假设我们在WEB-IN/下添加一个tld文件mytablig.tld文件：

在web.xml中：

<!-- taglib configuration -->
<jsp-config>
<taglib>
<taglib-uri>/mytaglib</taglib-uri>
<taglib-location>/WEB-INF/mytaglib.tld</taglib-location>
</taglib>
</jsp-config>

在应用的JSP文件中：

*.jsp

<%@ taglib uri="/mytaglib" prefix="mm" %>

uri的值应该与tld描述文件中的值保持一致。

如果使用第三方开发的标签库，请参见 使用第三方标签库 一节。