servlet&jsp高级：第三部分

标签：

EL表达式语言

EL概述

基本语法格式： ${表达式}

特点：

l  在EL表达式中可以直接使用属性名来引用存储在各种域范围(page, request,session, application)中的属性，例如，$(user)等效于如下的JSP脚本表达式：<%= pageContext.findAttribute("user") %>

l  在EL表达式中可以使用${customerBean.address.country}的形式来访问JavaBean对象中的属性对象中的属性，以及可以使用${users[0]}的形式来访问有序集合中的元素。在EL表达式中可以执行基本的关系运算、逻辑运算和算术运算，例如，下面的EL表达式输出的结果为false：${ 1 > (4/2)}

l  在EL表达式中可以使用自定义函数来完成一些更复杂的功能，例如，表达式${it315:filter("<img/>")}中的it355:filter是用户自定义的函数，"<img/>"则是传递给这个自定义函数的参数。

l  在EL表达式中可以使用一系列的隐含对象，例如，pageContext、cookie等。通过这些隐含对象，EL表达式可以访问JSP页面中的各种信息，例如，通过cookie隐含对象可以直接访问到某个Cookie信息，如果不使用EL表达式，则必须编写复杂的JSP脚本代码才能访问某个Cookie信息。

在JSP文件中，字符串“${”作为EL表达式的开始标记，所以，如果要输出字面意义的字符串“${”，必须便用反斜杠对“$”字符进行转义，例如，要输出字符串“an expression is ${true}”，在JSP文件中必须写成字符串“an expression is \${true}”。如果要在EL表达式内部包含“$”字符或“${”字符串，只需将它们作为一个普通的字符串常量用引号引起来即可，例如，“${"${"}”的输出结果就是“${”字符串。另外，在支持EL表达式的JSP页面中，单个的“$”也可以使用“\$”来表示，但这不是必需的。

EL基本应用

    在JSP 2.0中,EL表达式可以用于JSP模板和任何能接受动态值的JSP标签的属性中（包括JSTL标签的属性、自定义标签的属性、JSP标准标签的属性等）。

JSP标签的属性值中使用EL表达式

<c:out value= "Dear ${user.userName} from ${user.address}，welcome you to our website!"/>

它先计算value属性中的EL表达式并将结果转换为字符串，然后和其他的静态字符串连接成一个新的字符串，最后再输出。

JSP模板中使用EL表达式

one value is ${bean1.a} and another is ${bean2.a.c}

JSP引擎首先计算各个EL表达式的值，然后将计算结果和静态文本一起输出到JSP页面。

注：在很多情况下，我们需要对那些特殊的HTML字符进行转换后输出，所以，我们通常不要将EL表达式直接用于JSP模板中，而是应该使用<c:out>这个JSTL标签来输出EL表达式的结果，因为<c:out>标签默认会对HTML和XML中的特殊字符进行转换后再输出。

忽略JSP页面中的EL表达式

在JSP 2.0以前没有EL表达式语言，所以，如果JSP 2.0以前的JSP文件中包含了“${”之类的字符序列，JSP引擎将把它们当作普通的字符文本来处理。但是，当把以前编写的JSP文件发布到支持JSP 2.0的Web服务器中运行时，JSP引擎就会将该JSP文件中的“${”字符序列当作EL表达式进行解析和执行，这样就会出现新版本的Web服务器不能兼容原来的JSP文件的问题。所以，JSP 2.0为了向后兼容以前的JSP页面，提供了在JSP页面中忽略EL表达式的设置选项。

在单个JSP页面里：

<%@ page isELIgnored="true" %>

如果是使用所有JSP页面都忽略，则在web.xml中设置：

<jsp-property-group>

    <url-pattern>*.jsp</url-pattern>

    <el-ignored>true</el-ignored>

</jsp-property-group>

忽略JSP页面中的脚本元素

在JSP页面中使用EL表达式可以实现JSP脚本元索的一些功能，并使JSP页面变得非常简洁，特别是对于严格遵循MVC模式的项目，在JSP页面中完全可以只使用EL表达式，而不必使用任何JSP脚本元素。JSP 2.0规范也为此提供了相应的支持，使得我们可以在Web应用程序中进行设置，让应用程序中的JSP页面中只能使用EL表达式，而不能有JSP脚本元素。JSP默认是支持JSP脚本元素的，只要在Web应用程序的web.xml配置文件中进行一些特殊的设置，就可以禁止所有JSP页面中出现脚本元素。如果JSP页面中使用了脚本元素，就会抛出异常。

<jsp-property-group>

    <url-pattern>*.jsp</url-pattern>

    <scripting-invalid>true</scripting-invalid>

</jsp-property-group>

隐含对象

对于EL表达式中出现的标识符，EL引擎首先判断这个标识符是否是一个隐含对象，如果是，则返回相应的隐含对象，否则把这个标识符当作一个域属性来看待，调用pageContext.findAttribute返回这个域属性所对应的对象，如果不存在标识符所对应的域属性，则返回结果为null。

如果在某个域中定义的属性的名称正好等于某个EL隐含对象的名称，在EL表达式中引用这个名称时，EL引擎将把它当作隐含对象看待，而不是返回域属性的值。所以隐含对象优先。

不要将EL表达式语言中的隐含对象与JSp隐含对象混淆，其中只有pageContext对象是它们所共有的，其他隐含对象则毫无相关性和可比性。

pageContext隐含对象

EL表达式中的pageContext对应于JSP页面中的pageContext对象，在EL表达式可以通过pageContext隐含对象访问其他JSP隐含对象，这也是将pageContext对象也作为EL表达式中的一个隐含对象的主要原因。可以通过pageContext隐含对象来访问request, response, servletContext和servletConfig等JSP内置对象。

<%@ page contentType="text/html;charset=gb2312" isELIgnored="false"%>

请求URI为：${pageContext.request.requestURI}<hr />

Content-Type响应头为：${pageContext.response.contentType}<hr />

服务器信息为：${pageContext.servletContext.serverInfo}<hr />

Servlet注册名为：${pageContext.servletConfig.servletName}

代表特定域属性集合的隐含对象

    pageScope、requestScope、sessionScope和applicationScope这四个隐含对象分别用于访问JSP页面的page, request,session和application四个域中的属性。例如，表达式${pageScope.userName}返回page作用域中的userName属性的值，表达式${sessionScope.bookName｝返回session作用域中的bookName属性的值。

    在EL表达式中也可以不使用这些隐含对象来指定查找域，而是直接引用这些域中的属性名称。例如，表达式${userName}在page, request, session和application这四个作用域内按顺序查找userName属性，直到找到为止。

代表请求参数集合的隐含对象

隐含对象param和paramValues用于获取客户端访问JSP页面时传递的请求参数的值。因为HTTP协议允许一个请求参数名出现多次，即一个请求参数可能会有多个值，所以，EL表达式提供了param和paramValues这两个隐含对象来分别获取请求参数的单个值和所有值。

param隐含对象返回一个参数的单个值，如果同个请求参数有多个值，则返回第一个值。paramValues隐含对象第一个参数值。paramValues隐含对象用于返回一个请求参数的所有值，返回结果为该参数的所有值组成的字符串数组。例如，假设访问JSP页面时传递了两个名称都为"productID"的参数，参数值分别为“123”和"456"，那么，表达式${param.productID}的返回值为字符串“123”，表达式${paramValues.productID)的返回值是一个字符申数组，数组的第一个元素为“123”，可以用表达式${paramValues.productID[0]}来获得，第二个对象为“456”，可以用表达式${paramValues.productID[1]}来获得。

代表HTTP请求消息头集合的隐含对象

隐含对象header和headerValues用于获取客户端访包JSP页面时传递的请求头字段的值。因为HTTP协议允许一些请求头字段可以出现多次，所以，EL表达式提供了header和headerValues这两个隐含对象来分别获取请求头字段的单个值和所有值。

header隐含对象返回一个请求头字段的单个值，如果同一个请求头字段有多个值，则返回第一个值，例如，使用表达式${header.referer}可以非常方便地获得referer请求头字段的值。headerValues隐含对象用于返回一个请求头字段的所有值，返回结果为该请求头字段的所有值组成的字符串数组。

cookie隐含对象

隐含对象cookie是一个代表所有Cookie信息的Map对象，其中Map对象中的各个元素的关键字分别为各个Cookie的名称，值则分别为Cookie名称对应的Cookie对象。使用cookie隐含对象可以访问某个Cookie名称对应的Cookie对象，这些Cookie对象是通过调HttpServletRequest.getCookies()方法得到的，如果多个Cookie信息共用一个名称，则返回Cookie名在Cookie对象数组中对应的第一个Cookie对象。

<%@ page contentType="text/html;charset=gb2312" %>

<%

    response.addCookie(new Cookie("userName", "zxx"));

%>

打印名称为userName的Cookie对象的信息：${cookie.userName}<br>

打印名称为userName的Cookie对象的名称和值：${cookie.userName.name} = ${cookie.userName.value}

initParam隐含对象

servler.xml：

<Context path= "/myapp" docBase="E:\eclipse_workspace\servlet_jsp\myapp" crossContext="true" debug="0" reloadable="true">

    <Parameter name="companyName1" value="XX" override="false"/>

    <Parameter name="companyName2" value="XX" override="true"/>

</Context>

web.xml：

<context-param>

    <param-name>companyName1</param-name>

    <param-value>xxxx</param-value>

</context-param>

${initParam.companyName1} 的返回值为字符串"xxxx"。如果在server.xmlweb.xml文件中都指定了webSite参数，且server.xml文件中的<Parameterr>元素没有定override属性或override属性的值为true，则initParam隐含对象返回web.xml文件中指的参数值。

EL的null处理

l  如果域中没有名称为user的属性，即user变量映射的对象为null，则表达式${user}输出空字符串，而不是输出字符串“null”，显然在浏览中输出空字符串要比输出字符串“null”更友好，这正是使用EL表达式的一个重要好处。

l  如果域中没有名称为user的属性，虽然user变量映射的对象为null，但表达式${user.name}也是输出空字符串，而不是抛出空指针异常。

l  对于EL表达式${cookie.userName}，即使cookie.userName引用的Cookie对象为null,JSP引擎也不会抛出空指针异常，而是输出空字符串。

l  如果EL表达式中的变量确实被映射到了一个JavaBean对象上，而这个JavaBean对象中不存在EL表达式中的变量所引用的属性，那么，JSP引擎就会抛出异常。

EL中的运算符

方括号运算符（[ ]）和点运行符（.）

（1）       这两个运算符都可以访问各个域属性对象中的属性和隐含对象的属性，在这种情况况下，它们的效果相同，可以互换使用。例如，表达式${user.name}和${user["name"])是等效的，都是用于访问存储在某个域中的user属性对象的name属性。

（2）       [ ]运算符还可以访问有序集合（即实现了java.util.List接口的集合）或数组中的指定索引位里的某个元素，例如表达式${users[0]}用于访问集合或数组users中的第一个元素。在这种情况下，EL表达式中只能使用[ ]运算符，而不能使用点运算符。

（3）       [ ]运算符还可以访问Map集合（即实现了java.util.Map接口的集合）指定关键字的某个元素：

<%@ page import="java.util.*"%>

<%

  HashMap map = new HashMap();

  String key = "xxx";

  map.put(key, new Date());

  pageContext.setAttribute("map", map);

%>

${map["xxx"]}

注：EL表达式中不能嵌套JSP脚本，如 ${<%= xx %>}是错误的，另外虽然${"<%= xx %>"}不报错，但Web容器不会去执行 <%= xx %> 脚本，而是直接看作是字符串，所以最终EL表达式不会有任何结果。

另外，发现使用“.”的访问方式也可以访问Map集合中的元素，如上面程序中EL表达式等效于 ${map.xxx}

（4）       [ ]运算符和点运算符可以结合使用。例如，表达式${users[0].userName}可以访问集合或数组中的第一个元素对象的userName属性。

[ ]运算符中还可以使用表达式，如果表达式${a[b]}中的b不是一个字符串常量或数字常量时, 那么EL引擎将把这个b又当作一个EL变量或表达式来看待，表达式${a[b]}的值按如下规则进行计算：

（1）       如果表达式${a}的值为null，则表达式${a[b]}返回空字符串;

（2）       如果表达式${b}的值为null，则表达式${a[b]}返回空字符串;

（3）       如果${a}的值是一个java.util.Map对象，则${b}的值作为Map对象的关键字表达式${a[b]}返回${a}对象中关键字${b}的值；如果${a}对象中不存在关键字${b)，则表表达式${a[b]}返回空字符串。

<%@ page import="java.util.*"%>

<%

  HashMap map = new HashMap();

  String key = "xxx";

  map.put(key, new Date());

  pageContext.setAttribute("map", map);

  pageContext.setAttribute("b", key);

%>

${map[b]}

注：不能这样嵌套${map[${b}]}，虽然看似与${map[b]}等效。

（4）       如果${a}的值是一个List或array对象，则根据EL表达式的转换规则将${b}的值转换为整数，表达式${a[b]}返回List或array对象指定索引位置的值。如果${b}的值不能转换为整数，则表达式${a[b]}发生错误；如果转换成功，但${b}的值小于0或者大于或等于对应的List或array对象的最大脚标，则表达式${a[b]}返回空字符串；如果List或array对象为空，则${a[b]}表达式产生异常。

<%@ page import="java.util.*"%>

<%

  ArrayList list = new ArrayList();

  list.add(new Date());

  pageContext.setAttribute("list", list);

  pageContext.setAttribute("index", "0");

%>

${list[index]}

（5）       如果${a}的值是一个JavaBean对象，则将${b}的值转换为String类型作为对象${a}的属性，如果JavaBean对象有${b}这个属性，则表达式${a[b]}就返回这个属性的值，否则表达式${a[b]}抛异常。

<%@ page import="mypak.*"%>

<%

  TestBean tb = new TestBean();

  tb.setName("jzj");

  pageContext.setAttribute("bean", tb);

  pageContext.setAttribute("attr", "name");

%>

${bean[attr]}

提示：如果在request域中存储了一个名称为“error.info”的属性，在EL表达式中如何访问这个属性的值呢？这显然不能使用${error.info}或{requestScope.error.info}，而是只能使用${requestScope["error.info"]}。

算术运行符

+、-、*、/（div）、%（mod）

${10 / 2}             5.0

${10 div 2}   5.0

${10 % 4}    2

${10 mod 4} 2

比较运行符

==（或eq）、!=（或ne)、<（或lt)、>（或gt)、<=（或le)和>=（或ge）

<%

    pageContext.setAttribute("a", "hello");

    pageContext.setAttribute("b", "hi");

    pageContext.setAttribute("c", new Float(1.0));

    pageContext.setAttribute("d", new Integer(1));

%>

${a eq b}

${a lt b}

${c eq d}

逻辑运行符

&&（and）、||（or）、!（not）

<%

    pageContext.setAttribute("a", "false");

    pageContext.setAttribute("b", "true");

%>

${a and b}

${a or b}

empty运行符

检查某个变量是否为“null”或“空”。

表达式${empty A}按如下规则计算其返回值：

·当A指向的对象为加null时，表达式${empty A}返回true;

·当A是空字符串时，表达式${empty A}返回true;

·当A是集合（List、Map）或数组时，如果A中没有任何元素，表达式${empty A}返回true;

EL自定义函数

EL自定义函数就是在EL表达式中调用的某个Java类的静态方法，这个Java类的静态方法需要在Web应用程序中专门进行配置，才可以被EL表达式调用。

${namespace:trans(content)}

一般来说，EL自定义函数开发与应用包括以下三个步骤：

1)        编写EL自定义函数映射的Java类中的静态方法

package util;

public final class HTMLFilter {

    public static String filter(String message) {

       if (message == null) {

           return (null);

       }

       char content[] = new char[message.length()];

       message.getChars(0, message.length(), content, 0);

       StringBuffer result = new StringBuffer(content.length + 50);

       for (int i = 0; i < content.length; i++) {

           switch (content[i]) {

           case ‘<‘:

              result.append("&lt;");

              break;

           case ‘>‘:

              result.append("&gt;");

              break;

           case ‘&‘:

              result.append("&amp;");

              break;

           case ‘"‘:

              result.append("&quot;");

              break;

           default:

              result.append(content[i]);

           }

       }

       return (result.toString());

    }

}

2)        编写标签库描述符(tld)文件，在tld文件中描述自定义函数

为了能名让一个Java类的静态方法可以被EL表达式调用，需要在一个标签库描述文件（tld）中对EL自定义函数进行描述，以将静态方式映射成一个EL自定义函数。标签库描述符文件是一个XML格式的文件，它的扩展名为 .tld。标签库描述文件主要是用于自定标签，但也可以用来描述EL自定义函数。

<?xml version="1.0" encoding="ISO-8859-1" ?>

<taglib xmlns="http://java.sun.com/xml/ns/j2ee"

       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

       xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee

       http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"

       version="2.0">

    <tlib-version>1.0</tlib-version>

    <short-name>function</short-name>

    <uri>http://www.it315.org/function</uri>

    <function>

       <name>trans</name>

       <function-class>util.HTMLFilter</function-class>

       <function-signature>java.lang.String filter(java.lang.String)

           </function-signature>

    </function>  

</taglib>

<uri>元素用指定该TLD文件的URI,在JSP文件中需要通过这个URI来引入该标签库描述文件。

<function>元素用于描述一个EL自定义函数，其中，<name>子元素用于指定EL自定义函数的名称，<function-class>子元素用于指定完整的Java类名，<function-signature>子元素用于指定Java类中的静态方法的签名，方法签名必须指明方法的返回值类型及各个参数的类型，各个参数之间用逗号分隔。一个标签库描述文件中可以有多个<function>元素，每个<function>元素分别用于描述一个EL自定义函数，同一个tld文件中的每个<function>元素中的<name>子元素设置的EL函数名称不能相同。

编写完标签库描述文件后，需要将它放里到WEB-INF目录中或WEB-INF目录下的除了classes和lib目录之外的任意子目录中。

3)        在JSP页面中导入和使用自定义函数

JSP2.0中定义了两种格式的JSP页面：标准的JSP页面和JSP文档，与此相对应，在JSP页面中引入标签库描述文件的方式也有两种：

    ·在标准的JSP页面中使用taglib指令；

    ·在jsp文档中使用XML名称空间。

1)        在标准的JSP页面中使用taglib指令

<%@ page contentType="text/html;charset=gb2312" %>

<%@ taglib prefix="it315" uri="http://www.it315.org/function" %>

<%

    String content="<meta http-equiv=‘refresh‘ content=‘0;url=http://www.it315.org‘ />";

    pageContext.setAttribute("content", content);

%>

${it315:trans(content)}

其中，uri属性用于指定所引入的标签库描述符文件中的URl，通常是标签库描述符文件中定义的<uri>元素的内容；prefix属性用于为引入的TLD文件指定一个“引用代号”，在JSP文件中调用TLD文件中的自定义标签或EL自定义函数时，需要将这个“引用代号”作为自定义标签或EL自定义函数的前缀，prefix属性的值可以任意指定，只要与其他taglib指令的prefix属性值不同就可以。

2)        在jsp文档中使用XML名称空间

我们可以使用<jsp:root>作为JSP文档的根元素，所以，可以在根元素<jsp:root>中引入标签库描述符文件。我们也可以将标签库描述符文件声明为默认的名称空间，这样在EL表达式中调用函数时就不用指定名称空间前缀了。

<?xml version="1.0" encoding="utf-8" ?>

<jsp:root xmlns:jsp="http://java.sun.com/JSP/Page"

          xmlns="http://www.it315.org/function"

           version="2.0">      

    <jsp:scriptlet>

       <![CDATA[

       String content=

       "<meta http-equiv=‘refresh‘ content=‘0;url=http://www.it315.org‘ />";

       pageContext.setAttribute("content", content);

       ]]>

    </jsp:scriptlet>

    <jsp:text>

       ${trans(content)}

    </jsp:text>

</jsp:root>

自定义标签

可重用性

标签的几种形式

空标签

<tag:example/>

<tag:example></tag:example>

带体的标签

<tag:example>xxxxxxxxxx</tag:example>

<tag:example>

       <%

              out.print(xxx);

%>

</tag:example>

<tag:example>

       <%=value%>

</tag:example>

<tag:example>

       ${value}

</tag:example>

嵌套标签

<tag:example>

       <tag:example>

       body

</tag:example>

</tag:example>

带属性标签

<tag:example attr1="" >

       body

</tag:example>

简单开发与应用

第一步：编写用作标签处理器的Java类

需实现 javax.servlet.jsp.tagext.Tag 接口，为了简单，可直接继承自TagSupport类。

package org.it315;

import java.io.IOException;

import javax.servlet.jsp.JspException;

import javax.servlet.jsp.tagext.TagSupport;

public class ViewIPTag extends TagSupport {

    public int doStartTag() throws JspException {

       String IP = pageContext.getRequest().getRemoteAddr();

       try {

           pageContext.getOut().write(IP);

       } catch (IOException e) {

           e.printStackTrace();

       }

       return super.doStartTag();

    }

}

第二步：编写标签库描述文件

<taglib xmlns="http://java.sun.com/xml/ns/j2ee"

        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

        xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee

        http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"

        version="2.0">     <!--TLD文件的文件头，这部分信息通常是固定不变的-->

    <tlib-version>1.0</tlib-version>    <!--指定标签库的版本号-->

    <short-name>SimpleTag</short-name>  <!--指定标签库的名称-->

    <uri>/taglib</uri>       <!--指定该标签库的URI-->

    <tag>                           <!--注册一个自定义标签-->

    <name>viewIP</name>      <!--指定自定义标签的注册名称-->

       <!--指定标签的标签处理器类-->

       <tag-class>org.it315.ViewIPTag</tag-class>

       <!--指定标签体的类型，empty表示无标签体-->

       <body-content>empty</body-content>       

    </tag>

</taglib>

<body-content>元素有以下四个取值：

．empty

  表示在JSP页面中使用自定义标签时不能设置其标签体，否则JSP引擎会报错。

．JSP

  表示自定义标签的标签体可以是任意JSP页面元素，注意JSP必须是大写。

．scriptless

  表示自定义标签的标签体可以包含除JSP脚本元素之外的任意JSP页面元素。

．tagdependent

  指JSP引擎对标签体内容不进行任何语义的解析，而是直接把标签体内容原封不动地输出给客户端或交给标签处理器自己去处理。例如，如果希望JSP引擎不要将标  签体中的“${...}”当作EL表达式处理，不要将标签体中的“<...>”当作标签处理，  不要将标签体中的“<%...%>”当作JSP脚本处理，而是将它们当作普通字符文本，那么，就应该设置<body-content>元素内容的值为tagdependent。

第三步：部署和安装自定义标签库

将.tld 文件放里到WEB-INF目录中或WEB-INF目录下的除了classes和lib目录之外的任意子目录中。

第四步：在JSP页面中导入和使用自定义标签

<%@ page contentType="text/html;charset=gb2312" %>

<%@ taglib uri="/taglib" prefix="it315" %>

<H1>您的IP地址是：<it315:viewIP/></H1>

自定义标签API

JspTag接口

JspTag接口是所有自定义标签的父接口，它是JSP 2.0中新定义的一个标记接口，没有任何属性和方法。JspTag接口有Tag和SimpleTag两个直接子接口，JSP 2.0以前的版本中只有Tag接口，所以把实现Tag接口的自定义标签也叫做传统标签，把实现SimpleTag接口的自定义标签叫做简单标签。本书中如果没有特别说明，自定义标签泛指传统标签。

Tag接口

Tag接口是所有传统标签的父接口，其中定义了两个重要方法(doStartTag、doEndTag)方法和四个常量 (EVAL_BODY_INCLUDE、EVAL_PAGE、SKIP_BODY、SKIP_PAGE)，这两个方法和四个常量的作用如下：

1.         Web容器在解释执行JSP页面的过程中，遇到自定义标签的开始标记就会去调用标签处理器的doStartTag方法，doStartTag方法执行完后可以向Web容器返回常量EVAL_BODY_INCLUDE或SKIP_BODY，如返回EVAL_BODY_INCLUDE , Web容器就会接着执行自定义标签的标签体；如果返回SKIP_BODY，Web容器就会忽略自定义标签的标签体，直接解释执行自定义标签的结束标记。

2.         Web容器解释执行到自定义标签的结束标记时，就会调用标签处理器的doEndTag方法，doEndTag方法执行完后可以向Web容器返回常EVAL_PAGE或SKIP_PAGE。如果返回常EVAL_PAGE，Web容器就会接着执行JSP页面中位于结束标记后面的JSP代码；否则Web容器就会忽略JSP页面中位于结束标记后面的所有内容，例如，<jsp:forward>标准标签会导Web容器忽略JSP页面中位于该标签后面的内容，这正是基于这个原理的一种具体应用。

从doStartTag和doEadTag方法的作用和返回值的作用可以看出，开发自定义标签时可以在doStartTag方法和doEndTag方法体内编写合适的Java程序代码来实现具体的功能，通过控制doStartTag方法和doEndTag方法的返回值，还可以告诉Web容器是否执行自定义标签中的标签体内容和JSP页面中位于自定义标签的结束标记后面的内容。

IterationTag接口

    IterationTag接口继承了Tag接口，并在Tag接口的基础上增加了一个doAfterBody方法和一个EVAL_BODY_AGAIN常量。实现IterationTag接口的标签除了可以完成Tag接口所能完成的功能外，还能够通知Web容器是否重复执行标签体内容。对于实现了IterationTag接口的自定义标签，Web容器在执行完自定义标签的标签体后，将调用标签处处理的doAfterBody方法，doAfterBody方法可以向Web容器返回常量EVAL_BODY_AGAIN或SKIP_BODY。如果返回EVAL_BODY_AGAIN，Web容器就会把标签体内容再重复执行一次，执行完后接着再调用doAfterBody方法，如此往复，直到doAfterBody方法返回常量SKIP_BODY, Web容器才会开始处理标签的结

束标记和调用doEndTag方法。

    可见，开发自定义标签时，可以通过控制doAfterBody方法的返回值来告诉Web容器是否重复执行标签体内容，从而达到循环处理标签体内容的效果。例如，可以通过一个实现IterationTag接口的标签来对一个集合中的所有元素进行迭代，在标签体中输出每次迭代到的元素。

在JSP API中提供了一个IterationTag接口的实现类TagSupport，用户开发实现Tag或IterationTag接口的标签时，可以继承这个类来简化自己的开发工作。注意：TagSupport类实现的doStartTag方法的返回值为SKIP_BODY，即标签处理器直接继承TagSupport类的doStartTag方法时，Web容器将忽略标签体的内容，而不向浏览器输出标签体内容，TagSupport类实现的doAfterBody方法的返回值为SKIP_BODY，doEndTag方法的返回值为EVAL_PAGE。

BodyTag接口

BodyTag接口继承了IterationTag接口，并在IterationTag接口的基础上增加了两个方法（setBodyContent, doInitBody）和一个EVAL_BODY_BUFFERED常量（注，EVAL_BODY_TAG常量已被废弃）。实现BodyTag接口的标签除了可以完成IterationTag接口所能完成的功能，还可以对标签体内容进行修改。对于实现了BodyTag接口的自定义标签，标签处理器的doStartTag方法不仅可以返回常量 EVAL_BODY_INCLUDE或SKIP_BODY，还可以返回常量EVAL_BODY_BUFFERED。如果doStartTag方法返回EVAL_BODY_BUFFERED, Web容器就会创建一个专用于捕获标签体运行结果的BodyContent对象，然后调用标签处理器的setBodyContent方法将BodyContent对象的引用传递给标签处理器，Web容器接着将标签体的执行结果写入到BodyContent对象中。在标签处理器的后续事件方法中，可以通过先前保存的BodyContent对象的引用来获取标签体的执行结果，然后调用BodyContent对象特有的方法对BodyContent对象中的内容（即标签体的执行结果）进行修改和控制其输出。

JSP API中提供了BodyTag接口的实现类BodyTagSupport，用户开发实现BodyTag口的标签时，可以继承这个类简化自己的开发工作。BodyTagSupport类实现的doStartTag方法的返回值为EVAL_BODY_BUFFERED，Web容器将创建一个BodyContent对象，并按照BodyTag接口的执行顺序依次调用标称签处理器的方法。与TagSupport类一样，doAfterBody方法的返回值为SKIP_BODY，doEndTag方法的返回值为EVAL_PAGE。

doStartTag、doAfterBody、doEndTag返回值总结

自定义标签的基本应用

Tag接口

javax.servlet.jsp.tagext.Tag接口是所有传统标签的父接口，它定义了JSP页面与标签处理器之间的基本通信规则。JSP引擎将JSP页面中的自定义标签翻译成Servlet的源文件时，首先创建标签处理器类的实例对象，然后按照JSP规范定义的通信规则依次调用它的方法。Tag接口中定义了如下一些方法：setPageContext、setParent、doStartTag、doEndTag、release，JSP按照这些方法的排列顺序对它们依次进行调用。

setPageContext(PageContext pc)：Web容器实例化标签处理器后，将调用标签处理器类的setPageContext方法，将代表JSP页面的pageContext对象传递给标签处理器，标签处理器以后可以通过这个pageContext对象与JSP页面进行通信。

setParent(Tag t)：Web容器调用标签处理器类的setPageContext方法之后，接着将调用标签处理器类的setParent方法将当前标签的父标签对应的标签处理器对象传递给当前标签处理器，如果当前标签没有父标签，则传递给setParent方法的参数值为null。

int doStartTag()：Web容器调用了setPageContext方法和setParent方法之后，接着将调用所设置的各个标签属性对应的setter方法，然后调用标签处理器中的doStartTag方法。doStartTag方法执行完后返回一个int类型常量，当返回EVAL_BODY_INCLUDE时，Web容器会接着执行自定义标签的标签体，当返回SKIP_BODY时，Web容器不执行标签体，而是直接调用代表结束标记的doEndTag方法。

int doEndTag()：Web容器执行完自定义标签的标签体后，接着就会去调用标签处理器中的doEndTag方法。doEngTag方法执行完后返回一个int类型常量，当返回EVAI_PAGE时，Web容器会接着执行JSP页面中位于结束标记后面的其他JSP代码，当返回SKIP_PAGE时，结束标记后面的所有JSP代码都不会被Web容器执。

release()： JSP规范定义Web容器必须在标签处理器对象被垃圾回收器回收之前调用其release方法，以便自定义标签在该方法中释放其所占用的相关资源。但release方法的具体调用时间通常由具体的Web容器厂商决定，也就是说Web容器执行完自定义标签后可以暂时不调用它的release方法。

控制是否执行标签体内容

public class DisplayUserInfoTag extends TagSupport

{

       public int doStartTag() throws JspException

       {

              HttpSession session = pageContext.getSession();

              String username = (String)session.getAttribute("user");

              if(username != null)

              {

                     return EVAL_BODY_INCLUDE;

              }

              else

              {

                     return SKIP_BODY;

              }

       }

}

<taglib>

       ……

       <tag>

             <name>displayUserInfo</name>

             <tag-class>org.it315.DisplayUserInfoTag</tag-class>

             <body-content>JSP</body-content>

       </tag>

</taglib>

<it315:displayUserInfo>

       <br>您的姓名是：${user}

</it315:displayUserInfo>

控制是否执行JSP页面的内容

public class ValidateTag extends TagSupport

{

       public int doEndTag() throws JspException

       {

              HttpServletRequest req = (HttpServletRequest)pageContext.getRequest();

              String referrer = req.getHeader("referer");

              String sitePart = "http://" + req.getServerName();

              if(referrer!=null && referrer.startsWith(sitePart))

              {

                     return EVAL_PAGE;

              }

              else

              {

                     try

                     {

                            pageContext.getOut().write("对不起，您的访问方式不合法！");

                     }

                     catch (IOException e)

                     {

                            e.printStackTrace();

                     }

                     return SKIP_PAGE;

              }

       }

}

<taglib>

       ……

       <tag>

             <name>validate</name>

            <tag-class>org.it315.ValidateTag</tag-class>

             <body-content>empty</body-content>

       </tag>

</taglib>

<%@ taglib uri="/taglib" prefix="it315" %>

<it315:validate/>

如果您看到了这些内容，说明本JSP页面已经正常执行完毕！

自定义标签的属性

定义标签属性

1、  在标签处理器类中编写每个属性对应的setter方法

与JavaBean的属性定义方式相同。如属性名为url，则标签处理器必须提供一个与之对应的setUrl方法。在调用setParent()方法之后，在调用doStartTag()方法之前，依次调用标签设置的每个属性所对应的setter方法，将各个属性值传递给标签处理器类。

2、  在TLD文件中定义属性

    <tag>                      

       ...

       <attribute>

           <name>attr1</name>

           <required>true</required>

           <rtexprvalue>true</rtexprvalue>

           <type>java.languag.String</type>

       </attribute>

    </tag>

rtexprvalue元素用于指定属性值是一个静态值或动态值，默认为false，表示只能为该属性指定静态文本值。如果为true，属性值可以是动态的，如 <%= value%>。这些属性都不是必须的。

public class ValidateTag extends TagSupport {

       private String url;

       public void setUrl(String url) {

              this.url = url;

       }

       public int doEndTag() throws JspException {

              HttpServletRequest req = (HttpServletRequest) pageContext.getRequest();

              String referrer = req.getHeader("referer");

              String sitePart = "http://" + req.getServerName();

              if (referrer != null && referrer.startsWith(sitePart)) {

                     return EVAL_PAGE;

              } else {

                     try {

                            pageContext.forward(url);

                     } catch (Exception e) {

                            e.printStackTrace();

                     }

                     return SKIP_PAGE;

              }

       }

}

<taglib>

       ……

       <tag>

             <name>validate</name>

            <tag-class>org.it315.ValidateTag</tag-class>

             <body-content>empty</body-content>

           <attribute>

                  <name>url</name>

                  <required>true</required>

           </attribute>

       </tag>

</taglib>

<%@ taglib  uri="/taglib.tld" prefix="it315" %>

<it315:validate url="visitor.html"/>

如果您看到了这些内容，说明本JSP页面已经正常执行完毕！

动态属性