JSTL改进JSP来简化网页的实现过程[z]

概述

Java Server Pages (JSP) 标准标记库 (JSTL)的版本的发布对于JSP/servlet开发者来说是一个重大的进展。有了一个表达语言（EL）和一组四种强大的、易于学习的标准标记库，JSTL极有可能不久后成为实现动态的、基于Java的站点的主要方法。

1996年对JSP servlet的介绍使得Java成为动态网页开发的合理的选择。随后出现的Java服务器页(JSP)是走向快速的、可维护的Java网页实现过程的合理进化的一步，紧接着就出现了JSP标记的支持。但是2002中期的JSTL(JSP标准标记库)的发布才是进一步加速和简化开发过程最大的一步。

在本文中，我解释了JSTL的功能，也涵盖了你启动JSTL所需的每件事情。假设你有了对Java、JSP、XML和安装一个Web容器的基本理解。如果你对这些主题感到陌生，你可以在Resources（http://www.javaworld.com/javaworld/jw-02-2003/jw-0228-jstl.html?#resources#resources）上浏览一下背景参考。在下面的阐述中，假定你有XML和SQL的知识。

安装JSTL支持

对于我们的JSTL安装例子来说，我们使用Tomcat 4.1（尽管任意支持Servlet 2.3和JSP1.2说明的servlet容器都应该能工作）。首先，下载Tomcat 4.1并且按指示进行安装（注意：JSTL需要一个JSP1.2 Web容器）。

用tomcat4 start程序启动Tomcat，并且运行index.html页来确保Tomcat是激活的、且运行良好。

接下来，安装JSTL支持，你可以从Jakarta站点下载JSTL支持，（http://www.javaworld.com/javaworld/jw-02-2003/jw-0228-jstl.html?#resources#resources）并按照下面步骤：

1.从Jakarta站点下载JSTL检索、解压/脱档该文件。（http://www.javaworld.com/javaworld/jw-02-2003/jw-0228-jstl.html?#resources）

2.复制你已经解压为common/lib的jar文件到你的Tomcat安装路径中（尽管我们的项目不需要所有的jar文件）；这使得JSTL文件适用于你的任意Web应用。

3.对于任意你想使用JSTL的Web应用来说，复制.tld文件到你的Web应用的WEB-INF目录下。

4.对于你的JSTL的Web应用，编辑web.xml并添加下列输入：

<taglib>
  <taglib-uri>http://java.sun.com/jstl/fmt</taglib-uri>
  <taglib-location>/WEB-INF/fmt.tld</taglib-location>
  </taglib>
  <taglib>
   <taglib-uri>http://java.sun.com/jstl/core</taglib-uri>
   <taglib-location>/WEB-INF/c.tld</taglib-location>
  </taglib>
  <taglib>
   <taglib-uri>http://java.sun.com/jstl/sql</taglib-uri>
   <taglib-location>/WEB-INF/sql.tld</taglib-location>
  </taglib>
  <taglib>
   <taglib-uri>http://java.sun.com/jstl/x</taglib-uri>
   <taglib-location>/WEB-INF/x.tld</taglib-location>
  </taglib>


这些输入让你的Web应用可使用JSTL标记库的表达语言（EL）版本。这些输入的位置有关系！如果你不肯定将他们输入到何处，关于web.xml选项和顺序的权威性指导在文档类型定义（DTD）中定义过：http://java.sun.com/j2ee/dtds/web-app_2_2.dtd。

5.当你创建了一个使用JSTL的JSP页时，将他输入到你的Web应用的主目录下，就像其它JSP和HTML页一样。你可以为该页任意取名，但是它必须有一个.jsp的扩展名。

基础原理

首先，所有的JSTL也是JSP页，JSTL只是JSP功能的一个超集。

同样，所有的JSTL标记是有效的XML。这意味着：如果你将JSTL标记之外的内容当作临时文本（通常是HTML）时，剩下的JSTL标记必须当作合法的XML来解释。这里有一些隐含的规则，它要求大部分XML语法都是正确的。

JSTL提供一组四个标准标记库（core核心、internationalization/format国际标准化/格式、XML和SQL）并支持EL。JSTL和EL的基本设计目的是简化网页开发和实现。

在本文中，我们遵循JSTL说明书的命名规则，并且把JSTL标记当作动作。一个JSTL标记对应于某个动作；调用动作明确的提醒我们：他们添加动态行为到一个另外的静态页上。

JSTL标记库有两个版本：一个用你以前使用的方法将JSP表达式插入，如<％= . . . ％>，另一个使用一个JSTL EL.我会在后面进一步讨论在JSTL中的EL支持。

EL支持

要理解当前JSTL对EL支持的状态，让我们检查相关的说明书是怎样处理的。Java说明书请求（JSR）专家组成员决定：由于某种原因，EL规范说明应该是JSP说明书的一部份，而不是JSTL说明书的一部分。EL完整的说明书成为JSP2.0的一部分。因为JSTL1.0在JSP1.3之前已经完成，JSTL作者不得不对用于JSTL1.0的EL支持实现做一个合理的猜测（结果可能是相当好的）。一个JSTL维护版本将与JSP1.3说明书保持一致，并为了使EL适合JSP1.3说明书，JSTL维护版本做了一些修正。

本文描述的EL概要可能在即将发布的JSTL版本中有一点改动，但是任何改动都是微小的。

EL用于简单的语法定义了一套功能强大的语言，它很容易学习。它融合着JavaScript语言和Perl语言较好的部分的一些风格。EL表达式，集成了来自四种标准标记库的JSTL标记，提供了一个巨大的、灵活的属性集。

所有的EL表达式都被${}括起来。JSTL中的表达式总是JSTL标记中的属性值的一部分。表达式可以是属性的一部分或者合并和嵌入到一个字符串直接量中。JSTL属性也可以包含简单的字符串直接量。在接下来的JSTL中，我们在一个来自核心库的c:out动作中说明每种情况，这个核心库将它的value属性值送到JSP输出上：

<c:out value="${anExpression}"/>
<c:out value="literalText${anExpression}${anotherExpression}"/>
<c:out value="literalText"/>


EL也定义了一套规则用于强制表达式中的值转换为上下文相对应的类型。我们在这里不详细讨论这些规则；然而，它的方法与用Perl语言定义的方式非常相似（就像Perl语言中的做法一样，该方法理所当然的运行良好，但是，偶尔，也会出现可能不是你十分想要的那种结果，但你可以接受）。

EL为访问对象属性、集合元素、一组隐藏对象以及使用相关的、逻辑的和算术的操作符提供了支持。对于索引的属性来说，包括数组和java.util.List类在内，元素可用下列语法访问：

${alist[4]}
${aList[someVariable]}


JavaBean属性和java.util.Map元素（它代表一系列名字/值对）都可以使用下列方法的一个访问得到。在以下的开头两个表达式里，我们可以访问到一个用JavaBean语言命名为aProperty的属性或者用关键字aProperty访问到一个Map实体。在第三个表达式中（注意：我已经省略了引号），我们用保存在变量aVariableContainingPropertyName中的一个名字访问了在anObject之内的一个元素:

${anObject.aProperty}
${anObject["aPropertyName"]}
${anObject[aVariableContainingPropertyName]}


在EL中定义了许多隐藏变量：

●pageContext：用于该网页的pageContext对象

●pageScope, requestScope, sessionScope, 和 applicationScope：这些是映射这些范围的每一个变量到值上的Map集。

●param 和 paramValues：用页访问传递的参数，与在JSP中一样

●header 和 headerValues：用页请求传递的头，与在JSP中一样

●cookie：Map映射cookie程序到特定的cookie对象上

EL定义了全套与你在Java中非常熟悉的那些完全对应的操作符。算法操作符包括+、 -、 *、 / (或 div)、 和％ (或 mod)。相关的操作符包括==、！=、<、>、<=、>=，它分别对应于eq、ne、lt、gt、le、和ge。我不想详细阐述这些操作符，因为他们都能自我说明。

JSTL标记库

至此，我已经解释了一些基本原理并且涵盖了EL语法。我要专门讨论四种JSTL标记库。我主要讨论核心库，因为它是你一定要使用的；但是，我也会详细的讨论其余几个，以便你能启动它。

首先，尽管我应该更多地谈论JSTL标记库的两种风格，我上面提到的每个JSTL标记库以两个版本出现：一个支持褂肊L的表达式；另一个支持标准JSP表达式。当你引入任何标记库到一个JSP页时，你要定义一个前缀，该前缀指定了与库中标记相对应的命名空间。

四种标准标记库，和他们的JSTL规范定义的前缀常规，列表如下。记住：你可以定义自己的前缀，但是这绝对没有什么好处。

四种标准标记库



为了使用页中的核心标记库（ 实际上，你使你的页对标记库的命名空间可见），在你的页首包含下列例子中的指令：

<％@ taglib prefix="c" uri=http://java.sun.com/jstl/core ％>


为了使用该标记库的标记，用你在你的包含语句中设计好的前缀，在你的页中给每个标记加上前缀：

<c:out value="${anExpression}"/>


核心数据库

让我们更详细的测试核心数据库，先看看他最通用的功能。

显示/设定值和异常处理

核心库的最基本的标记是c:out标记，它在页中显示一个EL表达式的值。一个使用c:out的表达式通常是这样：

We have <c:out value="${applicationScope.product.inventoryCount}"
escapeXml="true" default="0"  /> of those items in stock.


上例中，value属性是我们送到页输出的表达式。我也说明了选项escapeXml的属性和默认属性。escapeXml的属性指定了XML字符(<、>、 &、 和 .)是否应该转化为相应的字符实体代码（这样他们可以让这些字符出现在一个HTML页中）；默认属性用于EL不能估算出数值或者数值计算出来为空的情况。

注意：当EL支持完全贯穿整个JSP2.0的时候，你不需要使用c:out动作；你可以仅嵌套JSP表达式直接在页中。

另一个普遍使用的核心动作是c:set，它在页中设定一个变量。你可以用两种方法使用c:set动作，第一种方法设定在var属性中定义的变量到在value属性中定义的值上，方法如下：

<c:set var="customerID" value="$param:customerNumber" scope="session" />


上述的选择项scope属性指定了我们要在会话期范围内设定变量customerID；如果范围没有制定，范围默认为页。

c:set另一个强大的用途就是将c:set标记的体的内容赋给一个指定的变量：

<c:set var="cellContents">
<td>
<c:out value="${myCell}"/>
</td>
</c:set>


在上例中，c:set动作定义了名为cellContents（在页的范围内）的变量，该变量拥有在标记的体中定义的内容。在这种情况下，体定义了一个HTML表格单元格元素，计算体中的c:out动作，并且该计算的结果包括在体中的字符串直接量值。

就像你预想的那样，JSTL进行异常处理有点早。在典型的JSP页中，你有两种异常处理的方法：试图/捕捉直接嵌入到页中的小脚本代码中的块；或者用一个JSP errorPage指令。JSP errorPage指令提供一个良好的捕捉所有异常的方法来处理页中任何可能的异常。JSTL用一个c:catch动作提供一个好的可选择的方式。这个c:catch动作提供一个更细粒度的有效方法来处理异常。而且没有嵌入Java代码到页中。一个c:catch动作是这样的：

<c:catch>
<!--. . . some set of nested JSTL tags below which would be hit on an exception-->
</c:catch>



c:catch动作有一个可选的属性，即一个指向抛出异常的变量。

你可能不怎么愿意使用c:remove标记。这个标记有用于变量名和范围的属性，并且可从指定的范围内删除指定的变量。

流程控制

让我们转为讨论JSTL的流程控制和条件标记。如果你已经用任何一种语言使用了条件和流程控制语句，理论上这里没什么新鲜的东西。

c:if动作处理简单条件语句的测试。计算测试属性中的Boolean表达式的值，如果表达式为真的话，计算体的内容。在下面的动作中，我们也说明了备选项var属性。为了以后的使用，var属性保存测试结果在页（如果没有指定其他scope属性的话）中。

<c:if test="${status.totalVisits == 1000000}" var="visits">
   You are the millionth visitor to our site!  Congratulations!
</c:if>


下面我们展示了用c:choose、 c:when、 和 c:otherwise交换逻辑的JSTL的支持。一组c:when动作可能包括在一个备选的标记内，如果在c:when块中任何表达式计算值为真的话，就不用计算c:choose动作内的测试。如果c:when块中没有一个测试计算值为真的时候：如果出现c:otherwise动作内容时，则计算c:otherwise动作的内容：

<c:choose>
<c:when test="${item.type ==  book }">
...
</c:when>
<c:when test="${item.type ==  electronics }">
...
</c:when>
<c:when test="${item.type ==  toy }">
...
</c:when>
<c:otherwise>
...
</c:otherwise>
</c:choose>


c:foreach动作提供一个容易的方法来迭代一个集合的元素。如果你想只迭代集合的一部分的话，你可以分别用begin、 end、 和 step属性指定起点、终点和一个递增值。在下面的例子中，我们在变量customerNames中迭代一个集合的内容；在每个循环中，下一个元素输入到变量名内并在c:foreach动作的体内计算：

<table>
<c:forEach var="name" items="${customerNames}">
<tr><td><c:out value="${name}"/></td></tr>
</c:forEach>
</table>


记得Java的StringTokenizer类吗？有了c:forTokens动作，你可以用JSTL获得类似的功能。这个程序片断可使用在delims属性中定义的定界符通过items String属性中的条目迭代。注意，items 属性不必是一个字符直接量；它可以是任何有效的EL表达式:

<table>
<c:forTokens items="47,52,53,55,46,22,16,2" delim="," var="dailyPrice">
<tr><td><c:out value="${dailyPrice}"/></td></tr>
</c:forTokens>
</table>


在接下来的完整的JSTL页中，我列出了已经传递到该页的所有参数。param 和paramValues对象是映射关键字到一个或多个值的Java Map集。在本例中，我们找出了用于集合的每个MapEntry的关键字即参数名，并且使用关键字来查找所有与关键字关联的参数值：

<％@ taglib uri="http://java.sun.com/jstl/core" prefix="c" ％>
<html>
<body>
<head>
<title>Parameter Listing Example</title>
</head>
<br>
<b>Parameter values passed to this page for each parameter: </b>
<table border="2">
<c:forEach var="current" items="${param}">
    <tr>
    <td>
    <b><c:out value="${current.key}" /></b>
    </td>
    <c:forEach var="aVal" items="${paramValues[current.key]}">
     <td>
     <c:out value="${aVal}" />
      </td>
   </c:forEach>
  </tr>
</c:forEach>
</table>
</body>
</html>


其他动作

我们也需要讨论一些其他重要的核心标记库动作。在网页实现中一个潜在的问题范围与URL编码有关。没有URL编码，在网页中传递的URL的某个字符如空格，可能会迷惑Web服务器。URL编码确保这些特殊的字符用不引起迷惑的字符代替。下列例子在变量myUrl中定义了一个URL,该变量myUrl由一个URL和一系列参数组成。URL动作（注意，这里只在JSTL意义上的动作）保证所有字符都正确的编码:

<c:url value="http://acme.com/exec/register" var="myUrl">
<c:param name="name" value="${param.name}"/>
<c:param name="country" value="${param.country}"/>
</c:url>
<a href= <c:out value="${myUrl}"/> >Register</a>


在上面的代码中，param动作简单的定义了一组名值对。

JSP允许设计者用指令包括其他页的内容。JSTL用JSTL c:import动作扩展了这个概念。c:import的主要优势是：你能指定一个任意的URL；也可以包含你的Web应用之外（W3C的任何地方）的页的内容或者你的服务器上的另一个Web应用内的页的内容。

对于一组与HTTP相关的标记来说，没有一个方法处理HTTP重定向是不完整的。JSTL用c:redirect动作支持它。

国际化标记库

在讨论了JSTL支持国际化中，我假设你已经有了对下列主题的合理的理解：

●资源包和Java如何找到它们

●Locale类

●资源包查找和MessageFormat类

●局部编码以及它与Java国际化的关系

●Java文本和数据格式化

我在下面的两个部分讨论了国际化标记库。在第一部分，我包括了你可能使用的格式化和解释相关的动作（它最初对应于java.text封装包中的类），尽管你没有开发过完全的国际化应用程序，可能你也要用到它。在第二部分，我说明了更针对于国际化的动作。

如果存在一个远程的可能性，你的应用程序会在你本国之外使用。如果你从一开始就建立在国际化的支持上，那么开发就会更加容易。无论你使用何种方法来开发，即使像JSTL一样容易使用的方法，一开始建立在国际化支持上也是十分有益的。

格式标记库：格式动作

如果你已经使用了Java的 DateFormat 和NumberFormat类，在下面的标记中使用的方法应该看起来眼熟，因为JSTL格式化动作是在这些类之上建立的。这些Java类普遍提供一个format( )函数，它将一个Java类型转化为一个格式化的String和创建对应于该String的Java对象。

fmt:formatNumber动作有一个value属性和一个pattern属性。value属性是一个与我们吹降钠渌黺alue属性类似的EL表达式或者变量。pattern属性与在NumberFormat类中定义的模式一样。下列动作发送一个格式化的String到JSP页的输出上：

<fmt:formatNumber value="1000.001" pattern="#,#00.0#"/>


在这个fmt:formatNumber动作里，我们使用了type属性来指定：格式化我们需要格式化的值为一个货币值。我们保存格式化的结果在一个变量名为dollars中。在一个美国的locale类中，下面的程序生成一个字符串$3456.79（注意，它将使用的货币值四舍五入了）：

<fmt:formatNumber value="3456.789" type="currency" var="dollars"/>


用于上面的type属性的可能值包括currency、 number、 和percent。

在例中，我们使用了另一种方法——使用了一个包括在value属性中的一个格式化的域（currency，每type属性）的一个文本字符串。并且解析它来获取一个数字。结果储存在由var属性指定的一个变量内。尽管这个属性是可选的，还是会经常使用它。另外，解析的值送到页输出上：

<fmt:parseNumber value="${currencyInput}" type="currency"
var="parsedNumber"/>
fmt:formatDate动作有一个value属性、一个format属性、
一个指向处理格式化的格式类的属性（典型的，如java.util.Date）：
<jsp:useBean id="now" class="java.util.Date" />
<fmt:formatDate value="${now}" timeStyle="long"
dateStyle="long"/>


像数字格式化一样，JSTL页提供一个机制来解析一个代表日期的、进入Date对象的字符串：

<fmt:parseDate value="${dateInput}" pattern="MM dd, YYYY" />


查看java.util.DateFormat类，了解如何处理格式化和模式的更多详细的资料。

格式标记库：国际化动作

Java本地化的一个关键点是ResourceBundle类。JSTL动作允许你用这个类简单的工作。这个例子使用了fmt:bundle动作来得到与当前Locale 和 fmt:message动作对应的一个ResourceBundle动作，从而查看该资源包中的本地化的字符串：

<fmt:bundle basename="myBundle">
<％-- Use values in myBundle --％>
<fmt:message key="Introduction">
   <fmt:param value="${loginName}"/>
   <fmt:param value="${loginCount}"/>
</fmt:message>
<fmt:formatDate value="${now}" var="parsedDate"/>
</fmt:bundle>


经常，fmt:message动作简单的查看了对应于一个关键词的字符串。在上面的例子中，在ResourceBundle中的字符串包含了取代两个值的占位符。这些值在fmt:param动作中定义过，这就像Java MessageFormat类使用的方法。

有一些类似的动作可指定一个时区，时区可应用到在标记的体中计算的任何事上：

<fmt:timeZone value="someTimeZone">
<!-- actions in this context will be evaluated using someTimeZone  -->
</fmt:timeZone>


上述的fmt:bundle 和 fmt:timeZone动作有分别对应的fmt:setBundle和fmt:setTimeZone的动作。这些动作添加了可选的scope属性；因此，你可以使用这些动作在任何等同于应用范围的范围内设定一个资源捆绑或者一个时区。

如果你用非欧洲的locale类工作的话，你可能得担心编码的问题，JSTL支持用fmt:requestEncoding动作编码。

SQL标记库

JSTL 允许容易的数据库的集成。但是，值得注意的是：沙箱之外的JSTL的执行有一些限制。主要的问题与连接池有关。建立并维护到数据库的连接是很消耗资源的。JSTL SQL动作使得许多数据库连接建立起来，通常的，每个用户至少有一个。因此，JSTL SQL标记对于原型开发的或低容量的、基于Web的应用程序意义重大。但是它不适合于大规模的应用程序。一个可缩放的产品应用程序一般是在一个页面内处理数据库访问如隐藏数据库访问和处理像连接池之类的细节。但是，还是有方法允许你实现连接池和用一点自定义码来使用JSTL SQL动作
我们看一些简单的例子。这些例子使用来自SQL库的JSTL标记。如果你熟悉SQL基础的话，你应该能够改编这些例子用在你的应用程序上。

在下面的程序片断中，我们建立了一条到一个数据库的连接，选择一组匹配一个订单ID的订单项目，并且在一个表格中显示item属性：

<sql:setDataSource
      driver="com.cheapDrivers.jdbcDriver"
      url="jdbc:cheapDrivers:."
      user="guest"
      password="password"
      var="dataSource" />

<sql:query var="orderItems" dataSource="${dataSource}">
SELECT * FROM items
WHERE order_id = <cout value="${orderID}"/>
ORDER BY price
</sql:query>
<table>
<c:forEach var="row" items="${orderItems.rows}">
<tr>
<td><c:out value="${row.itemName}"/></td>
<td><c:out value="${row.price}"/></td>
<td><c:out value="${row.weight}"/></td>
</tr>
</c:forEach>
</table>


在下一个例子中，我会说明JSTL是如何支持数据库事务的，在数据库中，许多包含对表格多个改动的操作必须是对所有的，或者什么也不做：如果出现一个问题时，改动必须为空操作。在下面例子中，sql:update动作包含在一个sql:transaction动作内，如果在事务处理过程中，存在任何SQL错误的话，在事务范围内执行的所有操作都得重来。

sql:update动作的命名有一点误导：除了SQL UPDATE外，sql:update也支持INSERT 和 DELETE，甚至是SQL CREATE。实际上，它支持不产生结果的任何一条SQL操作。在下面的例子中，sql:update通过插入变量值到一个PreparedStatement中来执行一个UPDATE动作。在这个代码片断中，我们在两个账户之间传送钱（需要预先包装在一个事务中的某些东西的一个经典的例子）：

<sql:transaction dataSource="${dataSource}">
<sql:update>
UPDATE account
SET account_balance =account_balance -?
WHERE accountNo = ?
<sql:param value="${transferAmount}"/>
<sql:param value="${sourceAccount}"/>
</sql:update>
<sql:update>
UPDATE account
SET account_balance =account_balance +?
WHERE accountNo = ?
<sql:param value="${transferAmount}"/>
<sql:param value="${destAccount}"/>
</sql:update>
</sql:transaction>


XML标记库

使用标准的XML标记库，你所能做的完整的处理，特别是可扩展性单一语言变换说明（XSLT）的处理，对于另一篇文章来说是一个很好的主题。下面我会涵盖足够的让你开始的知识。

在JSTL的XML支持遵循XPath规范。XPath的重要功能之一是为访问XML著名的分层的信息提供一个清晰的语法。也许看到每件是如何工作的最容易的方法就是看看我们如何使用来自于一个真实JSTL页的一个片断里的标记：

!-- Find and parse our XML document (somewhere on the WWW) -->
<c:import url="http://www.cheapstuff.com/orderStatus?id=2435" var="xml"/>
<x:parse xml="${xml}" var="doc"/>
<!-- access XML data via XPath expressions -->
<x:out select="$doc/name"/>
<x:out select="$doc/shippingAddress"/>
<x:out select="$doc/deliveryDate"/>
<!-- Set a scoped variable -->
<x:set var="custName" scope="request" select="$doc/name"/>


在上面的输入和解析动作中，我们装载和解析了一个指定的XML文档到一个变量doc里。在上面的每个x:out动作中，我们使用了一个XPath表达式访问了解析的XML文档的元素，并且发送结果到JSP页输出中。