JSTL 入门: 探讨 core

来源：百度文库 编辑：神马文学网 时间：2024/04/28 07:24:32
使用定制标记进行流控制和 URL 管理

文档选项

将此页作为电子邮件发送

级别： 初级
Mark A. Kolb (mak@taglib.com), 软件工程师
2003 年 6 月 21 日
顾名思义，JSP 标准标记库（JSP Standard Tag Library，JSTL） core 库为一些基本功能（如，管理限定了作用域的变量和与 URL 交互等）和基本操作（如，迭代和条件化）提供了定制标记。这些标记不仅可以由页面设计人员直接利用，而且还为与其它 JSTL 库相结合从而提供更复杂的表示逻辑奠定了基础。Mark Kolb 在本文中继续对 JSTL 和 core 库进行探讨，研究用标记来协助流控制和 URL 管理。
通过阅读本系列的第一篇文章，您对 JSTL 有了初步的了解。我们描述了使用其 表达式语言（EL）来访问数据和操作数据。正如您所了解的那样，EL 用来为 JSTL 定制标记的属性赋予动态值，因此，它所起的作用与 JSP 表达式一样，为内置操作及其它定制标记库指定请求时的属性值。
为了演示 EL 的用法，我们介绍了 core 库中的三个标记： 、 和 。 和 用于管理限定了作用域的变量；而 用于显示数据，尤其是显示用 EL 计算出的值。在此基础上，接下来本文把注意力集中在 core 库的其余标记上，这些标记可以大致归为两大类别：流控制和 URL 管理。
为了演示 JSTL 标记，我们将使用来自一个工作应用程序的示例，本系列中余下的文章都将使用此应用程序。由于基于 Java 的 Weblog 日渐流行及为人们所熟悉，因此我们将出于此目的使用一个简单的基于 Java 的 Weblog；参阅参考资料以下载该应用程序的 JSP 页面和源代码。Weblog（也称为 blog）是一种基于 Web 的简短注释的日志，这些注释是有关 Weblog 的作者所感兴趣的主题，通常带有与 Web 上其它地方的相关文章及讨论的链接。图 1 中显示了该应用程序正在运行时的抓屏。

虽然完整的实现需要二十四个 Java 类，但在表示层中却只涉及 Weblog 应用程序中的两个类， Entry 和 UserBean 。这样，对于理解 JSTL 示例而言，只有这两个类比较重要。图 2 显示了 Entry 和 UserBean 的类图。

Entry 类表示 Weblog 中一个标有日期的项。其 id 属性用于在数据库中存储及检索该项，而 title 和 text 属性则表示该项的实际内容。 created 和 lastModified 属性引用了 Java 语言中 Date 类的两个实例，分别用来表示最初创建该项的时间和最后编辑该项的时间。 author 属性引用了标识该项的创建者的 UserBean 实例。
UserBean 类存储了有关应用程序的已认证用户的信息，如用户名、全名和电子邮件地址。该类还包含一个用于与相关数据库进行交互的 id 属性。其最后一个属性 roles 引用一列 String 值，这列值标识与相应用户相关的、特定于应用程序的角色。对于 Weblog 应用程序，相关的角色是“User”（所有应用程序用户常用的缺省角色）和“Author”（该角色指定可以创建和编辑 Weblog 项的用户）。




回页首
由于可以用 EL 替代 JSP 表达式来指定动态属性值，因此页面创作人员无需使用脚本编制元素。因为脚本编制元素可能是引起 JSP 页面中维护问题的主要原因，所以 JSTL 的主要优点就在于提供了这样简单（且标准）的替代方法。
EL 从 JSP 容器检索数据，遍历对象层次结构，然后对结果执行简单的操作。不过，除了访问和操作数据之外，JSP 脚本编制元素的另一个常见用法是流控制。尤其是，页面创作人员常借助 scriptlet 来实现迭代或条件内容。然而，因为这样的操作超出了 EL 的能力，所以 core 库提供了几个定制操作来管理流控制，其形式有迭代、条件化和异常处理。
在 Web 应用程序环境中，迭代主要用于访存和显示数据集，通常是以列表或表中的一系列行的形式显示。实现迭代内容的主要 JSTL 操作是 定制标记。该标记支持两种不同样式的迭代：整数范围上的迭代（类似 Java 语言的 for 语句）和集合上的迭代（类似 Java 语言的 Iterator 和 Enumeration 类）。
进行整数范围迭代用到了清单 1 中所示的 标记的语法。 begin 和 end 属性要么是静态整数值，要么是可以得出整数值的表达式。它们分别指定迭代索引的初始值以及迭代索引的终止值。当使用 在整数范围内进行迭代时，这两个属性是必需的，而其它所有属性都是可选的。
body content
当出现 step 时，它也必须是整数值。它指定每次迭代后索引的增量。这样，迭代索引从 begin 属性的值开始，以 step 属性的值为增量进行递增，在迭代索引超过 end 属性的值时停止迭代。注：如果省略了 step 属性，那么步长缺省为 1。
如果指定了 var 属性，那么将会创建一个带有指定名称的并限定了作用域的变量，并将每次迭代的当前索引值赋给该变量。这一限定了作用域的变量具有嵌套式可视性 ― 只可以在 标记体内对其进行访问。（我们很快将讨论可选属性 varStatus 的用法。）清单 2 显示了对一组固定整数值进行迭代的 操作示例。
Value Square

如图 3 中所示，上面的示例代码生成了一张表，显示前五个偶数及其平方。这是通过将 begin 和 step 属性值指定为 2，而将 end 属性值指定为 10 实现的。此外，用 var 属性创建用于存储索引值的限定了作用域的变量， 标记体内引用了该变量。尤其是，使用了一对 操作来显示索引及其平方，其中索引的平方是使用一个简单的表达式计算得来的。

在对集合的成员进行迭代时，用到了 标记的另一个属性： items 属性，清单 3 中显示了该属性。当使用这种形式的 标记时， items 属性是唯一必需的属性。 items 属性的值应该是一个集合，对该集合的成员进行迭代，通常使用 EL 表达式指定值。如果变量名称是通过 标记的 item 属性指定的，那么对于每次迭代该已命名变量都将被绑定到集合后续元素上。
body content
标记支持 Java 平台所提供的所有标准集合类型。此外，您可以使用该操作来迭代数组（包括基本类型数组）中的元素。表 1 列出了 items 属性所支持的所有值。正如表的最后一行所指出的那样，JSTL 定义了它自己的接口 javax.servlet.jsp.jstl.sql.Result ，用来迭代 SQL 查询的结果。（我们将在本系列后面的文章中详细讨论这一功能。）
items 的值 所产生的 item 值
java.util.Collection 调用 iterator() 所获得的元素
java.util.Map java.util.Map.Entry 的实例
java.util.Iterator 迭代器元素
java.util.Enumeration 枚举元素
Object 实例数组 数组元素
基本类型值数组 经过包装的数组元素
用逗号定界的 String 子字符串
javax.servlet.jsp.jstl.sql.Result SQL 查询所获得的行
可以使用 begin 、 end 和 step 属性来限定在迭代中包含集合中哪些元素。和通过 进行数字迭代的情形一样，在迭代集合中的元素时同样要维护一个迭代索引。 标记实际上只处理那些与索引值相对应的元素，这些索引值与指定的 begin 、 end 和 step 值相匹配。
清单 4 显示了用来迭代集合的 标记。对于该 JSP 代码段， entryList 这一限定了作用域的变量被设置成了 Entry 对象列表（确切的说， ArrayList ）。 标记依次处理列表中的每个元素，将其赋给一个限定了作用域的变量 blogEntry ，然后生成两个表行 ― 一个用于 Weblog 项的 title ，另一个则用于该项 text 。这些特性是通过一对带有相应 EL 表达式的 操作从 blogEntry 变量检索得到的。注：由于 Weblog 项的标题和文本都可能包含 HTML 标记，因此这两个 标记的 escapeXml 属性都被设置成了 false。图 4 显示了结果。


不论是对整数还是对集合进行迭代， 剩余的属性 varStatus 所起的作用相同。和 var 属性一样， varStatus 用于创建限定了作用域的变量。不过，由 varStatus 属性命名的变量并不存储当前索引值或当前元素，而是赋予 javax.servlet.jsp.jstl.core.LoopTagStatus 类的实例。该类定义了一组特性，它们描述了迭代的当前状态，表 2 中列出了这些特性。
特性 Getter 描述
current getCurrent() 当前这次迭代的（集合中的）项
index getIndex() 当前这次迭代从 0 开始的迭代索引
count getCount() 当前这次迭代从 1 开始的迭代计数
first isFirst() 用来表明当前这轮迭代是否为第一次迭代的标志
last isLast() 用来表明当前这轮迭代是否为最后一次迭代的标志
begin getBegin() begin 属性值
end getEnd() end 属性值
step getStep() step 属性值
清单 5 显示了关于如何使用 varStatus 属性的一个示例。这个示例修改了清单 4 中的代码，将 Weblog 项的编号添加到显示 Weblog 标题（title）的表行。它是通过为 varStatus 属性指定一个值，然后访问所生成的限定了作用域的变量的 count 特性来实现这一点的。结果显示在图 5 中。
.


除 以外， core 库还提供了另一个迭代标记： 。JSTL 的这个定制操作与 Java 语言的 StringTokenizer 类的作用相似。清单 6 中显示的 标记除了比 的面向集合版本多一个属性之外，其它属性都相同。对于 而言，通过 items 属性指定要标记化的字符串，而通过 delims 属性提供用于生成标记的一组定界符。和 的情形一样，可以使用 begin 、 end 和 step 属性将要处理的标记限定为那些与相应索引值相匹配的标记。
body content
对于包含动态内容的 Web 页面，您可能希望不同类别的用户看到不同形式的内容。例如，在我们的 Weblog 中，访问者应该能够阅读各项，也许还应该能够提交反馈，但只有经过授权的用户才能公布新项，或编辑已有内容。
在同一个 JSP 页面内实现这样的功能，然后使用条件逻辑来根据每条请求控制所显示的内容，这样做常常能够改善实用性和软件维护。 core 库提供了两个不同的条件化标记 ― 和 ― 来实现这些功能。
是这两个操作中较简单的一个，它简单地对单个测试表达式进行求值，接下来，仅当对表达式求出的值为 true 时，它才处理标记的主体内容。如果求出的值不为 true ，就忽略该标记的主体内容。如清单 7 所示， 可以通过其 var 和 scope 属性（它们所起的作用和在 中所起的作用一样）选择将测试结果赋给限定了作用域的变量。当测试代价非常高昂时，这种能力尤为有用：可以将结果高速缓存在限定了作用域的变量中，然后在随后对 或其它 JSTL 标记的调用中检索该结果。
body content
清单 8 显示了与 标记的 LoopTagStatus 对象的 first 特性一起使用的 。如图 6 中所示，在这种情况下，只在 Weblog 项的第一项上显示这组项的创建日期，而不在任何其它项前面重复该日期。


如清单 8 所示， 标记为条件化内容的一些简单情形提供了一种非常简洁的表示法。对于需要进行互斥测试来确定应该显示什么内容的情况下，JSTL core 库还提供了 操作。清单 9 中显示了 的语法。
body content ... body content
每个要测试的条件都由相应的 标记来表示，至少要有一个 标记。只会处理第一个其 test 值为 true 的 标记体内的内容。如果没有一个 测试返回 true ，那么会处理 标记的主体内容。注：尽管如此， 标记却是可选的； 标记至多可有一个嵌套的 标记。如果所有 测试都为 false ，而且又没有给出 操作，那么不会处理任何 标记的主体内容。
清单 10 显示了运用 标记的示例。在这里，检索请求对象而获得协议信息（通过 EL 的 pageContext 隐式对象），并用简单的字符串比较对协议信息进行测试。根据这些测试的结果，会显示相应的文本消息。
This is an insecure Web session. This is a secure Web session. You are using an unrecognized Web protocol. How did this happen?!
最后一个流控制标记是 ，它允许在 JSP 页面内进行初级的异常处理。更确切地说，在该标记的主体内容中产生的任何异常都会被捕获并被忽略（即，不会调用标准的 JSP 错误处理机制）。然而，如果产生了一个异常并且已经指定了 标记的可选属性 var ，那么会将异常赋给（具有页面作用域的）指定的变量，这使得能够在页面自身内部进行定制错误处理。清单 11 显示了 的语法（稍后在清单 18中给出一个示例）。
body content




回页首
JSTL core 库中的其余标记主要是关于 URL。这些标记中的第一个被适当地命名为 标记，用于生成 URL。尤其是， 提供了三个功能元素，它们在为 J2EE Web 应用程序构造 URL 时特别有用：
在前面附加当前 servlet 上下文的名称 为会话管理重写 URL 请求参数名称和值的 URL 编码
清单 12 显示了 标记的语法。 value 属性用来指定基本 URL，然后在必要时标记对其进行转换。如果这个基本 URL 以一个斜杠开始，那么会在它前面加上 servlet 的上下文名称。可以使用 context 属性提供显式的上下文名称。如果省略该属性，那么就使用当前 servlet 上下文的名称。这一点特别有用，因为 servlet 上下文名称是在部署期间而不是开发期间决定的。（如果这个基本 URL 不是以斜杠开始的，那么就认为它是一个相对 URL，这时就不必添加上下文名称。）
...
URL 重写是由 操作自动执行的。如果 JSP 容器检测到一个存储用户当前会话标识的 cookie，那么就不必进行重写。但是，如果不存在这样的 cookie，那么 生成的所有 URL 都会被重写以编码会话标识。注：如果在随后的请求中存在适当的 cookie，那么 将停止重写 URL 以包含该标识。
如果为 var 属性提供了一个值（还可以同时为 scope 属性提供一个相应的值，这是可选的），那么将生成的 URL 赋值给这个限定了作用域的指定变量。否则，将使用当前的 JspWriter 输出生成的 URL。这种直接输出其结果的能力允许 标记作为值出现，例如，作为 HTML 标记的 href 属性的值，如清单 13 中所示。
View sitemap
最后，如果通过嵌套 标记指定了任何请求参数，那么将会使用 HTTP GET 请求的标准表示法将它们的名称和值添加到生成的 URL 后面。此外，还进行 URL 编码：为了生成有效的 URL，将对这些参数的名称或值中出现的任何字符适当地进行转换。清单 14 演示了 的这种行为。

清单 14 中的 JSP 代码被部署到一个名为 blog 的 servlet 上下文，限定了作用域的变量 searchTerm 的值被设置为 "core library" 。如果检测到了会话 cookie，那么清单 14 生成的 URL 将类似于清单 15 中的 URL。注：在前面添加上下文名称，而在后面附加请求参数。此外， keyword 参数值中的空格和 month 参数值中的斜杠都被按照 HTTP GET 参数的需要进行了编码（确切地说，空格被转换成了 + ，而斜杠被转换成了 %2F 序列）。
/blog/content/search.jsp?keyword=foo+bar&month=02%2F2003
当没有会话 cookie 时，生成的结果如清单 16 中所示。同样，servlet 上下文被添加到了前面，而 URL 编码的请求参数被附加到了后面。不过，除此以外还重写了基本 URL 以包含指定的会话标识。当浏览器发送用这种方式重写的 URL 请求时，JSP 容器自动抽取会话标识，并将请求与相应的会话进行关联。这样，需要会话管理的 J2EE 应用程序就无需依赖由应用程序用户启用的 cookie 了。
/blog/content/search.jsp;jsessionid=233379C7CD2D0ED2E9F3963906DB4290 ?keyword=foo+bar&month=02%2F2003




回页首
JSP 有两种内置机制可以将来自不同 URL 的内容合并到一个 JSP 页面： include 伪指令和 操作。不过，不管是哪种机制，要包含的内容都必须属于与页面本身相同的 Web 应用程序（或 servlet 上下文）。两个标记之间的主要区别在于： include 伪指令在页面编译期间合并被包含的内容，而 操作却在请求处理 JSP 页面时进行。
从本质上讲， core 库的 操作是更通用、功能更强大的 版本（好像是 “服用了兴奋剂”的）。和 一样， 也是一种请求时操作，它的基本任务就是将其它一些 Web 资源的内容插入 JSP 页面中。如清单 17 中所示，它的语法非常类似于 的语法。
...
通过 url 属性指定将要导入内容的 URL，这个属性是 的唯一一个必选属性。这里允许使用相对 URL，并且根据当前页面的 URL 来解析这个相对 URL。但是，如果 url 属性的值以斜杠开始，那么它就被解释成本地 JSP 容器内的绝对 URL。如果没有为 context 属性指定值，那么就认为这样的绝对 URL 引用当前 servlet 上下文内的资源。如果通过 context 属性显式地指定了上下文，那么就根据指定的 servlet 上下文解析绝对（本地）URL。
但 操作并不仅仅限于访问本地内容。也可以将包含协议和主机名的完整 URI 指定为 url 属性的值。实际上，协议甚至不仅局限于 HTTP。 的 url 属性值可以使用 java.net.URL 类所支持的任何协议。清单 18 中显示了这种能力。
其中， 操作用来包含通过 FTP 协议访问的文档内容。此外，还使用了 操作，以便在本地处理 FTP 文件传送期间可能发生的任何错误。错误处理是这样实现的：使用 的 var 属性为异常指定一个限定了作用域的变量，然后使用 检查其值。如果产生了异常，那么就会对那个限定了作用域的变量进行赋值：如清单 18 中的 EL 表达式所显示的那样，该变量的值将 不会为空。由于 FTP 文档的检索将会失败，因此会显示有关这种情况的错误消息。
Sorry, the remote content is not currently available.
操作的最后两个（可选的）属性是 var 和 scope 。 var 属性会导致从指定 URL 获取的内容（作为 String 值）被存储在一个限定了作用域的变量中，而不是包含在当前 JSP 页面中。 scope 属性控制该变量的作用域，缺省情况下是页面作用域。如同我们在今后的文章中将要看到的那样，JSTL xml 库中的标记利用了 这种能力，即将整个文档存储在一个限定了作用域的变量中。
还要注意的是，可以使用（可选的）嵌套的 标记来为正在导入的 URL 指定请求参数。与在 中嵌套 标记一样，必要时也要对参数名称和参数值进行 URL 编码。




回页首
最后一个 core 库标记是 。该操作用于向用户的浏览器发送 HTTP 重定向响应，它是 JSTL 中与 javax.servlet.http.HttpServletResponse 的 sendRedirect() 方法功能相当的标记。清单 19 中显示了该标记的 url 和 context 属性，它们的行为分别等同于 的 url 和 context 属性的行为，是嵌套任何 标记的结果。
...
清单 20 显示了 操作，它用一个到指定错误页面的重定向代替了清单 18 中的错误消息。在该示例中， 标记的用法与标准 操作的用法类似。不过请回忆一下：通过请求分派器进行转发是在服务器端实现的，而重定向却是由浏览器来执行的。从开发人员的角度来讲，转发比重定向更有效率，但 操作却更灵活一些，因为 只能分派到当前 servlet 上下文内的其它 JSP 页面。

从用户的角度来看，主要区别在于重定向会更新浏览器所显示的 URL，并因此影响书签的设置。转发却不这样，它对最终用户是透明的。这样，选择 还是 还取决于所期望的用户体验。




回页首
JSTL core 库含有多种通用的定制标记，广大的 JSP 开发人员都会使用这些标记。例如，URL 和异常处理标记很好地补充了现有的 JSP 功能，如 和 操作、 include 伪指令以及 page 伪指令的 errorpage 属性。迭代和条件操作使得无需脚本编制元素就能够实现复杂的表示逻辑，尤其在将变量标记（ 和 ）与 EL 相结合使用时更是如此。
您可以参阅本文在 developerWorks 全球站点上的英文原文.
本系列的第一篇文章JSTL 入门：表达式语言（ developerWorks，2003 年 2 月）介绍了 JSTL，并详细讨论了表达式语言及 core 库中的几个标记。
下载 Weblog 示例应用程序的源代码。
Sun 的JSP 标准标记库产品页面是深入了解 JSTL 的不错的起点。
JSTL 1.0 规范是 EL 和四个 JSTL 标记库的最权威的参考资料。
Jakarta Taglibs项目是 JSTL 1.0 参考实现的主页。
Shawn Bayern 撰写的JSTL in Action （Manning，2002 年）出色地讨论了由参考实现领导编写的全部 JSTL 功能。
David Geary 是一位很受欢迎的 Java 编程方面的作者，他还著有一部关于 JSTL 的书籍，名为Core JSTL 。
JSPTags.com是一个 JSP 参考资料目录，它尤其着重于定制标记库方面的内容。
Sun 的Java Web Services Tutorial的一部分也涉及到了对 JSTL 的讨论。
通过学习“Using JSPs and custom tags within VisualAge for Java and WebSphere Studio”（WebSphere 开发者园地），动手实践 WBOnline，这篇文章演示了如何使用 servlet、JSP 页面及定制标记库。
通过 Jeff Wilson 的优秀文章“使用定制标记控制 JSP 页面”（ developerWorks，2002 年 1 月）来学习关于定制标记库的全部内容。
Noel Bergman 的文章“JSP 标记库：着意设计的更好的可用性”（ developerWorks，2001 年 12 月）向您显示了声明性标记是如何帮助改善 JSP 页面的可用性。
在developerWorksJava 技术专区 可以找到数百篇有关 Java 技术的参考资料。

 

Mark Kolb 是一位在德克萨斯州奥斯汀市（Austin）工作的软件工程师。他常就服务器端 Java 这一主题在业界演讲，而且还是Web Development with JavaServer Pages, 第二版 一书的合著者。可以通过mak@taglib.com与 Mark 联系。
JSTL 入门: 探讨 core JSTL 入门: 探讨 core [精华] JSTL 入门(2)：探讨 core——使用定制标记进行流控制和 URL 管理 JSTL 入门: 表达式语言 JSTL 入门: 表示就是一切 AIX 下的 core dump 分析入门 JSTL 关于JSTL JSTL详解 jstl - Tomcat中安装JSTL jstl标签注意问题 JSTL详解(六) JSTL详解(七) JSTL详解(八) JSTL详解(九) Tomcat中安装JSTL JSTL标签的使用 JSTL详解(一)1 jstl fmt功能说明 JSTL详解4 JSTL之c标签 地心末日 (The Core) 遠端安裝 Fedora Core Linux