21_自定义标签

标签类型
SimpleTagSupport类别顾名思义，就是可以处理一些简单的自 定义标签需求，它是在JSP 2.0之后新增的类别，对于一些简单 的标签页，您可以继承它来实作标签处理类别。 为了使用上的简单而降低了复杂性，另一方面就是 SimpleTagSupport类别所处理的功能受了些限制，它只处理标 签与本体，要不要显示本体文字取决于您，对于标签之后的页 面则不在SimpleTagSupport处理的范围之内（虽然您还是可以 SimpleTagSupport 使用forward之类的方式来决定要不要显示之后的页面，但直接 实作TagSupport会更方便一些），另外SimpleTagSupport类别 的本体文字不能设定为JSP，这也是使用 SimpleTagSupport上 的一些限制。 尽管有了一些限制，对于简单的标签需求，使用 SimpleTagSupport还是比较容易的，它实作了SimpleTag接口， 您只要重新定义doTag()方法就可以实作自订标签的处理。
自定义标签
本章目标
• • • • • 标签相关概念 创建和使用自定义标签的基本步骤 自定义JSP标签的处理过程 标签库描述文件 自定义标签实例
标签相关概念
一、基本概念： 基本概念： 1.标签(Tag): 标签是一种XML元素，通过标签可以使JSP网页变得简洁并且易于维 护，还可以方便地实现同一个JSP文件支持多种语言版本。由于标签 是XML元素，所以它的名称和属性都是大小写敏感的 2.标签库(Tag library): 由一系列功能相似、逻辑上互相联系的标签构成的集合称为标签库。 3.标签库描述文件(Tag Library Descriptor): 标签库描述文件是一个XML文件，这个文件提供了标签库中类和JSP 中对标签引用的映射关系。它是一个配置文件，和web.xml是类似的 4.标签处理类(Tag Handle Class): 标签处理类是一个Java类，这个类继承了TagSupport或者扩展了 SimpleTag接口，通过这个类可以实现自定义JSP标签的具体功能
标签库表述文件
1.标签库描述文件，简称TLD，采用XML文件格 式，定义了用户的标签库。TLD文件中的元素 可以分成3类：
A.：标签库元素 B.：标签元素 C.：标签属性元素
2.标签库元素用来设定标签库的相关信息，它的 常用属性有：
A.shortname： 指定Tag Library默认的前缀名(prefix) B.uri： 设定Tag Library的惟一访问表示符
4.标签属性元素用来定义标签的属性，它的常见属性有：
：属性名称 B.required：属性是否必需的，默认为false C.rtexprvalue：属性值是否可以为request-time表达式，也就 是类似于< %=…% >的表达式
标签类型
javax.servlet.jsp.tagext.Tag (简单标签) javax.servlet.jsp.tagext.BodyTag(正文标签) 简单标签可以实现 Tag 接口，要记住不对其正 文操作的标签仍然有正文，只不过，它的标签 处理程序不能读取这个正文。
标签库表述文件
3.标签元素用来定义一个标签，它的常见属性有：
： 设定Tag的名字 B.tagclass： 设定Tag的处理类 C.bodycontent： 设定标签的主体(body)内容
1).empty：表示标签中没有body 2).JSP：表示标签的body中可以加入JSP程序代码 3).tagdependent：表示标签中的内容由标签自己去处理
基本步骤
• 1.创建标签的处理类(Tag Handler Class) • 2.创建标签库描述文件(Tag Library Descrptor File) • 3.在JSP文件中引入标签库 • 4.在JSP中使用标签
自定义标签的处理过程
1．在JSP中引入标签库： <% @ taglib prefix=”taglibprefix” uri=”tagliburi” %> 2．在JSP中使用标签库标签 3．Web容器根据第二个步骤中的prefix，获得第一个步骤中声明的taglib的uri属 性值 4．Web容器根据uri属性从WEB-INF/目录下找到对应的.tld文件 5．从.tld文件中找到与tagname对应的元素 6．从元素中获得对应的元素的值 7．Web容器根据元素的值创建相应的tag handle class的实例 8. Web容器调用这个实例的doStartTag/doEndTag方法完成相应的处理
标签库的优点
• 标签库的优点 1、最大限度地消除jsp页面中嵌入的java代 码 2、增强代码扩展性、可读性、代码复用， 简化了jsp页面编写的工作量
实例
标签处理类 package demo.tags; import java.io.*; import javax.servlet.jsp.*; import javax.servlet.jsp.tagext.*; public class SimpleTagHello extends SimpleTagSupport { public void doTag() throws JspException, IOException { JspWriter out = getJspContext().getOut(); out.println("Hello!World!"); } } Tld文件： <tag> <description>Simple Tag</description> <name>hello</name> <tag-class>demo.tags.SimpleTagHello</tag-class> <body-content>empty</body-content> </tag>
总结
• • • • • 标签相关概念 自定义JSP标签的处理过程 创建和使用一个Tag Library的基本步骤 标签库描述文件 自定义标签实例