目录
前言
本章主要学习Tag文件与Tag标记
3.1Tag文件
3.1.1Tag文件的结构
Tag文件是扩展名为.tag的文本文件,其结构与JSP文件类似。一个Tag文件中可以有普通的HTML标记符,某些特殊的指令标记,成员变量声明和方法的定义,java程序片和Java表达式。
3.1.2Tag文件的保存
1.Tag文件所在目录
Tag文件可以实现代码的复用,即Tag文件可以被许多JSP页面所使用。为了能让一个Web应用中的JSP页面使用某一个Tag文件,必须把这个Tag文件存放到Tomcat服务器指定的目录中,也就是说,如果某个Web服务目录下的JSP页面准备调用一个Tag文件,那么必须在该Web服务目录下,建立如下目录结构:
Web服务目录\WEB-INF\tags
其中的WEB-INF和tags都是固定的目录名称,而tags下的子目录的名称可由用户给定。一个Tag文件必须保存到tags目录或它的子目录中。
2.Tag编码
保存Tag文件是按照Tag文件指定的编码保存,例如:
<%@ tag pageEncoding="utf-8"%>
这里指定的编码是UTF-8,因此需要按照UTF-8编码保存Tag文件。
3.2Tag标记
3.2.1Tag标记与Tag文件
某个Web服务目录下的Tag文件只能由该Web服务目录中的JSP页面调用,JSP页面必须通过Tag标记来调用一个Tag文件。Tag标记的名字和Tag文件中的名字一致,也就是说,当我们编写了一个Tag文件并保存到特定目录中后,也就给出了一个Tag标记,该标记的格式为:
<Tag文件的名字/>
或
<Tag文件的名字>其他内容(称为标体内容)</Tag文件的名字>
一个Tag文件对于着一个Tag标记,把全体Tag标记称之为一个自定义标记库或简称为标记库。
3.2.2Tag标记的使用
一个JSP页面通过使用Tag标记来调用一个Tag文件。Web服务目录下的一个JSP页面在使用Tag标记来调用一个Tag文件之前,必须首先使用taglib指令标记引入该Web服务目录下的标记库,只有这样,JSP页面才可以使用Tag标记调用相应的Tag文件。taglib指令的格式如下:
<%@ taglib tagdir="标记库的位置”prefix="前缀">
引入标记库后,JSP页面使用就可以代前缀的Tag标记调用相应的Tag文件,其前缀由<taglib>指令中的prefix属性指定。例如:JSP如下使用Tag标记调用相应地Tag文件:
<computer:oddNumberSum/>
taglib指令中的prefix给出的前缀由用户自定义,其好处是,通过前缀可以有效的区分不同标记库中具有相同名字的标记文件。注意:JSP页面使用Tag标记时,冒号:的左右不要有空格。
3.2.3Tag标记的运行原理
Tomcat服务器处理JSP页面中的Tag标记原理如下:
- 如果该Tag标记对应deTag文件首次被JSP页面调用,那么Tomcat服务器会将Tag文件转译成一个java文件,并编译这个java文件生成字节码文件,然后执行这个字节码文件。
- 如果该Tag文件已经被编译为字节码文件,那么Tomcat服务器将直接执行这个字节码文件。
- 如果对·Tag文件进行了修改,那么Tomcat服务器将会重新将Tag文件转译成一个java文件,并编译这个java文件生成的字节码文件,然后执行这根字节码文件。
3.3Tag文件中的常用指令
3.3.1Tag指令
Tag文件中的tag指令类似于JSP文件中的page指令。Tag文件通过使用tag指令可以指定某些属性的值,以便从总体上影响Tag文件的处理和表示。tag指令的语法如下:
<%@ tag属性1="属性值"属性2="属性值"...属性n="属性值"%>
在一个Tag文件中可以使用多个tag指令,因此我们经常使用多个tag指令为属性指定需要的值:
<%@ tag属性1="属性值"%>
<%@ tag属性2="属性值"%>
...
<%@ tag属性n="属性值"%>
1.language属性
language属性 的值指定Tag文件使用的脚本语言,目前只能取值java,其默认值就是java,因此在编写Tag文件时,没有必要用tag指令指定language属性 的值。
2.import属性
import属性的作用是为Tag文件引入包中的类,这样就可以Tag文件的程序片部分、变量及方法定义部分、表达式部分使用包中的类。import属性可以取多个值,import属性默认的值有:"java.lang.*" "javax.serlet.*" "javax.servlet.jsp.*" "javax.servlet.http.*"。
3.pageEncoding
该属性指定Tag文件的字符编码,其默认值是ISO-8859-1.目前,为了避免显示信息出现乱码现象,Tag文件需要将该指定值设置为UTF-8.
3.3.2include指令
在Tag文件中也有和JSP文件类似的include指令标记,其使用方法和作用于JSP文件中的include指令标记类似。
3.3.3attribute指令
Tag文件充当着可复用代码的角色,如果一个Tag文件允许使用它的JSP页面祥该Tag文件传递数据,就使得Tag文件的功能更为强大。在Tag文件中通过使用attribute指令让使用它的JSP页面向该Tag文件传递需要的数据。attribute指令的格式如下:
<%@ attribute name="对象名字" required="true"|"false"type="对象的类型"%>
attribute指令中的name属性是必须的,该属性的值是一个对象的名字。 JSP页面在调用Tag文件时,可以向name属性指定的对象传递一个引用。需要注意的是,type在指定对象类型时,必须使用包名。如果attribute指令中没有使用type指定对象类型,那么对象默认的类型是java.lang.String类型。JSP页面使用Tag标记向所调用的Tag文件中的name指定对象传递一个引用,方式如下:
<前缀:Tag文件名字 对象名字="对象的引用"/>
attribute指令中的required属性也是可选的,如果省略required属性,那么required地默认值是false。当指定required的值是true时,调用该Tag文件的JSP页面必须向该Tag文件中的attribute指令中的name属性给出的对象传递一个引用,当指定required的值是false时,调用该Tag文件的JSP可以向该Tag文件中的attribute指令中的name属性给出的对象传递或不传递对象的引用。
3.3.4variable指令
1.variable指令的格式
variable指令的格式如下:
<%@ variable name-given="对象名"variable-class="对象类型"scope="有效范围"%>
variable指令中属性name-given的值就是Tag文件返回给JSP页面的对象。该对象的名字必须符合标识符规定,即名字可以由字母、下划线、美元符号和数字组成,并且第一个字符不能是数字字符。
variable指令中的scope属性的值指定对象的有效范围,scope的值可以取AT_BEGIN、NESTED和AT_END。
2.对象的返回
Tag文件为了给JSP页面返回一个对象,就必须将返回的对象名字以及该对象的引用存储到Tomcat服务器提供的内置对象jspContext中。Tag文件只有将对象的名字及其引用存储到jspContext中,JSP页面才可以使用该对象。例如Tag文件的variable指令:
<%@ variable name-given="time"
variable-class="java.time.LocalDate"scope="AE_END"%>
为JSP页面返回名字时time的LocalDate对象。那么Tag文件必须让jspContext调用
setAttribute("对象名",对象的引用);
方法存储名字时time的对象以及该对象的引用,例如·:
jspContext.setAttribute("time",LocalData.now());
将名字是time的LocalDate对象存储到jspContext中。
3.3.5taglib指令
JSP页面或Tag文件都可以使用taglib指令引入标记库。taglib指令格式如下:
<%@ taglib tagdir="自定义标记库的位置"prefix="前缀">
一个Tag文件也可以使用几个taglib指令标记引入若干个标记库,例如:
<%@ taglib tagdir="/WEB-INF/tags"prefix="beijing"%>
<%@ taglib tagdir="/WEB-INF/tagsTwo"prefix="dalian"%>
总结
以上就是我们关于Tag文件与Tag标记的学习。