提示:写完文章后,目录可以自动生成,如何生成可参考右边的帮助文档
文章目录
前言
本章主要内容为:Tag文件的结构、Tag标记、Tag文件中的常用指令。
一、Tag文件
(1) 、Tag文件是扩展名为 .tag的文本文件,其结构类和JSP文件类似。一个Tag文件可以有普通的HTML标记符、某些特殊的指令标记、成员变量的声明和方法的定义、Java程序片和Java表达式。以下是一个简单的Tag文件。
oddNumberSum.tag
<%@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==i)
sum=sum+i;
}
out.println(sum);
%>
</p>
(2)、Tag文件的保存:
Tag文件可以实现代码的复用,即Tag文件可以被许多JSP页面使用。如果某个Web服务目录下的JSP页面准备调用一个Tag文件,那么必须在该Web服务目录下,建立如下目录结构:
Web服务目录\WEB-INF\tags
例如:
ch3\WEB-INF\tags
二、Tag标记
1.Tag标记与Tag文件
某个Web服务目录下的Tag文件只能由该Web服务目录中的Jsp页面调用,JSP页面必须通过Tag标记来调用一个Tag文件。Tag标记的名字和Tag文件的名字一致,其格式为:
<Tag文件的名字/>
或
<Tag文件的名字>其他内容(称为标体内容)</Tag文件的名字>
一个Tag文件对应着一个Tag标记,把全体Tag标记称之为一个自定义标记库或简称为标记库。
2.Tag标记的使用
一个JSP页面通过使用Tag标记来调用一个Tag标记来调用一个Tag 文件。Web服务目录下的一个JSP页面在使用Tag来调用一个Tag文件之前,必须首先使用taglib指令引入该Web服务目录下的标记库,只有这样,JSP页面才可以使用Tag标记调用相应的Tag文件。
taglib指令的格式如下:
<%@taglib tagdir="标记库的位置"prefix="前缀">
例如:
<%@taglib tagdir="WEB-INF/tags"prefix="computer"%>
taglib指令中的perfix给出的前缀由用户自定义,其好处是,通过前缀可以有效地区分不同标记库中具有相同的标记文件。
3.Tag标记的运行原理
Tomcat服务器处理JSP页面中的Tag标记原理如下:
1、如果该Tag标记对应的Tag文件是首次被JSP页面调用,那么Tomcat服务器会将Tag文件转译成一个Java文件,并编译这个Java文件生成字节码文件,然后执行这个字节码文件。
2、如果该Tag文件已经被转编译为字节码文件,Tomcat服务器将直接执行这个字节码文件。
3、如果对Tag文件进行了修改,那么Tomcat服务器会重新将Tag文件转译成一个Java文件,并编译这个Java文件生成字节码文件,然后执行这个字节码文件。
三、Tag文件中的常用指令
1、tag指令
Tag文件中tag指令类似于JSP文件中的page指令。Tag文件通过使用tag指令可以指定某些属性的值,以便从总体影响Tag文件的处理和表示。tag指令的语法如下:
<%@tag属性1=“属性值” 属性2="属性值".....属性n=" 属性值"%>
或
<%@tag属性1="属性值"%>
<%@tag属性2="属性值"%>
......
<%@tag属性n="属性值"%>
1、language属性
language属性的值指定Tag文件使用的脚本语言,目前只能取值Java,其默认值就是Java,因此在编写Tag文件时,没有必要使用tag指令language属性的值。
2、import属性
import属性的作用是为Tag文件引入包中的类,这样就可以在Tag文件的程序片部分、变量及方法定义部分、表达式部分使用包中的类。
3、pageEncoding
该属性指定Tag文件的字符编码,其默认值是ISO-8859-1。为了避免显示信息出现乱码现象,Tag文件需要将该属性值设置UTF-8。
2、include指令
在Tag文件中也有和JSP文件类似include指令标记,其使用方法和作用与JSP文件中的include指令标记类似。
3、attribute指令
Tag文件充当着可复用代码的角色,如果一个Tag文件允许使用它的Jsp页面向该Tag文件传递数据,就使得Tag文件的功能更为强大。在Tag文件中通过使用attribute指令让使用它的JSP页面向该Tag文件传递需要的数据。attribute指令格式如下:
<%@attribute name="对象名字"required="ture"|"false"type="对象的类型"%>
例如Tag文件myTag.tag中有如下attribute指令:
<%@attribute name="result"required="ture"|"false"type="java.lang.Double"%>
在下面例中,triangle.tag存放在ch\WEB-INF\tag\example2目录中,该Tag文件负责计算、显示三角形的面积。 example3.jsp页面保存在ch,使用Tag标记调用trianle.tag文件,并向triangle.tag传递三角形的长度
example3.jsp
<%@page contenType="text/html"%>
<%@ taglib tagdir="/WEB-INF/tags/example2"prefix="getTriangleArea"%>
<HTML><body bgcolor=yellow>
<p style="font-famliy:宋体;font-size:36;color:bule">
<%--使用Tag标记:--%>
<getTriangleArea:triangle sideA="15"sideB="16"sideC="20">
</p>
</body></HTML>
triangle.tag
<%@tag pageEncoding="utf-8"%>
<%@attribute name="sideA"required="ture"%>
<%@attribute name="sideB"required="ture"%>
<%@attribute name="sideC"required="ture"%>
<%! public String getArea(double a,double b,double c){
if(a+b>c&&c+b>a){
double p=(a+b+c)/2.0;
double area=Math.sqrt(p*(p-a)*(p-b)*(p-c));
String result=String.format("%.2f",area);
return "<br>三角形面积(小数点保留2位):"=result;
}
else
return("<br>"+a+","+b+","+c+"不能构成一个三角形,无法计算面积");
}%>
<% out.println("<BR>三边:"+sideA+","+sideB+","+sideC);
double a=Double.parsDeouble(sideA);
double b=Double.parseDouble(sideB);
double c=Double.parseDouble(sideC);
out.println(getArea(a,b,c));
%>
4、variable指令
1、variable指令格式:
<%@variable name-given="对象名"varible-class="对象类型"scope="有效范围"%>
variable指令中属性name-given的值就是Tag文件返回给JSP页面的对象。 下面的variable指令给出的对象的名字是time,类型为java.LocalDate,有效范围是AT_END:
<%@variable name-give="time"
variable-class="java.time.LocalDate"scope="AT_END"%>
2、对象的返回:
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的对象以及该对象的引用,例如:
jspcontext.setAttribute("time",LocalDate.now());
5、taflib指令
taglib指令格式如下:
<%@taglib tagdir="自定义标记库的位置"prefix="前缀"%>
一个Tag文件也可以使用几个taglib指令标记引入若干个标记库,例如:
<%@taglib tagdir="/WEB-INF/tags"perfix="beijing"%>
<%@taglib tagdir="/WEB-INF/tags/tagsTow"perfix="dalian"%>