jsp中Tag的使用（自定义标签）

Tag文件可以实现代码的复用，这些代码可能是许多JSP页面都需要的。为了能让一个Web应用中的JSP页面使用某一个Tag文件，必须把这个Tag文件存放到Tomcat服务器指定的目录中，也就是说，如果某个Web服务目录下的JSP页面准备调用一个Tag文件，那么我们必须在该Web服务目录下，建立如下的目录结构:

Web服务器\WEB-INF\tags

比如:

Ch3\WEB-INF\tags

其中的WEB-INF和tags部是固定的子目录名称，而tags下的子目录名称可由用户给定。

3.3 Tag标记与Tag文件的使用

1.Tag标记

某个Web服务目录下的Tag文件只能由该Web服务目录(包括该Web服务目录的子目录)中的JSP页面调用，JSP页面必须通过Tag标记来调用一个Tag文件。当我们编写了一个Tag文件并保存到特定目录中后，也就自定义了一个标记，该标记的格式为:

文件名字/>

或

文件名字>

标记体

文件名字>

也就是说，一个Tag文件对应一个标记，习惯上称为Tag标记。同一个目录中的若干个Tag文件对应的各个Tag标记组成一个标记库，习惯上称为自定义标记库。

2.Tag标记的使用

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

<％@taglibtagdir="自定义标记库的位置"prefix="前缀">

一个JSP页面可以使用几个<taglib>指令标记引入若干个标记库，例如:

<%@ taglibtagdir="/WEB-INF/tags"prefix="beijing"%>

<%@ taglibtagdir="/WEB-INF/tags/tagsTwo""prefix="dalian"%>

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

<beijing:OddSum/>

<dalian:EvenSum/>

注意:通过前缀可以有效地区分不同标记库中具有相同名字的标记文件。

3.Tag标记的标记体

JSP页面使用Tag标记动态执行一个Tag文件。我们已经知道，一个Tag文件会对应一个自定义标记，该标记的格式为:

文件名字/>

或

文件名字>

标记体

文件名字>

默认情况下，JSP可以使用没有标记体的Tag标记，也可以使用带有标记体的Tag标记调用一个Tag文件。那么，Tag标记的标记体起着怎样的作用呢?

当JSP页面调用一个Tag文件时可能希望动态地向该Tag文件传递信息，那么就可以使用带有标记体的Tag标记来执行一个Tag文件，Tag标记中的“标记体’’就会传递给相应的Tag文件，Tag文件通过使用:

<jsp:doBody />

标记处理JSP页面传递过来的“标记体”。

3.4 Tag文件中的常用指令

与JSP文件类似，Tag文件中也有一些常用指令，这些指令将影响Tag文件的行为。

Tag文件中经常使用的指令有:

tag、taglib、include、attribute、variable。

1.tag 指令

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

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

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

<%@tag 属性1="属性值" %>

<%@tag 属性2="属性值" %>

……

<%@tag 属性n="属性值" %>

tag指令可以操作的属性有:body-content、language、import、pageEncoding。

(1) body-content属性

一个Tag文件会对应一个Tag标记，其格式为:

文件名字/>

或

文件名字>

标记体

文件名字>

JSP文件通过使用Tag标记调用相应的Tag文件，那么JSP文件到底应该使用Tag标记的哪种格式来调用Tag文件呢?

答案是:一个Tag文件通过tag指令指定body-content属性的值可以决定Tag标记的使用格式。也就是说，body-content属性的值可以确定JSP页面使用Tag标记时是否可以有标记体，如果允许有标记体，则该属性会给出标记体内容的类型。

body content属性值有: empty、tagdependent、scriptless，默认值是scriptless。

如果body-content属性的值是empty，那么JSP页面必须使用没有标记体的Tag标记:

文件名字/>

来调用相应的Tag文件。

如果body content属性的值是tagdependent或scriptless，那么JSP页面可以使用无标记体或有标记体的Tag标记:

文件名字>

标记体

文件名字>

来调用相应的Tag文件。

如果属性值是scriptless，那么标记体中不能有Java程序片；如果属性值是tagdependent，那么Tag文件将标记体的内容按纯文本处理。

Tag标记中的标记体由相应的Tag文件负责处理，因此，当JSP页面使用有标记体的Tag标记调用一个Tag文件时，可以通过“标记体”向该Tag文件动态地传递文本数据或必要的JSP指令。

Tag文件通过使用标记:

<jsp:doBody/>

(2)language属性

language属性的值指定Tag文件使用的脚本语言，目前只能取值Java，其默认值就是Java，因此在编写Tag文件时，没有必要使用tag指令指定language属性的值。

(3)import属性

import属性的作用是为Tag文件引入Java核心包中的类，这样就可以在Tag文件的程序片部分、变量及方法声明部分、表达式部分使用Java核心包中的类。import属性可以取多个值，import属性已经有如下值:“java.1ang.*”、“javax.servlet.*”、“javax.servletjsp.％”、“javax.servlet.http.*”。

(4) pageEncoding

该属性指定Tag文件的字符编码，其默认值是ISO-8859-1。Tag文件必须使用ANSI编码保存。

2.include指令

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

3.attribute指令

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

attribute指令的格式如下:

<%@attribute name="对象名字"required="true" | "false"

type="对象的类型"%>

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

type指定对象的类型，比如:type=“java.util.Date”。

需要特别注意的是，对象的类型必须带有包名，比如，不可以将java.util.Date简写为Date。

如果attribute指令中没有使用type指定对象的类型，那对象的类型是java.1ang.String类型。

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

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

或

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

标记体

前缀:Tag文件名字>

比如，一个Tag文件MyTag.tag有如下的attribute指令:

<%@ attributename="length" required="true" %>

那么JSP页面就可以如下使用Tag标记(假设标记的前缀为computer)调用MyTag.tag:

<computer:MyTaglength="1000" />

或

<computer:MyTaglength="1000" >

我向Tag文件中传递的值是100

<computer:MyTag/>

再比如，一个Tag文件YourTag.tag已有如下的attribute指令:

<％@attribute name="result"required="true"type="java.1ang.Double"％>

那么JSP页面可以如下使用Tag标记(假设标记的前缀为computer)调用YourTag.tag，将一个java.1ang.Double类型对象的引用传递给YourTag.tag文件中的result对象:

<computer:YourTagresult="<%=newDoube(666.999) %> />

attribute指令中的required属性也是可选的，如果省略required属性，那么required的默认值是false。

当指定required的值是true时，调用该Tag文件的JSP页面必须向该Tag文件attribute指令中的name属性指定的对象传递一个引用，即当required的值是true时，如果使用

“<前缀:Tag文件名字/>” 调用Tag文件就会出现错误。

当指定required的值是false时，调用该Tag文件的JSP可以向该Tag文件attribute指令中的name属性指定的对象传递或不传递对象的引用。

注意:在Tag文件中不可以再定义和attribute指令中的name属性指定的对象具有相同名字的变量，否则将隐藏attribute指令中的对象，使其失效。

4.variable 指令

Tag文件通过attribute指令，可以使JSP页面在调用该Tag文件时动态地向其传递数据。

有时候不仅希望JSP页面向Tag文件传递数据，而且希望Tag文件能返回某些数据给JSP页面。

比如，许多JSP页面可能都需要调用某个Tag文件，来帮助处理某些数据，但不希望Tag文件负责显示处理结果，因为各个JSP页面对显示的格式可能有不同的要求。

因此，希望Tag文件将数据的处理结果存放在某些对象中，并将这些对象返回给当前JSP页面，由JSP页面负责显示这些对象，这样做可以很好地实现数据处理和数据显示的分离。

(1) variable 指令的格式

<%@variable name-given="对象名字"

variable-class="对象的类型"scope="有效范围"%>

--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

实例：

JSP文件：

<%@ page isELIgnored="false"  %> 
<%@ taglib prefix="customTag" tagdir="/WEB-INF/tags" %>

Tag文件：

<%-- 
Tag					Desc								  		Type	Required	Note
dropdown_value      the value shown in the drop-down     		List    true		
input_name		 	the name of input					  		String  true
input_defValue		the default value of input			  		String	false
add_type			the type of add						 	 	String  false
input1_tip			the tip message of the first input   	 	String	false		Multi_language support
input2_tip			the tip message of the second input   		String	false		Multi_language support
input1_emptyTip		tip message when the first input is empty	String	false		Multi_language support
input2_emptyTip		tip message when the second input is empty	String	false		Multi_language support
table_head1			the head of the first column				String 	false		Multi_language support
table_head2			the head of the second column				String 	false		Multi_language support
showFilter			if show filter								Boolean	false
showAdd				if show add									Boolean false
--%>
<%@ tag  isELIgnored="false"  %> 
<%@ attribute name="id" required="true"%>
<%@ attribute name="dropdown_value" rtexprvalue="true"  type="java.util.List" required="true" %>
<%@ attribute name="input_name" required="true"%>
<%@ attribute name="input_defValue" rtexprvalue="true" %>
<%@ attribute name="add_type"%>
<%@ attribute name="input1_tip" %>
<%@ attribute name="input2_tip"%>
<%@ attribute name="input1_emptyTip"%>
<%@ attribute name="input2_emptyTip"%>
<%@ attribute name="table_head1"%>
<%@ attribute name="table_head2"%>
<%@ attribute name="showFilter"%>
<%@ attribute name="showAdd"%>


<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>
<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>
<%@taglib prefix="s" uri="/struts-tags"%>
 



   	

   		
		
	
	

	

		
			

				" style="float:left;margin-right:10px;height:20px"/>
				<s:text name="%{#attr.input2_tip}"/>
				Filter
			
			

		
		
		

		
				
					

			
Apply Selected
			

			
			

						

							checked="checked" value="${qcode.qcode}"/>
						
						
${qcode.qcode}
						

							
							   ${fn:substring(qcode.qdesc, 0, 24)} ... 
							   ${qcode.qdesc}
							  
							
						
					
				 
			
			
		
	
		
		

		
			

				

					" style="float:left;margin-right:10px;height:20px'"/>
					<s:text name="%{#attr.input2_tip}"/>
					Add