第3章 Tag文件与Tag标记

最新推荐文章于 2024-06-09 16:06:06 发布

weixin_45757262

最新推荐文章于 2024-06-09 16:06:06 发布

阅读量186

点赞数

文章标签： java

本文链接：https://blog.csdn.net/weixin_45757262/article/details/130493544

版权

3.1 Tag文件

Tag文件和JSP文件很类似，可以被JSP页面动态加载调用，实现代码的复用(但用户不能通过该Tag文件所在Web服务目录直接访问Tag文件)。
本章在webapps目录下新建一个Web服务目录ch3，除非特别约定，例子中的JSP页面均保存在ch3目录中。

3.1.1 Tag文件的结构

Tag文件是扩展名为. tag的文本文件，其结构和JSP文件类似。一个Tag文件中可以有普通的HTML标记符、某些特殊的指令标记(见3.4节)、成员变量声明和方法的定义、Java程序片和Java表达式。以下是一个简单的Tag文件oddNumberSum. tag,负责计算100内的全部奇数的代数和。


<%@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.2 Tag文件的保存

❶Tag文件所在目录

为了能让一个Web应用中的JSP页面使用某一个Tag文件，必须把这个Tag文件存放到Tomcat服务器指定的目录中，也就是说，如果某个Web服务目录下的JSP页面准备调用一个Tag文件，那么必须在该Web服务目录下，建立如下的目录结构：
Web服务目录\WEB-INF\tags
例如：

ch3\WEB-INF\tags

❷Tag文件的编码

保存Tag文件时按照Tag文件指定的编码保存，例如Tag文件使用tag指令

<%@tag pageEncoding="utf-8"%>

指定的编码是UTF-8，因此需要按照UTF-8编码保存Tag文件。例如，用文本编辑器“记事本”编辑Tag文件，在保存该Tag文件时，将“保存类型(T)”选择为“所有文件(*.*)”，将“编码(E)”选择为“UTF-8”。

3.2 Tag标记

3.2.1 Tag标记与Tag文件

Tag标记的名字和Tag文件的名字一致，也就是说，当我们编写了一个Tag文件并保存到特定目录中后(见3.1.2节)，也就给出了一个Tag标记，该标记的格式为：

<Tag文件的名字/>

或者

<Tag文件的名字>其他内容(称为标体内容)</Tag文件的名字>

3.2.2 Tag标记的使用

一个JSP页面通过使用Tag标记来调用一个Tag文件。Web服务目录下的一个JSP页面在使用Tag标记来调用一个Tag文件之前，必须首先使用taglib指令标记引入该Web服务目录下的标记库，只有这样，JSP页面才可以使用Tag标记调用相应的Tag文件。

taglib指令的格式如下:

<%@taglib tagdir="标记库的位置"prefix="前缀">

例如

<%@taglib tagdir="/WEB-INF/tags"prefix="computer"%>

例3 1中的JSP页面使用 Tag 标记调用oddNumberSum. tag(该 Tag 文件见3.1.1节)计算100之内的奇数和。

<%@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>

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文件中的常用指令

3.3.1 tag指令

Tag文件中的tag指令类似于JSP文件中的page指令。Tag文件通过使用tag指令可以指定某些属性的值，以便从总体上影响Tag文件的处理和表示。tag指令的语法如下：

<%@tag属性1="属性值"属性2="属性值"--属性n="属性值"%>

　在一个Tag文件中可以使用多个tag指令，因此我们经常使用多个tag指令为属性指定需要的值：

<%@tag属性1=“属性值”%>
<%@tag属性2="属性值"%>
<%@tag属性n="属性值"%>

❶language属性

　　language属性的值指定Tag文件使用的脚本语言，目前只能取值Java，其默认值就是Java,因此在编写Tag文件时,没有必要使用tag指令指定language 属性的值。

❷import属性

　　import属性的作用是为Tag文件引入包中的类，这样就可以在Tag文件的程序片部分、变量及方法定义部分、表达式部分使用包中的类。import属性可以取多个值， import属性默认已经有如下值:"java. lang.*""javax. servlet.*""javax. servlet. jsp.*" "javax.servlet.http.*"。

❸pagcEncoding

　　该属性指定Tag文件的字符编码，其默认值是ISO-8859-1。目前，为了避免显示信息出现乱码现象， Tag文件需要将该属性值设置为UTF-8。

3.3.2 include指令

在Tag文件中也有和JSP文件类似的include指令标记，其使用方法和作用与JSP文件中的include指令标记类似。

3.3.3 attribute指令

在Tag文件中通过使用attribute指令让使用它的JSP页面向该Tag文件传递需要的数据。attribute指令的格式如下：

<%@attribute name="对象名字" required="true"|"false"type="> 对象的类型"%>

例如Tag文件myTag. tag中有如下attribute指令:

<%@attribute name ="result"required="true"type="java.lang.Double"%>

在下面的例3_2中, triangle. tag 存放在ch3\WEB-INF\ tags\example2目录中,该 Tag 文件负责计算、显示三角形的面积。example3_2. jsp 页面保存在ch3中,使用 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+″,″+ \underbrace +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指令

许多JSP页面可能都需要调用某个Tag文件对某些数据进行基本的处理，但不希望Tag文件做进一步的特殊处理以及显示数据，因为各个JSP页面对数据的进一步处理或显示格式的要求是不同的。因此，JSP页面希望Tag文件将数据的基本处理结果存放在某些对象中，将这些对象返回给当前JSP页面即可。

Tag文件通过使用variable指令可以将Tag文件中的对象返回给调用该Tag文件的JSP页面。

❶variable指令的格式

<%@variable name-given="对象名"variable-class="对象类型"scope="有效范围"%>

下面的variable指令给出的对象的名字是time,类型为java. time. LocalDate,有效范围是AT_END:

<%@variable name-given="time"
variable- class=" java. time.LocalDate" scope="AT_END"%>

❷对象的返回

　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());

下面的例3_4中,JSP页面example3_4. jsp 将 String 对象交给 Tag 文件handleData. tag,handleData. tag解析出String对象的字符序列中的全部数字，并计算出数字总和，将数字总和放在 Double 对象 price 中,然后返回给JSP页面example3_4. jsp 。example3_4. jsp 输出 price对象中的数字总和。handleData. tag. tag存放在ch3\WEB-INF\tags\example4目录中,example3_4. jsp 保存在ch3目录中。

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中,用名字price返回给JSP页面jspContext. setAttribute("price",getPriceSum(mess));
%>

3.3.5 taglib指令

JSP页面或Tag文件都可以使用taglib指令引入标记库(如前面各个例子所示)。taglib 指令格式如下：

<%@taglib tagdir="自定义标记库的位置"prefix="前缀">

一个Tag文件也可以使用几个taglib指令标记引入若干个标记库，例如：

<%@taglib tagdir="/WE3-IM/taga"prefix="beijing"*>
<%@taglib tagdir=*/WB-(10 )'tags/tags/big/ﺮﻓfix="dalian'b>

weixin_45757262

关注

0
点赞
踩
1

收藏

觉得还不错? 一键收藏
1
评论
第3章 Tag文件与Tag标记

Tag文件和JSP文件很类似，可以被JSP页面动态加载调用，实现代码的复用(但用户不能通过该Tag文件所在Web服务目录直接访问Tag文件)。本章在webapps目录下新建一个Web服务目录ch3，除非特别约定，例子中的JSP页面均保存在ch3目录中。
复制链接

扫一扫