目录
背景
3.1Tag文件
3.1.1Tag文件的结构
3.1.2Tag文件的保存
3.2Tag标记
3.2.1Tag标记与Tag文件
3.2.2Tag标记的使用
3.2.3 Tag标记的运行原理
3.3Tag文件中的常用命令
3.3.1tag命令
3.3.2attribute
3.3.3variable指令
背景
第2章学习了include 指令标记和include 动作标记,使用这两个标记可以实现代码的复用。但是,在某些情况下,使用include 指令标记和include 动作标记有一定的缺点,比如,如身include 指令标记或动作标记要处理的文件是一个JSP文件,那么用户可以在浏览器的地址样中直接输入该JSP文件所在Web服务目录访问这个JSP文件,这可能不是Web应用所希望发生的,因为该JSP文件也许仅仅是个导航条,仅仅供其他JSP 文件使用include指令标记动作标记来嵌入或动态加载的,而不是让用户直接访问的。另外、include 指令标记和incluc动作标记允许所要处理的文件存放在Web服务目录中的任意子目录中,不仅显得杂乱无章而且使得include标记和所处理文件的所在目录的结构形成了耦合,不利于Web应用的维护JSP 页面动态加载调用,因此,我们将重新学习一种特殊的文本文件:Tag文件。
3.1Tag文件
3.1.1Tag文件的结构
Tag文件扩展名为.tag,和JSP文件很类似,一个Tag文件中可以有通的HTML标记符、某些特殊的指令标记(见3.4节)、成员变量声明和方法的定义、Java程序片和java表达式。
3.1.2Tag文件的保存
1.Tag文件所在的目录
Tag 文件可以实现代码的复用,即Tag 文件可以被许多JSP页面使用。为了能让一个Web 应用中的JSP页面使用某一个Tag 文件,必须把这个Tag文件存放到Tomcat 服务器指定的目录中,也就是说,如果某个Web服务目录下的JSP页面准备调用一个Tag文件,那么必须在该Web服务目录下,建立如下的目录结构:
wab服务目录\WEB- INF\tags
例如
2.Tag文件的编码
保存Tag 文件时按照Tag 文件指定的编码保存,例如Tag文件使用tag指令:
<%@ tag pageEncoding ="utf-8"%>
指定的编码是UTF-8,因此需要按照UTF-8编码保存Tag文件。例如,用文本编辑器“记事本”编辑Tag文件,在保存该Tag文件时,将“保存类型(T)”选择为“所有文件(*.*)”,将“编码(E)”选择为“UTF-8”.
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标记时,冒号;的左右不要有空格。
例如
<%@ page contentType = "text/html" %>
<%@ page pageEncoding = "utf-8" %>
<%@ taglib tagdir = "/WEB-INF/tags" prefix = "computer"%>
<HTML><body bgcolor = cyan>
<h1>调用Tag文件计算100内奇数和:</h1>
<computer:oddNumberSum /> <%-- 使用Tag标记 --%>
</body></HTML>
<%@ tag pageEncoding="utf-8" %>
<p style="font-family:宋体;font-size:36">
1~100内的奇数之和:
<% int sum=0,i=1;
for(i=1;i<=100;i++){
if(i%2==1)
sum=sum+i;
}
out.println(sum);
%>
</p>
如果把3.1.1节中的addNumberSum.tag保存在ch3\WEB-INF\tags\examplel目录中,那只要修改taglib指令为
<%@ taglib tagdir = "/WEB-INF/tags/examplel" prefix = "computer"%>
3.2.3 Tag标记的运行原理
Tomcat 服务器处理JSP页面中的Tag标记的原理如下:
如果该Tag标记对应的Tag文件是首次被JSP页面调用,那么Tomcat服务器会将Tag文件转译成一个Java文件,并编译这个Java文件生成字节码文件,然后执行这个字节码文件(这和执行JSP页面的原理类似)。
如果该 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属性1=“属性值”%>
<%@tag属性2=“属性值”%>
<%@tag属性3=“属性值”%>
① languagc 属性
language 属性的值指定Tag 文件使用的脚本语言,目前只能取值Java,其默认值就是
Java,因此在编写Tag文件时,没有必要使用tag指令指定language属性的值。
② import 属性
import 属性的作用是为Tag文件引人包中的类,这样就可以在Tag文件的程序片部分变量及方法定义部分、表达式部分使用包中的类。import属性可以取多个值,import 属性翼认已经有如下值:"java. lang.*""javax. servlet.*""javax.servlet.jsp.*""javat servlet. http. *"
③ pageEncoding
该属性指定 Tag 文件的字符编码,其默认值是 1SO-8859-1。目前,为了避免显示信息片
现乱码现象,Tag文件需要将该属性值设置为UTF-8。
3.3.2attribute
Tag 文件充当着可复用代码的角色,如果一个Tag文件允许使用它的JSP页面向该Ta文件传递数据,就使得Tag文件的功能更为强大。在Tag文件中通过使用attribute指令让使用它的JSP页面向该Tag 文件传递需要的数据。attribute指令的格式如下:
<%@attribute name="对象名字"required="true"/"false"type="对象的类型”%>
那么就相当于Tag 文件中有了一个名字是result的对象,但Tag文件不需要创建该对象
result,而是等待JSP页面将一个Double型的对象的引用传递给result。
attribute指令中的name属性是必需的,该属性的值是一个对象的名字。JSP页面在调用Tag文件时,可向name属性指定的对象传递一个引用。需要特别注意的是,type在指定对象类型时,必须使用包名,比如,不可以将java.lang.Double简写为Double。如果attribute 指令中没有使用type指定对象的类型,那对象的类型默认是java. lang.String类型.
在Tag文件中不可以在定义和attribute指令中的name属性给出的对象具有相同名字的变量,否则将隐藏attribute指令中给出的对象,使其失效。
3.3.3variable指令
Tag文件通过使用attribute指令,可以使得调用该Tag文件的JSP页面动态地向其传数据。在某些Wcb应用中,JSP页面不仅希望向Tag 文件传递数据,而且希望Tag 文件能回数据给JSP页面。
① variable指令的格式
variable指令的格式如下:
<%@variable name-given="对象名”variable-class="对象类型”scope="有效范围”%>
name-given 属性:指定返回对象的变量名
variable-class 属性:指定返回对象的类型,默认 java.lang.String,此处必须填完整名称.
scope 属性:指定对象的有效范围,可取的值有:
NESTED:对象仅在Tag标记的标记体中有效,默认取值.
AT_BEGIN:一旦开始使用Tag标记,此对象就有效.
AT_END:只有在Tag标记结束后此对象才有效.
②对象的返回
Tag 文件为了给JSP页面返回一个对象,就必须将返回的对象的名字以及该对象的引用存储到Tomcat 服务器提供的内置对象jspContext中。Tag文件只有将对象的名字及其引用存储到jspContext中,JSP页面才可以使用该对象。比如,Tag 文件的variable指令:
<%@ variable name - given = "time"variable-class ="java. time. LocalDate" scope = "AT_END" %>
为JSP 页面返回名字是 time 的LocalDate 对象。那么Tag 文件中必须让jspContext 调用
setAttribute("对象名”,对象的引用);
方法存储名字是time的对象以及该对象的引用,例如:
setAttribute("time",LocalDate .now()):
将名字是time的LocalDate对象存储到jspContext中。
example3_4.jsp
<%@ page contentType="text/html" %>
<%@ page pageEncoding = "utf-8" %>
<%@ taglib tagdir="/WEB-INF/tags/example4" prefix="getPrice" %>
<HTML><body bgcolor = #FFCCFF>
<% String str = "麻辣豆腐:20.6元,红烧肉:68.9元,烤鸭:1