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

最新推荐文章于 2024-05-03 11:52:51 发布

JUST WE0426

最新推荐文章于 2024-05-03 11:52:51 发布

阅读量600

点赞数

文章标签： java 前端 servlet

本文链接：https://blog.csdn.net/woaizj0426/article/details/130448656

版权

文章目录

前言
3.1、Tag文件
- 3.1.1、Tag文件的结构
- 3.1.2、Tag文件的保存
3.2、Tag标记
3.3、Tag文件中的常用指令
总结

前言

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

3.1、Tag文件

3.1.1、Tag文件的结构

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

3.1.2、Tag文件的保存

★Tag文件所在目录
如果某个Web服务目录下的JSP页面准备调用一个Tag文件，那么必须在该Web服务目录下，建立如下目录结构：

Web服务目录 \ WEB-INF \ tags
如:
ch3 \ WEB-INF \ tags

其中WEB-INF（必须大写）和tags是固定目录名称。Tag文件必须保存到tags目录或其下的子目录中。

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

<%@ tag pageEncoding = “utf-8” %>

所以保存文件时要用UTF-8编码保存。

3.2、Tag标记

3.2.1、Tag标记与Tag文件

某个Web服务目录下的Tag文件只能由该Web服务目录中的JSP页面调用，JSP页面必须通过Tag标记来调用一个Tag文件。Tag标记的名字和Tag文件的名字一致。标记格式为：

< Tag文件的名字 />
或
< Tag文件的名字 > 其他内容（称为标体内容）</Tag文件的名字>

一个Tag文件对应着一个Tag标记，把全体Tag标记称为一个自定义标记库或简称为标记库。

3.2.2、Tag标记的使用

JSP页面通过使用Tag标记来调用一个Tag文件。调用之前，必须使用taglib指令标记引入该Web服务目录下的标记库。格式如下：

<%@ taglib tagdir = “标记库的位置” prefix = “前缀”>
例如：
<%@ taglib tagdir = “/WEB-INF/tags” prefix = “computer” %>

引入标记库后，JSP页面就可以使用带前缀（由prefix属性指定）的Tag标记调用相应的Tag文件。如：

< computer:oddNumberSum />
注：冒号：左右不要有空格。

例：JSP页面使用Tag标记调用oddNumberSum.tag计算100之内的奇数和。

代码如下：
example3_1.jsp

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

oddNumberSum.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>

3.2.3、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属性1 = “属性值” 属性2 = “属性值” … 属性n = “属性值” %>
或
<%@ tag属性1 = “属性值” %>
<%@ tag属性2 = “属性值” %>
…

★language属性
指定Tag文件使用的脚本语言，目前只能使用Java，默认值也是Java，因此在编写Tag文件时，没必要使用指定language属性的值。
★import属性
作用是为Tag文件引入包中的类方便使用，import属性默认值有如下："java.lang. * " "javax.servlet. * " "javax.servlet.jsp. * " "javax.servlet.http. * "。
★pageEncoding
指定Tag文件的字符编码，默认值是ISO-8859-1。通常将该属性值设置为UTF-8。

3.3.2、include指令

使用方法和作用与JSP文件中的include指令标记类似，详情请到第二章查看。
java web 开发——第二章jsp语法

3.3.3、attribute指令

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

<%@ attribute name = “对象名字” required = “true”|“false” type = “对象的类型” %>
例如Tag文件myTag中有如下指令：
<%@ attribute name = “result” required = “true” type = “java.lang.Double” %>

相当于Tag文件中有了一个名字为result的对象，但Tag文件不需要创建该对象，而是等待JSP页面将一个Double型的对象的引用传递给result。

attribute指令中的name属性是必须的且不可重复，可向name属性指定的对象传递一个引用。type在指定对象类型时必须使用包名。如果attribute指令没有使用type指定对象的类型，那么对象的类型默认是java.lang.String类型。

JSP页面使用Tag标记向所调用的Tag文件中name指定的对象传递一个引用，方式如下：

<前缀:Tag文件名字对象名字 = “对象的引用” />

attribute指令中的required属性也是可选的，默认为false。为true时，必须向该Tag文件中name属性给出的对象传递一个引用；为false时name属性给出的对象传递或不传递对象的引用。

下面例子中使用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指令

可以将Tag文件中的对象返回给调用该Tag文件的JSP页面

（1）variable指令的格式
格式如下：

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

★其中属性name-given的值就是Tag文件返回给JSP页面的对象，该对象的名字必须符合标识符规定。
★属性variable-class的值时返回的对象的类型，对象的类型必须带有包名，如果没有使用该属性则默认对象类型为java.lang.String类型。
★scope属性的值指定对象的有效范围，scope的值可以取AT_BEGIN、NESTED、和AT_END。
AT_BEGIN：JSP页面一旦开始使用Tag标记，就得到了variable指令返回给JSP页面的对象，JSP页面就可以在Tag标记的标记体中或Tag标记结束后的各个部分中使用variable指令返回给JSP页面的对象。
NESTED：JSP页面只可以在Tag标记的标记体中使用variable指令返回给JSP页面的对象。
AT_END：JSP页面只可以在Tag标记结束后。才可以使用variable指令返回给JSP页面的对象。

（2）对象的返回
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());

将名字是time的LocalDate对象存储到jspContext中。

下面例子中JSP页面将String对象交给Tag文件handleData.tag,handleData.tag解析出String对象的字符序列中的全部数字，并计算出数字总和，将数字总和放在Double对象price中，然后返回给JSP页面。example3_4.jsp输出price对象中的数字总和。

代码如下：
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));
%>

3.3.5、taglib指令

JSP页面或Tag文件都可以使用taglib指令引入标记库。taglib指令格式如下：

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

总结

本章我们学习了Tag文件与Tag标记，通过本章的学习让我们对JSP页面有了更深入的了解。

JUST WE0426

关注

0
点赞
踩
1

收藏

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

本章我们将学习Tag文件，一种特殊的文本文件。Tag文件和JSP文件很类似，可以被JSP页面动态加载调用，实现代码的复用（但用户不能通过该Tag文件所在的Web服务目录直接访问Tag文件）本章我们学习了Tag文件与Tag标记，通过本章的学习让我们对JSP页面有了更深入的了解。
复制链接

扫一扫