TLD自定义标签

布满荆棘的人生 2022-07-12 13:42 172阅读 0赞

**TLD配置说明**

rtexprvalue的全称是 Run-time Expression Value， 它用于表示是否可以使用JSP表达式.

当在<attribute>标签里指定<rtexprvalue>true</rtexprvalue>时， 表示该自定义标签的某属性的值可以直接指定或者通过动态计算指定, example as follow:

<sql:query var="result" >  
select \* from mytable order by nameid  
</sql:query>  
<%request.setAttribute("nameid", "2"); %>  
<myTag:cupSize cupSize="1" cupSizes="$\{result\}"></myTag:cupSize>  
<myTag:cupSize cupSize="$\{nameid\}" cupSizes="$\{result\}"></myTag:cupSize>

当在<attribute>标签里指定<rtexprvalue>false</rtexprvalue>时， 表示该自定义标签的某属性的值只能直接指定, example as follow:  
<myTag:cupSize cupSize="1" cupSizes="$\{result\}"></myTag:cupSize>

...................................................................................................................................................................................................................

**TLD文件配置详解（jsp自定义标签）**

<tag>  
<name>write</name>  
<tagclass>org.apache.struts.taglib.bean.WriteTag</tagclass>  
<bodycontent>empty</bodycontent>  
<attribute>  
<name>bundle</name>  
<required>false</required>  
<rtexprvalue>true</rtexprvalue>  
</attribute>  
</tag>  
</taglib>其中:  
<name>write</name>：这个Tag的名字  
<tagclass>org.apache.struts.taglib.bean.WriteTag</tagclass>：这个Tag是由那个类实现的（这个class可以在struts.jar包中找到）  
<bodycontent>empty</bodycontent>：这个Tag可以直接结尾，不需要填写内容  
这里bodycontent有三个可选值  
jsp 标签体由其他jsp元素组成  
如果其有jsp元素，那么标签会先解释，然后将元素的实际值传入。比如标签体里含有<%=attributeName%>这样子的jsp元素，此时标签会按attributeName的实际值是什么就传入什么。这个是最常用的一个。  
empty 标签体必须为空  
在引用这个Tag的时候，可以<bean:write bundle="attributeName" />，而不必<bean:write bundle="attributeName" ></bean:write>  
tagdependent 由标签解释，不带jsp转换  
<attribute> </attribute>这里标识的是这个Tag的一个参数  
<name>bundle</name>这个参数的名字  
<required>false</required>这个参数是否是必填相  
如果为true则必须写这个参数，否则会报错  
<rtexprvalue>true</rtexprvalue>是说这个标签的值可以写入  
rtexprvalue:"RUN-TIME EXPRESSION VALUE",是否可以动态赋值,在jsp中如value="<%=attributeName%>"

**重载BodyTagSupport类的方法:**  
编写标签对应的实现类时，需要重载BodyTagSupport类几个方法：doStartTag(), setBodyContent(), doInitBody(), doAfterBody(), doEndTag();

**他们执行顺序如下：**  
doStartTag()→doInitBody()→setBodyContent()→doAfterBody()→doEndTag()

doStartTag()方法可返回EVAL\_BODY\_INCLUDE或SKIP\_BODY，  
如果返回**EVAL\_BODY\_INCLUDE**则继续执行；  
如果返回**SKIP\_BODY**则接下来的doInitBody(),setBodyContent(), doAfterBody()三个方法不会被执行，  
而直接执行doEndTag()方法。

setBodyContent()方法用于设置标签体内容，如果在此之前要作一些初始化工作，则在doInitBody()方法中完成。  
标签体内容执行完后，会调用doAfterBody()方法，此方法可返回**EVAL\_BODY\_TAG**, **SKIP\_BODY**,  
**EVAL\_PAGE**或**SKIP\_PAGE**。  
如果返回**EVAL\_BODY\_TAG**则会再次设置标签体内容，直到返回SKIP\_BODY；  
如果返回**EVAL\_PAGE**则标签体执行完后会继续执行JSP页面中接下来的部分；  
如果返回**SKIP\_PAGE**，则JSP页面的后续内容将不再执行。

**标签中静态常量:**

**EVAL\_BODY\_INCLUDE**：告诉服务器正文的内容，并把这些内容送入输出流  
**SKIP\_BODY**：告诉服务器不要处理正文内容  
**EVAL\_PAGE**：让服务器继续执行页面  
**SKIP\_PAGE**：让服务器不要处理剩余的页面  
**EVAL\_BODY\_AGAIN**：让服务器继续处理正文内容，只有doAfterBody方法可以返回  
**EVAL\_BODY\_BUFFERED**：BodyTag接口的字段，在doStartTag()返回  
EVAL\_BODY\_INCLUDE、SKIP\_BODY一般由doStartTag()返回，而EVAL\_PAPGE、SKIP\_PAGE由doEndTag()返回。