【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描述文件中的值保持一致


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








你可能感兴趣的:(java,Web)