JSP实用教程-Tag文件与Tag标记

一.Tag文件

目录

一.Tag文件

1.Tag文件的结构

2.Tag文件的保持

二.Tag标记

1.Tag标记与Tag文件

2.Tag标记的使用

3 .Tag标记的运行原理  

三.Tag文件中的常用指令

1.Tag指令

2 include指令

3 attribute指令

4 variable指令

5 taglib指令

---

1.Tag文件的结构

Tag文件是扩展名为.Tag的文本文件，其结构与JSP相似，包括普通的HTML标记符、某些特殊的指令标记、成员变量声明和方法的定义、Java程序片和Java表达式。

例：负责计算100以内的全部奇数的代数和
<%@ tag pageEncoding="utf-8" %> //tag标记
<p style="font-family:宋体;font-size:36">
1～100内的奇数之和：
  <%  int sum=0,i=1; //java程序片
         for(i=1;i<=100;i++){
            if(i%2==1)
               sum=sum+i;
        }
        out.println(sum);
  %> 
</p>

2.Tag文件的保持

1、Tag文件所在目录

Tag文件可实现代码的复用。如果某Web服务目录下的JSP页面准备调用一个Tag文件，那么必须在Web服务目录下建立以下目录结构；

Web服务目录\WEB-INF\tags

注：WEB-INF（大写）和tags是固定的目录名称。

2、Tag文件的编码

保存Tag文件时按照Tag文件指定的编码保存，如：

<%@tag pageEncoding="utf-8"%>

该Tag指令指定编码方式为utf-8，则Tag文件保存时应选择“utf-8”。

二.Tag标记

1.Tag标记与Tag文件

JSP页面必须通过Tag标记来调用一个Tag文件，tag标记的名字和Tag文件的名字一致，也就是说当我们写了一个tag文件放到特定的目录中，也就给出了一个tag标记

Tag标记格式为：

<Tag 文件名字/>

或

<Tag 文件名字>标体内容</Tag 文件名字>

2.Tag标记的使用

一个JSP页面通过使用tag标记来调用一个Tag文件。Web服务目录下的一个JSP页面使用tag标记调用文件之前，必须首先使用taglib指令标记引入该web服务目录下的标记库，只有这样jsp才能调用相应的tag文件。

taglib指令的格式为：<%@taglib tagdir="标记库的位置"prefix=“前缀”>   

例：

<%@taglib tagdir='/WEB-INF/tags' prefix='computer'%>

引入标记库后，JSP页面可使用带前缀的Tag标记调用相应的Tag文件

格式：<"前缀"：Tag去掉扩展名后的文件名/>

例：

<computer:oddNumberSum/>调用文件名为oddNuberSum.tag的Tag文件

3 .Tag标记的运行原理
  

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

三.Tag文件中的常用指令

1.Tag指令

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

或

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

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

...

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

①language属性

作用：指定脚本语言

目前只能取值java，默认值为java，故无需指定。

②import属性

作用：为Tag文件引入包中的类

可以取多个值，例：

import java.lang.*;

import javax.servelt.*;

import javax.serverlt.jsp.*;

------

③pageEncoding属性

作用：指定Tag文件的字符编码

<%@ tag pageEncoding="utf-8"%>

默认值为ISO-8859-1，为了避免信息出现乱码，需要将属性设置为utf-8

2 include指令

其作用方法与JSP文件中的include指令标记类似

3 attribute指令

作用：让使用该指令的JSP页面向该Tag文件传递需要的数据

格式为：<%@attribute name="对象名字"required=“true”|“false”type="对象的类型"%>

例：

<%@ attribute name="reuslt" required="ture" type="java.lang.Double"%>

注：name属性是必需的，type在指定对象是必须使用包名，其默认值为java.lang.String。

【name属性】可传递一个引用,方式如下：

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

例：

<computer:myTag result="newdouble(3.1415926)"/>

【required属性】：默认值为false，当为true时，调用该Tag文件的JSP页面必须向该Tag文件中attribute指令中的name属性给出的对象传递一个引用，当为false时，调用该Tag文件的JSP页面必须向该Tag文件中attribute指令中的name属性给出的对象传递或不传递对象的引用，

4 variable指令

作用：将Tag文件中的对象返回给调用该Tag文件的JSP页面。

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

属性name-given：是返回给JSP页面的对象，必须标识符规定（即可由字母数字下划线美元符号数字组成，且第一个字符不能为数字）。

属性variable-class：必须带有包名

属性scope：指定对象的有效范围，值可取AT_BEGIN,NESTED,AT_END.

<%@ variable name-given="time"

variable-class="java.time.LocalDate"scope="AT_END" %>

2、对象的返回

Tag文件只有将对象的名字及其引用存储到jspContext中，才能使用该对象。

jspContext.setAttribute("对象名"，对象的引用)

注：在JSP页面中不可以再定义与Tag文件返回的对象具有相同名字的变量，否则Tag文件无法将variable 指令给出的对象返回给JSP页面(并将出现编译错误)。如果 Tag 文件同时使用variable 指令和attribute指令，那么variable指令中name-given和attribute 指令中name给出的对象不能相同(否则将出现编译错误)。

5 taglib指令

JSP页面或Tag文件都可以使用taglib指令引入标记库,可使用多个taglib指令标记引入若干标记库。

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