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


前言

一个Web应用中的许多JSP页面可能需要使用某些相同的信息,如都需要使用相同的导航栏、标题等。如果能将许多页面都需要的共同信息形成一种特殊文件,而且各个JSP页面都可以使用这种特殊的文件,那么这样的特殊文件就是可复用的代码。


一、Tag文件

Tag文件和JSP文件很类似,可以被JSP页面动态加载调用,实现代码的复用(但用户不能通过该Tag文件所在Web服务目录直接访问Tag文件)。

1.Tag文件的结构

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

以下为一个简单的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>

2.Tag文件的保存

Tag文件可以实现代码的复用,即Tag文件可以被许多JSP页面使用。为了能让Web应用中的JSP页面使用某一个Tag文件,必须把这个Tag文件存放到Tomcat服务器指定的目录中。
建立目录结构:Web服务目录\WEB-INF\tags
比如:ch3\WEB-INF\tags
其中的WEB-INF(字母大写)和tags都是固定的目录名称,而tags下的子目录的名称可由用户给定。
一个Tag文件必须保存到tags目录或其下的子目录中。


二、Tag标记

1.Tag标记与Tag文件

<Tag文件名字 />

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

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

2.Tag标记的使用

  • JSP页在使用Tag标记来调用一个Tag文件之前,必须首先使用taglib指令标记引入该Web服务目录下的标记库,只有这样,JSP页面才可以使用Tag标记调用相应的Tag文件。
    taglib指令的格式如下:
    <%@ taglib tagdir=“标记库的位置” prefix=“前缀”>
    例如:
    <%@ taglib tagdir=“/WEB-INF/tags” prefix=“computer”%>
  • 引入标记库后,JSP页面就可以使用带前缀的Tag标记调用相应的Tag文件,其中的前缀由指令中的prefix属性指定。例如JSP如下使用Tag标记调用相应的Tag文件:
    <computer:oddNumberSum />

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.Tag标记的运行原理

Tomcat服务器处理JSP页面中的Tag标记的原理如下:

  • 如果该Tag标记对应的Tag文件是首次被JSP页面调用,那么Tomcat服务器会将Tag文件转译成一个java文件,并编译这个java文件生成字节码文件,然后执行这个字节码文件(这和执行JSP页面的原理类似)。
  • 如果该Tag文件已经被转编译为字节码文件,Tomcat服务器将直接执行这个字节码文件。
  • 如果对Tag文件进行了修改,那么Tomcat服务器会重新将Tag文件转译成一个java文件,并编译这个java文件生成字节码文件,然后执行这个字节码文件。

三、Tag文件中的常用指令

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

1.tag指令

类似于JSP文件中的page指令。Tag文件通过使用tag指令可以指定某些属性的值,以便从总体上影响Tag文件的处理和表示。
<%@ tag 属性1=“属性值” 属性2=“属性值” …属性n=“属性值”%>
在一个Tag文件中可以使用多个tag指令,因此我们经常使用多个tag指令为属性指定需要的值:
<%@ tag 属性1=“属性值”%>
<%@ tag 属性2=“属性值”%>
……
<%@ tag 属性n=“属性值”%>

  • language属性
    只能取值java,其默认值就是java,没有必要使用tag指令指定language属性的值。
  • import属性
    import属性的作用是为Tag文件引入包中的类,import属性默认已经有如下值:“java.lang."、 "javax.servlet.”、“javax.servlet.jsp."、"javax.servlet.http.”。
  • pageEncoding属性
    该属性指定Tag文件的字符编码,其默认值是ISO-8859-1。目前,为了避免显示信息出现乱码现象,Tag文件需要将该属性值设置为utf-8。

2.include指令

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

3.attribute指令

如果一个Tag文件允许使用它的JSP页面向该Tag文件传递数据,就使得Tag文件的功能更为强大。在Tag文件中通过使用attribute指令让使用它的JSP页面向该Tag文件传递需要的数据。
<%@ attribute name=“对象名字” required=“true”|“false” type=“对象的类型”%>
例如Tag文件myTag.tag中有如下attribute指令:
<%@ attribute name=“result” required=“true” type=“java.lang.Double”%>
那么就相当于Tag文件中有了一个名字是result的对象,但Tag文件不需要创建该对象result,而是等待JSP页面将一个Double型的对象的引用传递给result。
JSP页面使用Tag标记向所调用的Tag文件中name指定的对象传递一个引用,方式如下:
<前缀:Tag文件名字 对象名字=“对象的引用” />
比如,JSP页面使用Tag标记(假设标记的前缀为computer)调用myTag.tag:
<computer:myTag result= “new Double(3.1415926)” />

例子3_2中,triangle.tag存放在ch3\WEB-INF\tags\eample2目录中,该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+","+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));
%>


4.variable指令

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

  • variable指令格式如下:
    <%@ variable name-given=“对象” variable-class=“对象的类型” scope=“有效范围”%>
    variable指令中的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页面的对象。
  • 对象的返回
    Tag文件为了给JSP页面返回一个对象,就必须将返回的对象的名字以及该对象的引用存储到Tomcat服务器提供的内置对象jspContext中。
    jspContext.setAttribute(“对象的名字”,对象的引用)

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

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

5.taglib指令

JSP页面或Tag文件都可以使用taglib指令引入标记库。
<%@ taglib tagdir=“自定义标记库的位置” prefix=“前缀”>
一个Tag文件也可以使用几个taglib指令标记引入若干个标记库,例如:
<%@ taglib tagdir=“/WEB-INF/tags” prefix=“beijing”%>
<%@ taglib tagdir=“/WEB-INF/tags/tagsTwo” prefix=“dalian”%>

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 1
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值