Servlet&JSP的那些事儿（二十四）
2012-12-19 19:35
435 查看
本篇我们讨论标签文件（Tag Files）。之前我们在Servlet&JSP的那些事儿（十六）、Servlet&JSP的那些事儿（十六）两篇中讨论过了传统标签和简单标签的开发，需要使用java语言编写标签处理器类，标签文件允许jsp页面编写人员使用jsp语法来定制标签，不需要了解java语言。本篇我们主要介绍如何标签文件来定制标签。如果能和之前的两篇结合起来，会更好的理解标签文件。
标签文件的语法
它的语法和jsp语法有点类似，在jsp页面中可以使用的语法在标签文件中可以使用，不过有不同之处。
1）jsp页面中的page指令在标签文件中不能使用，标签文件增加了tag指令、attribute指令和variable指令。
2）<jsp:invoke>和<jsp:doBody>两个标准动作元素只能在标签文件中使用。
我们先看一个简单的标签文件hello.tag。如下
tag指令只能在标签文件中使用，用于取代jsp页面中的page指令。
编写的标签文件要在jsp页面中使用，需要存放在指定位置。包括两个地方：一是放在/WEB-INF/tags目录或其子目录下，容器会自动搜索其中的.tag和.tagx文件。二是放在JAR文件的/META-INF/tags目录或其子目录下。
现在编写一个jsp页面测试一下。如下所示：
注：在taglib指令中，属性tagdir指定标签文件所在的路径。
可以启动tomcat，访问该页面。在浏览器网址栏输入http://localhost:8080/TestTag/hello.jsp。运行结果如下：
我们在D:\apache-tomcat-7.0.33\work\Catalina\localhost\TestTag\org\apache\jsp\tag文件夹下，可以找到一个webhello_tag.java文件。内容如下：
标签文件的隐藏属性
标 签文件可以使用隐藏属性：request、response、jsContext、session、application、out、config，其中 jspContext隐含对象的类型为javax.servlet.jsp.JspContext，它用来管理所有范围的变量，就相当于JSP页面的 pageContext隐藏对象一样
标签文件的指令
标签文件中可以使用的主要指令：taglib、include、attribute、variable。
tag 指令如同JSP网页的page指令，用来设定标签文件。display-name表示图形化开发工具显示<display-name>所指定 的名称；body-content表示可能的值有三种，分别是empty、scriptless、tagdependent、empty。empty为标 签中没有主体内容，scriptlet为标签中的主体内容EL、JSP动作元素，但不可以为JSP脚本元素，tagdependent表示标签中的主体内 容交由tag自己去处理，默认值为scriptless；dynamic-attributes表示设定标签文件动态属性的名称,当dynamic-
attributes设定时,将会产生一个Map类型的集合对象,用来存放属性的名称和值；small_icon表示在图形化开发工具显 示<small-icon>所指定的TLD相对路径的小图标，大小为16X16；large-icon表示在图形化开发工具显 示<large-icon>所指定的TLD相对路径的大图标，大小为32X32；description表示用来说明此标签文件的相关信 息；example表示用来增加更多的标签使用说明，包括标签应用时的范例；language、import、pageEncoding、
isELIgnored这些属性与page指令相对应的属性相同。
这 个指令用来设定自定义标签的属性。其中name表示属性的名字；required表示是否为必要，默认为false；rtexprvalue表示属性值是 否可以为run-time表达式。如为true，表示属性可用动态的方式来指定，如：<mytag:read num="${param.num}"/>，如为false，则一定要用静态的方式来指定属性值；type表示这个属性的类型，默认值为 java.lang.String；description用来说明此属性的相关信息。
这 个指令用来设定标签文件的变量。其中name-given表示直接指定变量的名称；name-from-attribute表示以自定义标签的某个属性值 为变量名称；alias表示声明一个局部范围属性，用来接收变量的值；variable-class表示变量的类名称，默认值为 java.lang.String；declare表示此变量是否声明默认值为true；scope表示此变量的范围，范围是：AT_BEGIN、 AT_END和NESTED，默认值为NESTED；description用来说明此变量的相关信息。
<jsp:invoke>动作元素
该元素将JspFragment类型的属性的执行结果输出到JspWriter对象，或者保存到指定的范围变量中。
frament为必须的属性，用于指定类型为JspFragment的属性的名称。var是可选属性，指定一个范围变量的名字，类型是string。该变量保存了JspFragment对象执行的结果。属性var和属性varReader只能指定其一，如果两者都没指定，则JspFragment对象的执行结果输出到当前的JspWriter对象中。varReader将JspFragment对象执行的结果保存到Reader类型的变量中。scope用来指定变量的jsp范围内。默认为page。
<jsp:doBody>动作元素
该标签用于执行标签体（JspFragment对象），将结果输出到JspWriter对象，或者保存到指定的范围变量中。
转载请注明出处：http://blog.csdn.net/iAm333
标签文件的语法
它的语法和jsp语法有点类似，在jsp页面中可以使用的语法在标签文件中可以使用，不过有不同之处。
1）jsp页面中的page指令在标签文件中不能使用，标签文件增加了tag指令、attribute指令和variable指令。
2）<jsp:invoke>和<jsp:doBody>两个标准动作元素只能在标签文件中使用。
我们先看一个简单的标签文件hello.tag。如下
<%@ tag pageEncoding="gb2312" %> 这是一个标签文件
tag指令只能在标签文件中使用，用于取代jsp页面中的page指令。
编写的标签文件要在jsp页面中使用，需要存放在指定位置。包括两个地方：一是放在/WEB-INF/tags目录或其子目录下，容器会自动搜索其中的.tag和.tagx文件。二是放在JAR文件的/META-INF/tags目录或其子目录下。
现在编写一个jsp页面测试一下。如下所示：
<%@ page contentType="text/html;charset=gb2312" %> <%@taglib tagdir="/WEB-INF/tags" prefix="mytag"%> <html> <head><title></title></head> <body><mytag:hello/></body> </html>
注：在taglib指令中，属性tagdir指定标签文件所在的路径。
可以启动tomcat，访问该页面。在浏览器网址栏输入http://localhost:8080/TestTag/hello.jsp。运行结果如下：
我们在D:\apache-tomcat-7.0.33\work\Catalina\localhost\TestTag\org\apache\jsp\tag文件夹下，可以找到一个webhello_tag.java文件。内容如下：
/*
* Generated by the Jasper component of Apache Tomcat
* Version: Apache Tomcat/7.0.33
* Generated at: 2012-12-14 08:32:17 UTC
* Note: The last modified time of this file was set to
* the last modified time of the source file after
* generation to assist with modification tracking.
*/
package org.apache.jsp.tag;
import javax.servlet.*;
import javax.servlet.http.*;
import javax.servlet.jsp.*;
public final class webhello_tag
extends javax.servlet.jsp.tagext.SimpleTagSupport
implements org.apache.jasper.runtime.JspSourceDependent {
private static final javax.servlet.jsp.JspFactory _jspxFactory =
javax.servlet.jsp.JspFactory.getDefaultFactory();
private static java.util.Map<java.lang.String,java.lang.Long> _jspx_dependants;
private javax.servlet.jsp.JspContext jspContext;
private java.io.Writer _jspx_sout;
private javax.el.ExpressionFactory _el_expressionfactory;
private org.apache.tomcat.InstanceManager _jsp_instancemanager;
public void setJspContext(javax.servlet.jsp.JspContext ctx) {
super.setJspContext(ctx);
java.util.ArrayList _jspx_nested = null;
java.util.ArrayList _jspx_at_begin = null;
java.util.ArrayList _jspx_at_end = null;
this.jspContext = new org.apache.jasper.runtime.JspContextWrapper(ctx, _jspx_nested, _jspx_at_begin, _jspx_at_end, null);
}
public javax.servlet.jsp.JspContext getJspContext() {
return this.jspContext;
}
public java.util.Map<java.lang.String,java.lang.Long> getDependants() {
return _jspx_dependants;
}
private void _jspInit(javax.servlet.ServletConfig config) {
_el_expressionfactory = _jspxFactory.getJspApplicationContext(config.getServletContext()).getExpressionFactory();
_jsp_instancemanager = org.apache.jasper.runtime.InstanceManagerFactory.getInstanceManager(config);
}
public void _jspDestroy() {
}
public void doTag() throws javax.servlet.jsp.JspException, java.io.IOException {
javax.servlet.jsp.PageContext _jspx_page_context = (javax.servlet.jsp.PageContext)jspContext;
javax.servlet.http.HttpServletRequest request = (javax.servlet.http.HttpServletRequest) _jspx_page_context.getRequest();
javax.servlet.http.HttpServletResponse response = (javax.servlet.http.HttpServletResponse) _jspx_page_context.getResponse();
javax.servlet.http.HttpSession session = _jspx_page_context.getSession();
javax.servlet.ServletContext application = _jspx_page_context.getServletContext();
javax.servlet.ServletConfig config = _jspx_page_context.getServletConfig();
javax.servlet.jsp.JspWriter out = jspContext.getOut();
_jspInit(config);
jspContext.getELContext().putContext(javax.servlet.jsp.JspContext.class,jspContext);
try {
out.write("\r\n");
out.write("这是一个标签文件");
} catch( java.lang.Throwable t ) {
if( t instanceof javax.servlet.jsp.SkipPageException )
throw (javax.servlet.jsp.SkipPageException) t;
if( t instanceof java.io.IOException )
throw (java.io.IOException) t;
if( t instanceof java.lang.IllegalStateException )
throw (java.lang.IllegalStateException) t;
if( t instanceof javax.servlet.jsp.JspException )
throw (javax.servlet.jsp.JspException) t;
throw new javax.servlet.jsp.JspException(t);
} finally {
jspContext.getELContext().putContext(javax.servlet.jsp.JspContext.class,super.getJspContext());
((org.apache.jasper.runtime.JspContextWrapper) jspContext).syncEndTagFile();
}
}
}从代码中可以看出，这个类继承自javax.servlet.jsp.tagext.SimpleTagSupport类，也就是说，标签文件本质上就是简单标签。所以标签文件和简单标签本质上并没有什么不同。标签文件的隐藏属性
标 签文件可以使用隐藏属性：request、response、jsContext、session、application、out、config，其中 jspContext隐含对象的类型为javax.servlet.jsp.JspContext，它用来管理所有范围的变量，就相当于JSP页面的 pageContext隐藏对象一样
标签文件的指令
标签文件中可以使用的主要指令：taglib、include、attribute、variable。
<%@ tag display-name="" body-content="" dynamic-attributes="" small-icon="" large-icon="" description="" example=""language="" import="" pageEncoding="" isELIgnored="">
tag 指令如同JSP网页的page指令，用来设定标签文件。display-name表示图形化开发工具显示<display-name>所指定 的名称；body-content表示可能的值有三种，分别是empty、scriptless、tagdependent、empty。empty为标 签中没有主体内容，scriptlet为标签中的主体内容EL、JSP动作元素，但不可以为JSP脚本元素，tagdependent表示标签中的主体内 容交由tag自己去处理，默认值为scriptless；dynamic-attributes表示设定标签文件动态属性的名称,当dynamic-
attributes设定时,将会产生一个Map类型的集合对象,用来存放属性的名称和值；small_icon表示在图形化开发工具显 示<small-icon>所指定的TLD相对路径的小图标，大小为16X16；large-icon表示在图形化开发工具显 示<large-icon>所指定的TLD相对路径的大图标，大小为32X32；description表示用来说明此标签文件的相关信 息；example表示用来增加更多的标签使用说明，包括标签应用时的范例；language、import、pageEncoding、
isELIgnored这些属性与page指令相对应的属性相同。
<%@ attribute name="" required="" fragment="" rtexprvalue="" type="" description=""%>
这 个指令用来设定自定义标签的属性。其中name表示属性的名字；required表示是否为必要，默认为false；rtexprvalue表示属性值是 否可以为run-time表达式。如为true，表示属性可用动态的方式来指定，如：<mytag:read num="${param.num}"/>，如为false，则一定要用静态的方式来指定属性值；type表示这个属性的类型，默认值为 java.lang.String；description用来说明此属性的相关信息。
<%@ variable name-given="" name-from-attribute="" alias="" variable-class="" declare="" scope="" desription="">
这 个指令用来设定标签文件的变量。其中name-given表示直接指定变量的名称；name-from-attribute表示以自定义标签的某个属性值 为变量名称；alias表示声明一个局部范围属性，用来接收变量的值；variable-class表示变量的类名称，默认值为 java.lang.String；declare表示此变量是否声明默认值为true；scope表示此变量的范围，范围是：AT_BEGIN、 AT_END和NESTED，默认值为NESTED；description用来说明此变量的相关信息。
<jsp:invoke>动作元素
该元素将JspFragment类型的属性的执行结果输出到JspWriter对象，或者保存到指定的范围变量中。
<jsp:invoke fragment="frag" var="resultString" varReader="resultReader" scope="scope" />
frament为必须的属性，用于指定类型为JspFragment的属性的名称。var是可选属性，指定一个范围变量的名字，类型是string。该变量保存了JspFragment对象执行的结果。属性var和属性varReader只能指定其一，如果两者都没指定，则JspFragment对象的执行结果输出到当前的JspWriter对象中。varReader将JspFragment对象执行的结果保存到Reader类型的变量中。scope用来指定变量的jsp范围内。默认为page。
<jsp:doBody>动作元素
该标签用于执行标签体（JspFragment对象），将结果输出到JspWriter对象，或者保存到指定的范围变量中。
转载请注明出处：http://blog.csdn.net/iAm333
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 
相关文章推荐
- Servlet&JSP的那些事儿（十）
- Servlet&JSP的那些事儿（十七）
- Servlet&JSP的那些事儿（二十一）
- Servlet&JSP的那些事儿
- Servlet&JSP的那些事儿（二）
- Servlet&JSP的那些事儿（十二）
- Servlet&JSP的那些事儿系列博文
- Servlet&JSP的那些事儿（三）
- Servlet&JSP的那些事儿（九）
- Servlet&JSP的那些事儿（十九）
- Servlet&JSP的那些事儿（四）
- Servlet&JSP的那些事儿（十一）
- Servlet&JSP的那些事儿（十五）
- Servlet&JSP的那些事儿（七）
- Servlet&JSP的那些事儿（二十）
- Servlet&JSP的那些事儿（二十三）
- Servlet&JSP的那些事儿（二）
- Servlet&JSP的那些事儿（五）
- Servlet&JSP的那些事儿（十四）
- Servlet&JSP的那些事儿（十六）