自定义JSP标签

自定义JSP标签概述

 

        自定义JSP标签就是程序员定义的一种JSP标签,这种标签把那些信息显示逻辑封装在一个单独的Java类中,通过一个XML文件来描述它的使用。当页面中需要使用类似的显示逻辑时,就可以在页面中插入这个标签,从而完成相应的功能。
        使用自定义标签,可以分离程序逻辑和表示逻辑,将Java代码从HTML中剥离,便于美工维护页面;自定义标签也提供了可重用的功能组件,能够提高工程的开发效率。

 

自定义JSP标签的执行过程

         当一个含有自定义标签的JSP页面被JSP引擎(Web容器)转译成Servlet时,JSP引擎遇到自定义的标签,会把这个自定义标签转化成对一个称为“标签处理类”的调用。之后,当这个JSP页面被执行时,JSP引擎就会调用这个“标签处理类”对象,并执行其内部定义的相应操作方法,从而完成相应的功能。

 

自定义JSP标签的开发流程

 

使用Java处理类来开发自定义JSP标签时,主要分为下几个步骤。
创建标签的处理类(Tag Handle Class)。这个类用来定义标签的行为,并在JSP引擎遇到自定义标签时调用执行。
创建标签库描述文件(Tag Library Descriptor File)。
在web.xml文件中声明TLD的位置。在JSP 1.2以上规范中此步骤是可选的。
在JSP文件中用taglib指令引入标签库,然后使用标签库描述文件中指定的标签名来使用它。

 

JSP标签API

 

JSP 1.1和1.2规范中常用的接口主要有以下3个。
Tag:此接口定义对于所有标签处理类都需要实现的方法。
IterationTag:此接口扩展了Tag接口,增加了控制重复执行标签主体的方法。
BodyTag:此接口扩展了IterationTag接口,并增加了访问和操作标签主体内容的方法。

 

标签库描述符

 

标签库描述符文件是一个以“.tld”结尾的标准XML文档,用来记录一个标签库内拥有哪些标签、每个标签包含哪些属性。
以下是一个JSP 2.0规范的标签库描述文件的内容:
参见教材P194
<taglib>元素是标签库描述符的根元素,它包含12个子元素,详细介绍如下。
(1)<description>:标签库的一个文本描述。
(2)<tlib-version>:指定标签库的版本。
(3)<short-name>:为标签定义简短的名字,在taglib指令中可作为首选的前缀名使用。
(4)<uri>:定义一个URI,用于唯一地标识此标签库。
(5)<tag>:用于指定自定义标签的相关信息。
(6)<display-name>:为标签库指定一个简短的别名。
(7)<small-icon>:为标签库指定大小为16×16的小图标(gif或jpeg格式),该图标可在图形界面工具中显示。
(8)<large-icon>:为标签库指定大小为32×32的大图标(gif或jpeg格式),该图标可在图形界面工具中显示。
(9)<validator>:为标签库提供一个验证器。
(10)<listener>:为标签库提供一个监听器。
(11)<tag-file>:用于描述标签文件。
(12)<function>:用于指定在表达式语言中使用的函数。

 

处理空标签

 

在编写标签处理类时,需要注意一下空标签的问题。如果在JSP页面中使用了如下形式的自定义标签,就认为在使用一个空标签。
由XML简写空元素的表示法:<prefix:myTag />
由开始标记和结束标记以及一个空主体表示法:<prefix:myTag></prefix:myTag>
对于自定义的空标签,若其标签处理类实现了Tag或IterationTag接口,那么它的doAfterBody()方法就得不到调用。

其他不会受任何影响。对于自定义的空标签,若其标签处理类实现了BodyTag接口,容器就不会调用这些方法:setBodyContent()、doInitBody()或doAfterBody()。
问题:this.getBodyContent().getEnclosingWriter();
如果恰好使用这个自定义标签无标签主体,那么上面的代码就会抛出一个NullPointerException异常,因为setBodyContent()方法从未调用过,相应的bodyContent变量也就是null。为了避免这个问题。一定要用以下代码来检查bodyContent是否为null

JspWriter out = null;
if(this.bodyContent != null){
	out = this.getBodyContent().getEnclosingWriter();
	//out = this.getPreviousOut();
}else{
	out = this.pageContext.getOut();
}

还有一种做法,就是只在对有标签主体时才会被调用到的方法中访问bodyContent变量,即只在doInitBody()和doAfterBody()方法中访问bodyContent变量。

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值