Tag文件与Tag标记

 

目录

一、Tag文件

1、Tag文件的结构

2、Tag文件的保存

1、Tag文件所在目录

2、Tag文件的编码

 二、Tag标记

1、Tag标记与Tag文件

2、Tag标记的使用

3、Tag标记的运行原理

三、Tag文件中的常用指令

1、tag指令

2、include指令

3、attribute指令

4、variable指令

 5、taglib 指令

---

一、Tag文件

1、Tag文件的结构

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

2、Tag文件的保存

1、Tag文件所在目录

Tag文件可以实现代码的复用，即Tag文件可以被许多JSP页面使用。为了能让一个Web应用中的JSP页面使用某一个Tag文件，必须把这个Tag文件存放到Tomcat服务器指定的目录中。建立如下的目录结构：

Web服务目录\WEB-INF\tags

 其中的WEB-INF(字母大写）和tags都是固定的目录名称，而tags下的子目录的名称可由用户给定。

2、Tag文件的编码

保存Tag文件时按照Tag文件指定的编码保存Tag文件使用tag指令指定编码为UTF-8：

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

 二、Tag标记

1、Tag标记与Tag文件

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

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

2、Tag标记的使用

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

<%@ taglib tagdir="标记库的位置" prefix="前缀">

引入标记库后，JSP页面就可以使用带前缀的Tag标记调用相应的Tag文件，其中的前缀由<taglib>指令中的prefix属性指定。

注：JSP页面使用Tag标记时，冒号：的左右不要有空格。

3、Tag标记的运行原理

如果该Tag标记对应的Tag文件是首次被JSP页面调用，那么Tomcat服务器会将Tag文件转译成一个Java文件，并编译这个Java文件生成字节码文件，然后执行这个字节码文件

如果该Tag文件已经被转编译为字节码文件，Tomcat服务器会直接执行这个字节码文件。

如果对Tag文件进行了修改，那么Tomcat服务器会重新将Tag文件转译成一个Java文件，并编译这个Java文件生成字节码文件，然后执行这个字节码文件。

三、Tag文件中的常用指令

1、tag指令

Tag文件中的tag指令类似于JSP文件中的page指令。Tag文件通过使用tag指令可以指定某些属性的值，以便从总体上影响Tag文件的处理和表示。tag指令的语法如下:

<%@ tag属性1 = “属性值” 属性2 = “属性值” ……属性n="属性值“%>

在一个Tag文件中可以使用多个tag指令，因此我们经常使用多个tag指令为属性指定需要的值：

1、language属性

language属性的值指定Tag文件使用的脚本语言。

2、import属性

import属性的作用是为Tag文件引入包中的类，这样就可以在Tag文件的程序片部分、变量及方法定义部分、表达式部分使用包中的类。

3、pageEncoding

该属性指定Tag文件的字符编码，其默认值是ISO-8859-1。目前，为了避免显示信息出现乱码现象，tag文件需要将该属性值设置为UTF-8。

2、include指令

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

3、attribute指令

Tag文件充当着可复用代码的角色，充当着可复用代码的角色，如果一个Tag文件允许使用它的JSP页面向该Tag文件传递数据，就使得Tag文件的功能更为强大。在Tag文件中通过使用attribute指令让使用它的JSP页面向该Tag文件传递需要的数据。指令格式如下：

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

attribute 指令中的name属性是必需的，该属性的值是一个对象的名字。JSP页面在调用Tag文件时 可向name属性指定的对象传递一个引用。需要注意的是，type在指定对象类型时，必须使用包名。

attribute指令中的required属性也是可选的，如果省略required属性，那么required的默认值是false。当指定required的值是true时，调用该Tag文件的JSP页面必须向该Tag文件中attribute指令中的name属性给出的对象传递一个引用。

4、variable指令

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

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

name-given的值就是Tag文件返回给JSP页面的对象；variable-class的值是返回的对象的类型，对象的类型必须带有包名；scope的值指定对象的有效范围，scope的值可以取AT_BEGIN、NESTED和AT_END。

Tag文件为了给JSP页面返回一个对象，就必须将返回的对象的名字以及该对象的引用存储到Tomcat服务器提供的内置对象jspContext中。Tag文件只有将对象的名字机器引用存储到jspContext中，JSP页面才可以使用该对象。

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

 5、taglib 指令

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

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