原作者:Edward的成长日记
标签的描述文件是一个描述整个标签库标记信息和标签库中每个标签处理器以及其属性的XML文档。可以包含如下的一些元素。
1. tlibversion:标签库版本号,是一个点式十进制数(例如1.0),最多为4组小数点分隔的数字组成。
2. jspversion:标签库所需的JSP规范最低版本,例如JSP1.1。
3. shortname:标签库的缩写名,JSP可以使用该名字作为库中标签的缺省前缀。
4. uri:标签库唯一URI的元素。
5. info:标签库描述信息。
6. tag:加入标签,描述组成库的每个标签。
在tag元素中包含标签及其属性的信息:
1. name:与标签库的名字前缀一起使用的标签的名字, 是JSP容器唯一的标签标识。
2. tagclass:实现标签的标签处理器类的全名。
3. teiclass:标签附加信息(TEI)类的全名,TEI类给出关于标签处理器创建变量及有效性验证的信息。
4. bodycontent:描述标签处理器如何使用标签体的内容,有三种取值:
l empty:表示标签体必须为空;
l JSP:表示脚本元素和模板及其它标签一样被评估。
l tagdependent:内容被原封不动写入BodyContent,其它脚本元素以源码形式出现,而不被JSP容器解释。
5. info:标签的描述性信息。
6. attribute:使用标签时被编码的属性信息,用于定义标签的属性。
“attribute”元素中又可以包含下面几个元素:
1. name:属性的名字。
2. required:属性是否必须。
3. rtexprvalue:属性值能否用表达式指定
7.variable 元素
1.name-given:变量名为常量
2.name-from-attribute:一个属性的名字,其转换时(translation-time)值将给出属性的名字
必须有name-given或者name-from-attribute之中的一个。下列子元素是可选的
3.variable-class—变量的完全限定名。默认为java.lang.String。
4.declare—变量是否引用新对象。默认为True。
5.scope—定义的脚本变量的作用域。默认为NESTED如下表格:
值 | 可用性 | 方法 |
NESTED | 开始和结束标签之间 | 在实现BodyTag的标签handler的doInitBody 和doAfterBody方法中,否则,在 doStartTag中 |
AT_BEGIN | 从开始标签到页面的结束 | 在实现BodyTag的标签handler的doInitBody 和doAfterBody方法中,否则,在 doStartTag和doEndTag中 |
AT_END |
在结束标签之后直到页面的结束 | 在doEndTag中 |
在function元素中包含标签及其属性的信息:
1. name:与标签库的名字前缀一起使用的标签的名字, 是JSP容器唯一的标签标识。
2. function-class:实现标签的标签处理器类的全名。
3. function-signature:指定标签库中所使用的方法,与类中的方法名称返回值必须相同,必须为全名 。
JSP自定义标签各种方法的返回值.
EVAL_BODY_INCLUDE:把BODY读入存在的输出流中,doStartTag()函数可用。
EVAL_PAGE:继续处理页面,doEndTag()函数可用。
SKIP_BODY:忽略对BODY的处理,doStartTag()和doAfterBody()函数可用。
SKIP_PAGE:忽略对余下函数的处理,doEndTag()函数可用。
EVAL_BODY_TAG:已经废止,由EVAL_BODY_BUFFERED取代。
EVAL_BODY_BUFFERED:申请缓冲区,由setBodyContent()函数得到的BodyContent对象来处理tag的Body,如果类实现了BodyTag,那么doStartTag()可用,否则非法。
另外一种网上的说法是:
SKIP_BODY : 跳过了开始和结束标签之间的代码,一般是在doStartTag中使用,不处理标签体,直接调用 doEndTagO方法。
EVAL_BODY_INCLUDE :处理嵌套的标签,一般是在doStartTag中使用,由负责处理标签正文的tag接口提供
EVAL_BODY_BUFFERED :对包含的内容进行解析 一般是在doStartTag中使用,由负责处理标签正文的bodyTag接口提供,目的是通知jsp容器作好读取正文的工作(创建一个body-content包装正文和获取存放操作结果的out对象,便于以后的操作和输出).
EVAL_BODY_AGAIN:处理标签正文, 对标签体循环处理。嵌套标签的iteratorTag接口的使用
SKIP_PAGE :忽略标签后面的 JSP 页面,一般是在doEndTag中使用
EVAL_PAGE :处理标签结束,直接处理页面内容。继续执行下面的页, 一般是在doEndTag中使用
在web.xml中定义taglib地址
<jsp-config>
<!--定义标签库-->
<taglib>
<!--确定标签库的URI-->
<taglib-uri>http://lauedward.spaces.live.com/</taglib-uri>
<!-- 确定标签库定义文件的位置 -->
<taglib-location>/WEB-INF/test.tld</taglib-location>
</taglib>
</jsp-config>
如果不设定这个的话也可以直接在jsp中直接引用本地路径tld的地址即可调用
至此,taglib相关的教程就暂告一段落了.