Servlet&JSP的那些事儿(二十四)

本篇我们讨论标签文件(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 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

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值