目录
前言
Tag文件是一种特殊的文本文件,与JSP文件类似,可以被JSP页面动态加载调用,实现代码的复用,但用户不能通过该Tag文件所在web服务目录直接访问Tag文件。
一、Tag文件
1.Tag文件的结构
Tag文件是扩展名为.tag 的文本文件
一个Tag文件中可以有:
- HTML标记
- 指令标记
- 成员变量声明和方法定义
- Java程序片和Java表达式
示例:一个名为Sum.tag的tag文件
<%--Sum.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==1)
sum=sum+i;
}
out.println(sum);
%>
</p>
2.Tag文件的保存
Tag文件必须存放在Tomcat服务器指定目录中,且必须保存到tags目录或其下子目录中
例如此目录结构:Web服务目录\WEB-INF\tags
WEB-INF(字母大写)和tags为固定目录名称,tags下的子目录可由用户自定义;
二、Tag标记
1.Tag标记
<Tag文件的名字/>
或
<Tag文件的名字>其他内容</Tag文件的名字>
Tag标记的名字必须和Tag文件的名字一致;
某Web服务目录下的Tag文件只能由该Web服务目录中的JSP页面调用;
JSP页面必须通过Tag标记来调用Tag文件;
2.Tag标记的使用
(1) JSP页面在使用Tag标记调用Tag文件之前,必须先使用taglib指令标记引入该Web服务目录下的标记库
<%@ taglib tagdir="标记库的位置" prefix="前缀" %>
(2) 引入标记库后,JSP页面就可以使用带前缀的Tag标记调用相应Tag文件
<前缀名:tag文件名/>
冒号:的左右不要有空格
示例:将Sum.tag保存在C3\WEB-INF\tags目录中,a1.jsp使用Tag标记调用Sum.tag
<%--a1.jsp文件--%>
<%@ page contentType = "text/html" %>
<%@ page pageEncoding = "utf-8" %>
<%@ taglib tagdir = "/WEB-INF/tags" prefix = "computer"%>
<HTML><body bgcolor =white>
<h1>调用Tag文件计算100内奇数和:</h1>
<computer:Sum /> <%-- 使用Tag标记 --%>
</body></HTML>
运行结果:
3.Tag标记的运行原理
Tag文件首次被调用
Tag文件非首次调用
Tag文件被修改
三、Tag文件中的常用指令
1.tag指令
Tag文件可以使用tag指令指定某些属性的值,一个Tag文件中可以使用多个tag指令。
(1)language属性
指定Tag文件使用的脚本语言,默认值为Java
(2) import属性
为Tag文件引入包中的类
示例:
<%@ tag import="java.util.Iterator" %>
(3)pageEncoding属性
指定Tag文件的字符编码,默认值为ISO-8859-1,为避免乱码,需设置为UTF-8
示例:
<%@ tag pageEncoding="utf-8" %>
2.taglib指令
<%@ taglib tagdir="标记库的位置" prefix="前缀" %>
JSP页面或Tag文件都可以使用taglib指令引入标记库
示例:
<%@ taglib tagdir="/WEB-INF/tags" prefix="computer" %>
3.include指令
<%@ include file="文件的URL"%>
Tag文件中的include指令标记,可以在Tag文件中整体嵌入一个文件,其用法与JSP文件的include指令标记类似(JSP语法-5.2-include指令标记)
示例:Tag文件使用include指令标记实现代码复用
<%-- a2.jsp文件,需要复用的Java代码 --%>
<%
String message = "Hello, World!";
%>
<%--名为my.tag的文件--%>
<%@ tag pageEncoding="utf-8" %>
<%@ include file="a2.jsp" %>
my.tag 文件调用a2:
<br><%= message %><br>
<%--名为my2.tag的文件--%>
<%@ tag pageEncoding="utf-8" %>
<%@ include file="a2.jsp" %>
my2.tag 文件调用a2:
<br><%= message %>
<%--名为a3.jsp的文件,调用my.tag,my2.tag--%>
<%@ page contentType = "text/html" %>
<%@ page pageEncoding = "utf-8" %>
<%@ taglib tagdir = "/WEB-INF/tags" prefix = "word2"%>
<%@ taglib tagdir = "/WEB-INF/tags" prefix = "word"%>
<HTML><body bgcolor =white>
<h1>显示字符:</h1>
<word:my />
<br>
<word2:my2 />
</body></HTML>
执行结果:
4.attribute指令
- Tag文件作为可复用代码,在Tag文件中使用attribute指令,使得调用它的jsp文件动态地向其传递数据:
<%@ attribute name="对象名字" required="ture|false" type="对象类型"%>
type属性在指定对象时必须使用包名,默认值为java.lang.String;
required属性为可选,如果省略,则默认值为false;
Tag文件中不可再定义和name属性给出对象具有相同名字的变量,否则name无效;
示例:
<%@ attribute name="result" required="ture" type="java.lang.Double"%>
- JSP页面使用Tag标记,向所调用的Tag文件中name指定的对象传递一个引用:
<前缀:Tag文件名 对象名="对象的引用"/>
示例:Tag标记后缀为computer,调用my.tag
<computer:my result="new Double(3.141)">
示例:JSP页面使用Tag标记调用Tag文件计算矩形面积
<%--名为rectangle.tag文件--%>
<%@ tag pageEncoding="utf-8" %>
<%@ attribute name="sideA" required="true" %>
<%@ attribute name="sideB" required="true" %>
<%! public String getArea(double a,double b) {
double area=a*b ;
return "<br>矩形的面积:"+area;
}
%>
<% out.println("<BR>两边:"+sideA+","+sideB+"");
double a=Double.parseDouble(sideA);
double b=Double.parseDouble(sideB);
out.println(getArea(a,b));
%>
<%--名为a4.jsp的文件,调用rectangle.tag--%>
<%@ page contentType="text/html" %>
<%@ page pageEncoding = "utf-8" %>
<%@ taglib tagdir="/WEB-INF/tags/example2" prefix="Area"%>
<HTML><body bgcolor = white >
<p style="font-family:宋体;font-size:36;color:black">
<%-- 使用Tag标记: --%>
<Area:rectangle sideA="15" sideB="16"/>
</p>
</body></HTML>
执行结果:
5.variable指令
Tag文件可使用variable指令,将Tag文件中的对象返回给调用该Tag文件的JSP页面,同时Tag文件只有将返回对象的名字及引用存储到Tomcat服务器提供的内置对象jspContext中,才能使JSP页面使用该对象
(1)使用variable指令返回对象
<%@ variable name-given="对象名" variable-class="对象类型" scope="有效范围"%>
示例:
<%@ variable name-given="time" variable-class="java.time.LocalDate" scope="AT_END"%>
scope属性的值指定对象的有效范围,可取 AT_BEGIN、NESTED、AT_END;
(2)存储返回对象的名字及引用
setAttribute("对象名",对象的引用)
存储返回对象的名字及引用需要jspContext调用setAttribute()方法
示例:返回名为time的LocalDate对象
jspContext.setAttribute("time",LocalDate.now())
示例:JSP页面向Tag文件传递数据,并且将数据处理后返回JSP页面
<%--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文件--%>
<%@ page contentType="text/html" %>
<%@ page pageEncoding = "utf-8" %>
<%@ taglib tagdir="/WEB-INF/tags/example4" prefix="getPrice" %>
<HTML><body bgcolor = white>
<% String str = "麻辣豆腐:20.6元,红烧肉:68.9元,烤鸭:199元";
%>
<getPrice:handleData mess="<%= str %>"/> <%-- 使用Tag标记 --%>
<p style="font-family:宋体;font-size:22">
菜单:<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:22;color:black">
购物小票:<br>"<%= str %>"<br>价格总和:
<%= price %>
</p>
</body></HTML>
执行结果: