一、简介
1、自定义标签主要用于移出JSP页面中的Java代码。
2、使用自定义标签移除JSP页面中的Java代码,只需要完成以下两个步骤:
- 编写一个实现Tag接口的Java类(标签处理器类);
- 编写标签库描述符(tld)文件,在tld文件中对标签处理器类进行描述。
3、Tag接口的执行流程:
JSP引擎在遇到自定义标签时,首先创建标签处理器类的实例对象,然后按照JSP规范定义的通信规则一次调用他的方法。
- public void setPageContext(pageContext pc),JSP引擎实例化标签处理器类后,将调用setPageContext()方法将JSP页面的pageContext对象传递给标签处理器类,传递给标签处理器以后可以通过pageContext对象与JSP页面进行通信。
- public void setParent(Tag t),setPageContext执行完后,web容器接着调用setParent方法,将当前标签的父标签传递给当前标签处理器类,如果当前标签没有父标签,则传递给setParent方法的参数值为null。
- public int doStartTag(),调用setPageContext方法和setParent方法之后,web容器执行到自定义标签的开始标记时,就会调用标签处理器的doStartTag方法。
- public int doEndTag(),web容器执行完自定义标签的标签体后,就会接着去执行自定义标签的结束标记,此时web容器会调用标签处理器的doEndTag方法。
- public void release(),通常web容器执行完自定义标签后,标签处理器会驻留在内存中,为其他程序请求服务器,直至停止web应用时才会调用release方法。
二、自定义标签的功能扩展
1、开发人员在编写JSP页面时,经常还需要在页面中引入一些逻辑,例如:
- 控制JSP页面某一部分是否执行;
- 控制整个JSP页面是否执行;
- 控制JSP页面内容重复执行;
- 修改JSP页面内容输出;
2、自定义标签除了可以移除JSP页面中的Java代码外,也可以实现以上四种功能。
3、tld文件中的四种标签体类型:
EMPTY JSP scriptless tagdependent
三、简单标签
1、SimpleTag方法介绍
由于传统标签使用三个标签接口来完成不同的功能,显得过于繁琐,不利于标签技术的推广,SUN公司为了降低标签技术学习的难度,,在JSP2.0中定义了一个更为简单、编译编写和调用的SimpleTag接口来实现标签的功能。实现SimpleTag接口的标签通常称为简单标签。简单标签共定义了五个方法:
- setJspContext方法:用于把JSP页面的pageContext对象传递给标签处理器对象;
- setParent和getParent方法:用于将父标签处理器对象传递给标签处理器类,以及获取当前标签的父标签处理器对象;
- setJspBody方法:用于把代表标签体的JspFragment对象传递给标签处理器对象;
- doTag方法:用于完成所有的标签逻辑,包括输出、迭代、修改标签体内容等。在doTag 方法中可以抛出javax.servlet.jsp.SkipPageException异常,用于通知web容器不再执行JSP页面中共位于结束标记后面的内容。等同于传统标签汇总doEndTag方法中TagSKIP_PAGE常量。
2、SimpleTag接口方法的执行顺序
当web容器开始执行标签时,会调用如下方法完成标签的初始化:
- web容器调用标签处理器对象的setJspContext方法,将代表JSP页面的pageContext对象传递给标签处理器对象;
- web容器调用标签处理器对象的setParent方法,将父标签对象传递给这个标签处理器对象。(注意:只有在标签存在父标签的情况下,web容器才会调用这个方法。)
- 如果调用标签时设置了属性,容器将调用每个属性对应的setter方法把属性值传递给标签处理器对象。如果标签的属性值是EL表达式或脚本表达式,则web容器首先计算表达式的值,然后把只传递给标签处理器对象;
- 如果简单标签有标签体,容器将调用setJspBody方法把代表标签体的JspFragment对象传递尽量。
执行标签时:
- 容器调用标签处理器的doTag方法,开发人员在方法体内通过操作JspFragment对象,就可以实现是否执行、迭代、修改标签体的内容。
3、JspFragment类
javax.servlet.jsp.tagext.JspFragment类,是在JSP2.0中定义的,它的实例对象代表JSP页面中的一段符合JSP语法规范的JSP片段,这段JSP片段中不能包含JSP脚本元素。
web容器在处理简单标签的标签体时,会把标签体内容用一个JspFragment对象表示,并调用标签处理器对象的setJspBody方法把JspFragment对象传递给标签处理器对象。JspFragment类中只定义了两个方法:
- getJSPContext方法:用于返回代表调用页面的JspContext对象;
- public abstract void invoke(java.io.Writer out)方法:用于执行JspFragment对象所代表的JSP代码片段。(参数out,用于指定将JspFragment对象的执行结果写入到那个输出流对象中,如果参数的值为null,则执行结果写入到JspContext.getOut方法返回的输出流对象中,简单地说是写给浏览器)
4、invoke方法详解
JspFragment.invoke方法是JspFragment最重要的方法,利用这个方法可以控制是否执行和输出标签体的内容,是否迭代执行标签体的内容,或对标签体的执行结果修改在后再输出。例如:
- 在标签处理器中,如果没用调用invoke方法,其结果相当于忽略标签体的内容;
- 在标签处理器中,重复调用invoke方法,则标签体内容会被重复执行;
- 若想在标签处理器中修改标签体内容,只需要在调用invoke方法时,制定一个可取出数据结果的输出流对象(例如StringWriter),让标签体的执行结果输出到该输出流对象中,然后从该输出流对象中取出数据进行修改后再输出到目标设备,即可达到修改标签体的目的。
四、开发带属性的标签
自定义标签可以定义一个或多个属性,这样在JSP页面中应用自定义标签时就可以设置这些属性的值,通过这些属性为标签处理器类传递参数,从而提高标签的灵活性和复用性。
要想让一个自定义标签具有属性,通常需要完成两个任务:
- 在标签处理器中,编写每个属性的setter方法;
- 在TLD文件中描述标签的属性。
为自定义标签定义属性时,每个属性都必须按照JavaBean的属性命名方式,在标签处理器中定义属性名对应的setter方法,用来接收JSP页面调用自定义标签时传递进来的属性值。例如属性url,在标签处理器类中就要定义相应的setURL(String url)方法。
在标签处理器中定义相应的set方法后,JSP引擎在解析执行开始标签前,也就是调用doStartTag方法前,会调用set属性方法为标签设置属性。
使用标签控制页面逻辑案例:
- 开发防盗连标签
- 开发<c:if>标签
- 开发<c:if><c:else>标签
- 开发迭代表情
- 开发html转移标签
- 打包标签库
五、JSTL标签库
1、<c:out>标签
<c:out>标签用于输出一段文本内容到pageContext对象当前保存的out对象中。
2、<c:set>标签
<c:set>标签用于把某一个对象存在指定的域对象中,或者设置web域中的java.util.Map类型的属性对象,或JavaBean类型的属性对象的属性。
3、<c:remove>标签
<c:remove>标签用于删除各种web域中的属性。
语法格式:<c:remove var="varName" [scope="{page|request|session|application}"] />
4、<c:catch>标签
<c:catch>标签用于捕获嵌套在标签体中内容抛出的异常。
语法格式:<c:catch [var="varName"]>nested actions</c:catch>
var属性用于标识<c:catch>标签捕获的异常对象,它将保存在page这个Web域中。
5、<c:if>标签
<c:if test="">标签可以构造简单的"if-then"结构的条件表达式。
6、<c:choose>标签
<c:choose>标签用于多个条件的组合边界,它必须与<c:when>和<c:otherwise>标签一起使用,使用<c:choose>,<c:when>和<c:otherwise>三个标签,可以构造类似 “if-else if-else” 的复杂条件判断结构。
7、<c:forEach>标签
<c:forEach>标签用于对一个集合对象中的元素进行循环迭代操作,或者按指定的次数重复迭代执行标签体中的内容。
8、<c:param>标签
在JSP页面进行URL的相关操作时,经常要在URL地址后面附加一些参数。<c:param>标签可以嵌套在<c:import>、<c:url>或<c:redirect>标签内,为这些标签所使用的URL地址附加参数。
<c:param>标签在为一个URL地址附加参数时,将自动对参数值进行URL编码,例如,如果传递的参数值为“中国”,则将其转换为“%d6%d0%b9%fa”后再附加到URL地址后面,这也就是使用<c:param>标签的最大好处。
9、<c:url>标签
<c:url>标签用于在JSP页面中构造一个URL地址,其主要目的是实现URL重写。URL重写就是将会话标识号以参数形式附加在URL地址后面
10、<c:redirect>标签
<c:redirect>标签用于实现请求重定向