devbox
羊村懒王
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

java web 开发——第三章Tag文件与Tag标记_java 后端工程tag

作者：羊村懒王 | 2024-05-30 16:04:15

赞

踩

java 后端工程tag

系列文章目录

第三章 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之内的全部奇数的代数和。

  1. <%@ tag pageEncoding="utf-8" %>
  2. <p style="font-family:宋体;font-size:36">
  3. 1～100内的奇数之和：
  4. <%  int sum=0,i=1;
  5.          for(i=1;i<=100;i++){
  6.             if(i%2==1)
  7.                sum=sum+i;
  8.         }
  9.         out.println(sum);
  10. %> 
  11. </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之内的奇数和。)

  1. <%@ page contentType = "text/html" %>  
  2. <%@ page pageEncoding = "utf-8" %> 
  3. <%@ taglib tagdir = "/WEB-INF/tags" prefix = "computer"%>
  4. <HTML><body bgcolor = cyan>
  5. <h1>调用Tag文件计算100内奇数和：</h1>
  6. <computer:oddNumberSum /> <%-- 使用Tag标记 --%>
  7. </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所示)

  1. <%@ page contentType="text/html" %>
  2. <%@ page pageEncoding = "utf-8" %> 
  3. <%@ taglib tagdir="/WEB-INF/tags/example2" prefix="getTriangleArea"%>
  4. <HTML><body bgcolor = yellow >
  5. <p style="font-family:宋体;font-size:36;color:blue">
  6. <%-- 使用Tag标记： --%>
  7. <getTriangleArea:triangle sideA="15" sideB="16" sideC="20"/>
  8. </p>
  9. </body></HTML>
  10.

triangle.tag

  1. <%@ tag pageEncoding="utf-8" %>
  2. <%@ attribute name="sideA" required="true" %>
  3. <%@ attribute name="sideB" required="true" %>
  4. <%@ attribute name="sideC" required="true" %>
  5. <%! public String getArea(double a,double b,double c) {
  6.        if(a+b>c&&a+c>b&&c+b>a) {
  7.            double p=(a+b+c)/2.0;
  8.            double area=Math.sqrt(p*(p-a)*(p-b)*(p-c)) ;
  9.            String result = String.format("%.2f",area);
  10.            return "<br>三角形面积(小数点保留2位):"+result;
  11.         }
  12.         else
  13.            return("<br>"+a+","+b+","+c+"不能构成一个三角形,无法计算面积");
  14.         }
  15. %>
  16. <%  out.println("<BR>三边："+sideA+","+sideB+","+sideC);
  17.     double a=Double.parseDouble(sideA);
  18.     double b=Double.parseDouble(sideB);
  19.     double c=Double.parseDouble(sideC);
  20.     out.println(getArea(a,b,c));
  21. %>
  22.

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目录中。

  1. <%@ page contentType="text/html" %>
  2. <%@ page pageEncoding = "utf-8" %> 
  3. <%@ taglib tagdir="/WEB-INF/tags/example4" prefix="getPrice" %>
  4. <HTML><body bgcolor = #FFCCFF>
  5. <% String str = "麻辣豆腐:20.6元,红烧肉:68.9元,烤鸭:199元";
  6. %>
  7. <getPrice:handleData mess="<%= str %>"/>  <%-- 使用Tag标记 --%>
  8. <p style="font-family:宋体;font-size:36">
  9.  菜单：<br>"<%= str %>"<br>价格总和：
  10. <%= price %>         <%-- 使用Tag标记返回的Double对象price --%>
  11. </p>
  12. <% str = "毛巾:2.6元,香皂:6.9元,牙刷:12.3元";
  13. %>
  14. <getPrice:handleData mess="<%= str %>"/>  
  15. <p style="font-family:黑体;font-size:36;color:blue">
  16. 购物小票：<br>"<%= str %>"<br>价格总和：
  17. <%= price %>              
  18. </p>
  19. </body></HTML>
  1. <%@ attribute name="mess" required="true" type="java.lang.String" %>
  2. <%@ tag import="java.util.regex.Pattern" %>
  3. <%@ tag import="java.util.regex.Matcher" %>
  4. <%@ variable name-given="price" variable-class="java.lang.Double"
  5.     scope="AT_BEGIN" %>
  6. <%!  
  7. public Double getPriceSum(String input){  // 定义方法
  8.     Pattern pattern;          //模式对象
  9.     Matcher matcher;          //匹配对象
  10.     String regex="-?[0-9][0-9]*[.]?[0-9]*" ;//匹配数字,整数或浮点数的正则表达式
  11.     pattern = Pattern.compile(regex);       //初试化模式对象
  12.     matcher = pattern.matcher(input);       //初始化匹配对象,用于检索input
  13.     double sum = 0;
  14.     while(matcher.find()) {
  15.        String str = matcher.group(); 
  16.        sum += Double.parseDouble(str);
  17.     } 
  18.     return new Double(sum);
  19. }
  20. %>
  21. <% //将返回的Double对象放在jspContext中:
  22.    jspContext.setAttribute("price",getPriceSum(mess));
  23. %>

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文件)。

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/羊村懒王/article/detail/647672
推荐阅读
相关标签

Copyright © 2003-2013 www.wpsshop.cn 版权所有，并保留所有权利。

  

闽ICP备14008679号