java web 开发——第三章Tag文件与Tag标记

m0_68753530

已于 2023-05-27 18:04:53 修改

阅读量352

点赞数

文章标签：开发语言 javascript java

于 2023-04-30 00:00:00 首次发布

本文链接：https://blog.csdn.net/m0_68753530/article/details/130372212

版权

系列文章目录

第三章 Tag文件与Tag标记

主要内容学习一种特殊的文本文件:Tag文件。Tag文件和JSP文件很类似，可以被JSP页面动态加载调用，实现代码的复用(但用户不能通过该Tag文件所在Web服务目录直接访问本Tag文件)

文章目录

3.1 Tag文件
3.1.1 Tag文件的结构
3.1.2 Tag文件的保存
3.2 Tag标记
3.2.1 Tag标记与Tag文件
3.2.2 Tag标记的使用
3.2.3 Tag标记的运行原理
3.3 Tag文件中常用指令
3.3.1 tag指令
3.3.2 include指令
3.3.3 attribute指令
3.3.4 variable指令
3.3.5 taglib指令
总结

3.1 Tag文件

3.1.1 Tag文件的结构

Tag文件是扩展名为。tag的文本文件，其结构和JSP文件类似。一个Tag文件中可以有普通的HTML标记符，某些特殊的指令标记，成员变量，和方法的定义，java程序片和java表达式。

例3_1:以下是一个简单的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文件的保存

1.Tag文件所在的目录
Tag文件可以实现代码的复用,即Tag文件可以被许多JSP 页面使用。发了能让一个Web应用中的JSP 页面使用某一个Tag文件，必须把这个Tag文件在放到Tomcat服务器推定的目录中，也就是说，如果某个Web服务目录下的JSP页面准备调用一个Tag文件,那么必须在该Web服务目录下，建立如下的且录结构：
Web 服务目录\WEB- INF\tags
例如:
ch3\WEB- INF\tags
其中的WEB-INF(字母大写)和tags都是固定的目录名称，而tags下的子目录的名称可由用户给定。
一个Tag文件必须保存到tags目录或其下的子目录中。这里把上述例子中的oddNumberSum. tag 保存到ch3WEB-INF\tags 目录中。
2.Tag文件的编码

保存Tag文件时按照Tag文件指定的编码保存，例如Tag文件使用tag指令（见稍后的3.4节）：

<%@ tag pageEncoding="utf-8"%>指定的编码是UTF-8，因此需要按照UTF-8编码保存Tag文件。

3.2 Tag标记与Tag文件

3.2.1 Tag标记与Tag文件

某个Web,服务目录下的Tag文件只能由该Web服务目录中的JSP页面调用、JSP页面必须通过Tag标记来调用一个Tag文件。
Tag标记的名字和Tag文件的名字一致，也就是说，当我们编写了一个 Tag 文件并保存到特定目录中后(见3.1.2节)也就给出了一个Tag标记，该标记的格式为:
<Tag文件的名字/
或
<Tag文件的名字>其他内容(称为标体内容)</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"%>

引入标记库后，JSP页面就可以使用带前缀的Tag标记调用相应的Tag文件，其中的前缀由<taglib>指令中的prefix属性指定。例如JSP如下使用Tag标记调用相应的Tag文件：

<computer:oddNumberSum/>

taglib指令中的prefix给出的前缀由用户自定义，其好处是，通过前缀可以有效的区分不同标记库具有相同名字的标记文件。

注：JSP页面使用Tag标记时，冒号的左右不能有空格。

例3_1中的JSP页面使用Tag标记调用oddNumberSum.tag(该Tag 文件见3.3.3节计算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标记的原理如下:
1.如果该Tag标记对应的Tag文件是首次被JSP 页面调用,那么 Tomcat服务器会将Tag文件转译成一个Java文件,并编译这个Java文件生成字节码文件,然后执行这个字节码文件(这和执行JSP 页面的原理类似)。
2.如果该Tag文件已经被转编译为字节码文件,Tomcat 服务器将直接执行这个字节码文件。
3.如果对Tag文件进行了修改,那么Tomcat服务器会重新将Tag文件转译成一个Java 文件，并编译这个Java文件生成字节码文件,然后执行这个字节码文件。

3.3Tag文件中的常用指令

与JSP文件类似,Tag文件中也有一些常用指令，这些指令将影响Tag文件的行为。Tag 文件中经常使用的指令有tag、 taglib,include, attribute, variable。

3.3.1 tag指令

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

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

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

在一个Tag文件中可以使用多个tag指令，因此我们经常使用多个tag指令为属性指#
需要的值:
<%@ tag属性1=“属性值”%>

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

......
<%@tag属性n=“属性值”%>
1.language属性
language 属性的值指定Tag文件使用的脚本语言,目前只能取值Java,其默认值就是Java.因此在编写Tag文件时，没有必要使用tag指令指定language属性的值。
2.import 属性
import 属性的作用是为Tag文件引人包中的类，这样就可以在 Tag文件的程序片部分、变量及方法定义部分、表达式部分使用包中的类。import属性可以取多个值,import 属性默认已经有如下值: "java. lang. *" "javax. servlet.*” "javax. servlet.jsp.*" "javax.servlet.http.*"
3.pageEncoding
该属性指定Tag文件的字符编码，其默认但ISO-8859-1.目前，为了避免显示信息出现乱码现象,Tag文件需要将该属性值设置为UTF-8

3.3.2 include 指令

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

3.3.3 attribue指令

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

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

attribute 指令中的name属性是必须的，该属性的值是一个对象的名字。JSP 页面在调用Tag文件时,可向name属性指定的对象传递一个引用。需要特别注意的是,type在指定对象类型时,必须使用包名，比如，不可以将iava. lang. Double简写为Double。如果attribute 指令中没有使用type指定对象的类型，那对象的类型默认是java. lang. String类型。
JSP页面使用Tag标记向所调用的Tag文件中name指定的对象传递一个引用，方式如下:
<前缀:Tag文件名字对象名字=”对象的引用”/>
attribute 指令中的required 属性也是可选的,如果省略required属性,那么required 的默认值是false。当指定required的值是true时,调用该Tag文件的JSP页面必须向该Tag文件中attribute 指令中的 name 属性给出的对象传递一个引用，当指定required的值是false 时,调用该Tag文件的JSP 可以向该Tag文件中attribute指令中的name属性给出的对象传递或不传递对象的引用。
注:在Tag文件中不可以再定义和attribute指令中的 name属性给出的对象具有相同名字的变量,否则将隐藏attribute指令中给出的对象，使其失效。
在下面的例3_2中,triangle. tag 存放在ch3\ WEB-INF\tags\example2 目录中，该Tag文件负责计算、显示三角形的面积。 example3_2.jsp 页面保存在ch3中,使用Tag标记调用triangle. tag 文件,并且向 triangle. tag传递三角形三边的长度。
example3_2. jsp(效果如图3.2所示)

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

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

1.variable指令的格式

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

variable 指令中属性name-given 的值就是Tag文件返回给JSP页面的对象。该对象的名字必须符合标识符规定,即名字可以由字母、下画线、美元符号和数字组成，并且第一个字符不能是数字字符。variable 指令中属性 variable-class的值是返回的对象的类型,对象的类型必须带有包名,比如java. lang. Double,java.t ime. LocalDate等类型。如果 variable 指令中没有使用 variable-class给出对象的类型，那么对象的类型是java. lang. String类型。
variable指令中scope属性的值指定对象的有效范围,scope的值可以取AT_BEGIN NESTED和AT_END。当scope的值是AT._BEGIN 时,JSP 页面一旦开始使用Tag标记，就得到了variable 指令返回给JSP 页面的对象,JSP 页面就可以在Tag标记的标记体中或Tag 标记结束后的各个部分中使用 variable指令返回给JSP 页面的对象。当scope 的值是NESTED 时,JSP 页面只可以在Tag标记的标记体中使用variable 指令返回给JSP页面的对象。当scope的值是AT_END时,JSP 页面只可以在Tag标记结束后。才可以使用 variable 指令返回给JSP 页面的对象。
下面的variable 指令给出的对象的名字是time,类型为java. time. LocalDate,有效范围是AT_END:
<%@ variable name- given ="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.LocaDate" scope="AT_END"%>

为JSP页面返回名字是time的LocalDate 对象。那么Tag文件中必须让 jspContext 调用

setAttribute("对象名",对象的引用);
方法存储名字是time的对象以及该对象的引用,例如:

jspContext.setAttribute("time",LocalDate.now());
将名字是time的LocalDate对象存储到jspContext 中。

下面的例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目录中。

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

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

3.3.5 taglib 指令

JSP页面或Tag文件都可以使用taglib 指令引人标记库(如前面各个例子所示)。指令格式如下:
<%@ taglib tagdir="自定义标记库的位置” prefix="前缀”>

一个Tag文件也可以使用几个taglib指令标记引入若干个标记库,例如：
<%@ taglib tagdir= “/WEB- INF/tags" prefix="beijing"%>

<%@ taglib tagdir ="/WEB-INE/tags/tagsTwo" prefix="dalian"%>

总结：

主要内容学习一种特殊的文本文件:Tag文件。Tag文件和JSP文件很类似，可以被JSP页面动态加载调用，实现代码的复用(但用户不能通过该Tag文件所在Web服务目录直接访问本Tag文件)。

m0_68753530

关注

0
点赞
踩
1

收藏

觉得还不错? 一键收藏
1
评论
java web 开发——第三章Tag文件与Tag标记

主要内容学习一种特殊的文本文件:Tag文件。Tag文件和JSP文件很类似，可以被JSP页面动态加载调用，实现代码的复用(但用户不能通过该Tag文件所在Web服务目录直接访问本Tag文件)。
复制链接

扫一扫