目录
前言
本章我们将学习一种特殊的文本文件:Tag文件。Tag文件和JSP文件类似,可以被JSP页面动态加载调用,实现代码的复用(但用户不能通过该Tag文件所在的Web服务目录直接访问Tag文件)
3.1 Tag文件
3.1.1 Tag文件的结构
Tag文件的扩展名为.tag的文本文件,建构与JSP文件类似。因此Tag文件含有HTML标记、某些特殊的指令标记、成员变量的声明和方法的定义、Java程序片和表达式。下面是一个简单的Tag文件
<%@ tag pageEncoding="utf-8" %> //HTML标记
<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);
%> //Java程序片
</p>
3.1.2 Tag文件的保存
①tag文件所在目录
JSP页面如果要使用Tag文件,必须把Tag文件存放到Tomcat服务器指定的目录中。如:
Web服务目录/WEB-INF/tags
其中WEB-INF和tags都是指定目录不能修改,tags下的子目录则可以由用户给定。Tag文件必须保存到tags目录或其下的子目录中。
②Tag文件的编码
保存Tag文件时按照Tag文件指定的编码保存。如:
<%@ tag pageEncoding="utf-8"%>
指定的编码是UTF-8,因此需要按照UTF-8编码保存Tag文件。
3.2 Tag标记
3.2.1 Tag标记与Tag文件。
某个Web服务目录下的Tag文件只能由该Web服务目录中的JSP页面调用,JSP页面必须通过Tag标记来调用一个Tag文件。Tag标记的名字与Tag文件的名字一致,Tag标记的格式为:
<Tag文件的名字/>
或
<Tag文件的名字> 其他内容(称为标体内容)</Tag文件的名字>
一个Tag文件对应着一个Tag标记,把全体Tag标记称为一个自定义标记库或标记库。
3.2.2 Tag标记的使用
JSP页面调用Tag文件之前,必须使用taglib指令标记引入该Web服务目录下的标记库。taglib指令的格式如下:
<%@ taglib tagdir="标记库的位置" prefix="前缀"%>
taglib指令中的prefix给出的前缀由用户自定义,好处是通过前缀可以有效地区分不同标记库中具有相同名字的标记文件。(注意:JSP页面使用Tag标记时,冒号:的左右不要有空格,否则会报错。)
3.2.3 Tag标记的运行原理
Tomcat服务器处理JSP页面中的Tag标记的原理如下:
●如果该Tag标记对应的Tag文件是首次被JSP页面调用,那么Tomcat服务器会将Tag文件转译成一个Java文件,并编译这个Java文件生成字节码文件,然后执行这个字节码文件(这和执行JSP页面的原理类似)。
●如果该Tag文件已经被转编译为字节码文件,Tomcat服务器将直接执行这个字节码文件。
如果对Tag文件进行了修改,那么Tomcat服务器会重新将Tag文件转译成一个 Java文件,并编译这个Java文件生成字节码文件,然后执行这个字节码文件。
3.3 Tag文件中的常用指令
Tag文件中有一些常用指令,这些指令将影响Tag文件的运行。经常使用的指令有:tag、taglib、include、 attribute、variable。
3.3.1 tag指令
Tag文件中的tag指令类似与JSP文件中的page指令。 Tag文件可以通过tag指令指定某些属性的值。tag指令的语法如下:
<%@ tag属性1="属性值" 属性2="属性值" ... 属性n="属性值" %>
在一个Tag文件中可以使用多个tag指令,因此我们经常使用多个tag指令为属性指定需要的值:
<%@ tag 属性1="属性值"%>
<%@ tag 属性2="属性值"%>
……
<%@ tag 属性n="属性值"%>
① language属性
language属性 。只能取值java,其默认值就是java,没有必要使用tag指令指定language属性的值。
② import属性。
import属性的作用是为Tag文件引入包中的类import属性默认已经有如下值:"java.lang.*"、 "javax.servlet.*"、"javax.servlet.jsp.*"、"javax.servlet.http.*"。
③ pageEncoding属性。
该属性指定Tag文件的字符编码,其默认值是ISO-8859-1。目前,为了避免显示信息出现乱码现象,Tag文件需要将该属性值设置为utf-8。
3.3.2 include指令
Tag文件中也有和JSP文件类似的include指令标记,其使用方法和作用与JSP文件中的include指令标记类似。
3.3.3 attribute指令
一个Tag文件允许使用它的JSP页面向该Tag文件传递数据。在Tag文件中通过使用attribute指令让使用它的JSP页面向该Tag文件传递需要的数据。例:
<%@ attribute name="对象名字" required="true"|"false" type="对象的类型"%>
下列例子使用Tag标记调用triangle.tag文件,并且向 triangle.tag传递三角形三边的长度。
example3_2.jsp
<%@ page contentType="text/html" %>
<%@ page pageEncoding = "utf-8" %>
<%@ taglib tagdir="/WEB-INF/tags/example2" prefix="getTriangleArea"%>
<HTML><body bgcolor = yellow >
<p style="font-family:宋体;font-size:36;color:blue">
<%-- 使用Tag标记: --%>
<getTriangleArea:triangle sideA="15" sideB="16" sideC="20"/>
</p>
</body></HTML>
triangle.tag
<%@ tag pageEncoding="utf-8" %>
<%@ attribute name="sideA" required="true" %>
<%@ attribute name="sideB" required="true" %>
<%@ attribute name="sideC" required="true" %>
<%! public String getArea(double a,double b,double c) {
if(a+b>c&&a+c>b&&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.parseDouble(sideA);
double b=Double.parseDouble(sideB);
double c=Double.parseDouble(sideC);
out.println(getArea(a,b,c));
%>
结果:
3.3.4 variable指令
① variable 指令的格式
Tag文件通过使用variable指令可以将Tag文件中的对象返回给调用该Tag文件的JSP页面。 如:
<%@ variable name-given="对象" variable-class="对象的类型" scope="有效范围"%>
scope的值可以取:AT_BEGIN、NESTED和AT_END。
②对象的返回
Tag文件为了给JSP页面返回一个对象,就必须将返回的对象的名字以及该对象的引用存储到Tomcat服务器提供的内置对象jspContext中。
jspContext.setAttribute("对象的名字",对象的引用)
例子3_4中,JSP页面example3_4.jsp将String对象交给Tag文件handleData.tag,handleData.tag解析出String对象的字符序列中的全部数字,并计算出数字总和,将数字总和放在Double对象price中然后返回给JSP页面
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元,烤鸭:199元";
%>
<getPrice:handleData mess="<%= str %>"/> <%-- 使用Tag标记 --%>
<p style="font-family:宋体;font-size:36">
菜单:<br>"<%= str %>"<br>价格总和:
<%= price %> <%-- 使用Tag标记返回的Double对象price --%>
</p>
<% str = "毛巾:2.6元,香皂:6.9元,牙刷:12.3元";
%>
<getPrice:handleData mess="<%= str %>"/>
<p style="font-family:黑体;font-size:36;color:blue">
购物小票:<br>"<%= str %>"<br>价格总和:
<%= price %>
</p>
</body></HTML>
handleData.tag
<%@ attribute name="mess" required="true" type="java.lang.String" %>
<%@ tag import="java.util.regex.Pattern" %>
<%@ tag import="java.util.regex.Matcher" %>
<%@ variable name-given="price" variable-class="java.lang.Double"
scope="AT_BEGIN" %>
<%!
public Double getPriceSum(String input){ // 定义方法
Pattern pattern; //模式对象
Matcher matcher; //匹配对象
String regex="-?[0-9][0-9]*[.]?[0-9]*" ;//匹配数字,整数或浮点数的正则表达式
pattern = Pattern.compile(regex); //初试化模式对象
matcher = pattern.matcher(input); //初始化匹配对象,用于检索input
double sum = 0;
while(matcher.find()) {
String str = matcher.group();
sum += Double.parseDouble(str);
}
return new Double(sum);
}
%>
<% //将返回的Double对象放在jspContext中:
jspContext.setAttribute("price",getPriceSum(mess));
%>
结果:
注意:在JSP页面中不可以再定义与Tag文件返回的对象具有相同名字的变量,否则Tag文件无法将variable指令给出的对象返回给JSP页面(并将出现编译错误)。如果Tag文件同时使用variable指令和attribute指令,那么variable指令中的name-given和attribute指令中的name给出的对象不能相同(否则将出现编译错误)。
3.3.5 taglib指令
JSP页面或Tag文件都可以使用taglib指令使用标记库
<%@ taglib tagdir="自定义标记库的位置" prefix="前缀">
一个Tag文件也可以使用几个taglib指令标记引入若干个标记库,例如:
<%@ taglib tagdir="/WEB-INF/tags" prefix="beijing"%>
<%@ taglib tagdir="/WEB-INF/tags/tagsTwo" prefix="dalian"%
总结
以上就是第三章——Tag文件与Tag标记的所有内容,通过对Tag文件的结构、Tag标记以及Tag文件中的常用指令的学习,重点解决了Tag文件中的attribute指令和Tag文件中variable指令这两大难点,对Tag文件和Tag标记的使用更加熟练。