Tag文件与Tag标记

KLXS_AL

已于 2023-05-09 19:50:39 修改

阅读量694

点赞数 2

分类专栏： JavaWeb 文章标签： java tomcat

于 2023-05-01 21:12:51 首次发布

本文链接：https://blog.csdn.net/KLXS_AL/article/details/130456209

版权

JavaWeb 专栏收录该内容

2 篇文章 0 订阅

订阅专栏

前言

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>