简介
JSTL是一个不断完善的开放源代码的JSP标签库,是由apache的jakarta小组来维护的。JSTL只能运行在支持JSP1.2和Servlet2.3规范的容器上,如tomcat 4.x。但是在即将推出的JSP 2.0中是作为标准支持的。
JSTL目前的最新版本为1.02,最终发布版为1.0。JSTL包含两个部分:标签库和EL(Expression Language表达式语言)语言。标签库目前支持四种标签:
标签 | URI | 前缀 | 示例 |
Core | http://java.sun.com/jstl/core | c | <c:tagname ...> |
XML processing | http://java.sun.com/jstl/xml | x | <x:tagname ...> |
I18N capable formatting | http://java.sun.com/jstl/fmt | fmt | <fmt:tagname ...> |
Database access (SQL) | http://java.sun.com/jstl/sql | sql | <sql:tagname ...> |
Core支持JSP中的一些基本的操作;
XML processing支持XML文档的处理;
I18N capable formatting支持对JSP页面的国际化;
Database access (SQL)支持JSP对数据库的操作。
安装JSTL
要使用JSTL,你必须安装有一个JSP1.2(或者更高版本)的容器。最普通的JSP容器是Apache Tomcat。你能够从http://jakarta.apache.org/tomcat/这里下载到。独立的Tomcat允许你使用常规的JSP scriptlet代码。要使用JSTL,你必须在Tomcat中安装JSTL。JSTL的主要URL是 http://java.sun.com/products/jsp/jstl/。要使用JSTL,必须解压这个文件,然后将它安装到Tomcat的正确位置。
要在Tomcat中安装JSTL,有下面三个步骤:
-
- 拷贝JSTL JAR文件到Tomcat的lib目录中.
- 拷贝JSTL TLD文件到Tomcat的web-inf目录中
- 修改web.xml文件包含这些TLD文件。
如果你使用的是Windows, 那么lib目录最可能的位置是C:/Program Files/Apache Tomcat 4.0/webapps/ROOT/WEB-INF/lib。你应该拷贝这些JAR包到你的Tomcat JAR目录。
你检查JSTL发布文件时,你应该会注意到有8个文件是以TLD扩展名结尾的。所有这8个文件都应该复制到你的web-inf目录中。
最后,你必须修改你的web.xml,添加8个标签库的表项(entry)。需要添加的表项如下所示:
<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/fmt-rt</taglib-uri>
<taglib-location>/WEB-INF/fmt-rt.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/core-rt</taglib-uri>
<taglib-location>/WEB-INF/c-rt.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/sql-rt</taglib-uri>
<taglib-location>/WEB-INF/sql-rt.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>http://java.sun.com/jstl/x</taglib-uri>
<taglib-location>/WEB-INF/x.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>http://java.sun.com/jstl/x-rt</taglib-uri>
<taglib-location>/WEB-INF/x-rt.tld</taglib-location>
</taglib>
完成上面这三步后,你现在可以准备测试你的JSTL安装了。可以通过创建一个包含JSTL的JSP页面来验证。一个最简单的范例程序就是上面的那个计数器程序。你应该将它放置在你的Webroot目录中(C:/Program Files/Apache Tomcat 5.0/webapps/ROOT)。一旦Tomcat启动后,你应该能够通过浏览 http://127.0.0.1:8080/count.jsp来查看这个页面。
如果你没有正确安装JSTL,那么可能不会出现错误信息。如果JSTL不能解释你的标签含义,那么它在Web浏览器上会直接跳过。然后Web浏览器将解释这些未知的HTML标签。多数浏览器仅仅只是忽略这些未知的HTML标签。
JSTL标签库
JSTL通常被认为是一种单标签库。但JSTL实际上有4个标签库。这些标签库被概括为如下:
- 核心标签库—包含一些Web应用的必要的标签。核心标签库的实例包括循环,表达式赋值和基本输入输出。.
- 格式化/国际化标签库—包括被用来解析数据的标签库。这种标签会解析数据,比如日期,不同的场所区域等。
- 数据库标签库—包含被用来访问SQL数据库的标签。这些标签通常仅仅只创建原形(prototype)程序。这个是因为大多数程序不会直接从JSP页面中来处理数据库访问。数据库访问应该被嵌入到能够被JSP页面所访问的EJB中。
- XML标签库—包含被用来访问XML元素的标签。因为XML广泛使用于Web开发,XML的处理是JSTL的一个重要的特征。
在本文中,我们将仅仅只对核心标签做一个简单介绍。我们将考察一个简单的范例,来说明如何处理用户在表单中输入的数据。在我们开始检查程序之前,我们必须先看看JSTL是如何处理表达式的,JSTL的表达式处理是通过使用EL表达式语言来完成的,仅仅只能在JSP2.0被使用。下一节,我们会考察EL表达式语言。
Core标签库
1、 通用标签
<c:out>
<c:out>标签用于在JSP中显示数据,它有如下属性
属 性 | 描 述 | 是否必须 | 缺省值 |
value | 输出的信息,可以是EL表达式或常量 | 是 | 无 |
default | value为空时显示信息 | 否 | 无 |
escapeXml | 为true则避开特殊的xml字符集 | 否 | true |
例子:
您的用户名是: <c:out value=”${user.username}” default=”guest”/> |
显示用户的用户名,如为空则显示guest
<c:out value="${sessionScope.username}"/> |
指定从session中获取username的值显示;
<c:out value="${username}" /> |
显示username的值,默认是从request(page)中取,如果request中没有名为username的对象则从session中取,session中没有则从application(servletContext)中取,如果没有取到任何值则不显示。
<c:set>
<c:set>标签用于保存数据,它有如下属性
属 性 | 描 述 | 是否必须 | 缺省值 |
value | 要保存的信息,可以是EL表达式或常量 | 否 | |
target | 需要修改属性的变量名,一般为javabean的实例 | 否 | 无 |
property | 需要修改的javabean属性 | 否 | 无 |
var | 需要保存信息的变量 | 否 | 无 |
scope | 保存信息的变量的范围 | 否 | page |
如果指定了target属性, 那么property属性也必须指定。
例子:
<c:set value="${test.testinfo}" var="test2" scope=”session” /> |
将test.testinfo的值保存到session的test2中,其中test是一个javabean的实例,testinfo是test对象的属性。
<c:set target="${cust.address}" property="city" value="${city}"/> |
将对象cust.address的city属性值保存到变量city中
<c:remove>
<c:remove>标签用于删除数据,它有如下属性
属 性 | 描 述 | 是否必须 | 缺省值 |
var | 要删除的变量 | 是 | 无 |
scope | 被删除变量的范围 | 否 | 所有范围,包括page、request、session、application等 |
例子:
<c:remove var="test2" scope="session"/> |
从session中删除test2变量。
2、 流控制标签
<c:if>
<c:if>标签有如下属性
属 性 | 描 述 | 是否必须 | 缺省值 |
test | 需要评价的条件,相当于if (...){}语句中的条件 | 是 | 无 |
var | 要求保存条件结果的变量名 | 否 | 无 |
scope | 保存条件结果的变量范围 | 否 | page |
<c:choose>
这个标签不接受任何属性
<c:when>
<c:when>标签有以下属性
属 性 | 描 述 | 是否必须 | 缺省值 |
test | 需要评价的条件 | 是 | 无 |
<c:otherwise>
这个标签同样不接受任何属性
例子:
<c:if test="${user.wealthy}"> user.wealthy is true. </c:if> |
如果user.wealthy值true,则显示user.wealthy is true.
<c:choose> <c:when test="${user.generous}"> user.generous is true. </c:when> <c:when test="${user.stingy}"> user.stingy is true. </c:when> <c:otherwise> user.generous and user.stingy are false. </c:otherwise> </c:choose> |
只有当条件user.generous返回值是true时,才显示user.generous is true.
只有当条件user.stingy返回值是true时,才显示user.stingy is true.
其它所有的情况(即user.generous和user.stingy的值都不为true)全部显示user.generous and user.stingy are false.
由于JSTL没有形如if (){…} else {…}的条件语句,所以这种形式的语句只能用<c:choose>、<c:when>和<c:otherwise>标签共同来完成了。
3、 循环控制标签
<c:forEach>
<c:forEach>标签用于通用数据,它有以下属性
属 性 | 描 述 | 是否必须 | 缺省值 |
items | 进行循环的项目 | 否 | 无 |
begin | 开始条件 | 否 | 0 |
end | 结束条件 | 否 | 集合中的最后一个项目 |
step | 步长 | 否 | 1 |
var | 代表当前项目的变量名 | 否 | 无 |
varStatus | 显示循环状态的变量 | 否 | 无 |
例子:
<c:forEach items="${vectors}" var="vector"> <c:out value="${vector}"/> </c:forEach> |
相当于java语句
for (int i=0;i<vectors.size();i++) { out.println(vectors.get(i)); } |
在这里vectors是一个java.util.Vector对象,里面存放的是String数据,vector是当前循环条件下String对象。实际上这里的vectors可以是任何实现了java.util. Collection接口的对象。
<c:forEach begin="0" end="100" var="i" step="1"> count=<c:out value="${i}"/><br> </c:forEach> |
输出:
count=0
...
count=100
<c:forTokens>
<c:forTokens>标签有以下属性
属 性 | 描 述 | 是否必须 | 缺省值 |
items | 进行循环的项目 | 是 | 无 |
delims | 分割符 | 是 | 无 |
begin | 开始条件 | 否 | 0 |
end | 结束条件 | 否 | 集合中的最后一个项目 |
step | 步长 | 否 | 1 |
var | 代表当前项目的变量名 | 否 | 无 |
varStatus | 显示循环状态的变量 | 否 | 无 |
例子
<c:forTokens items="a:b:c:d" delims=":" var="token"> <c:out value="${token}"/> </c:forTokens> |
这个标签的使用相当于java.util.StringTokenizer类。在这里将字符串a:b:c:d以:分开循环四次,token是循环到当前分割到的字符串。
4.导入文件和URL
JSTL核心标签库支持使用<c:import>来包含文件,使用<c:url>来打印和格式化URL,使用<c:redirect>来重定向URL。
<c:import>
<c:import>标签包含另外一个页面代码到当前页,它有以下属性
属 性 | 描 述 | 是否必须 | 缺省值 |
url | 需要导入页面的url | 是 | 无 |
context | /后跟本地web应用程序的名字 | 否 | 当前应用程序 |
charEncoding | 用于导入数据的字符集 | 否 | ISO-8859-1 |
var | 接受导入文本的变量名 | 否 | page |
scope | 接受导入文本的变量的变量范围 | 否 | 1 |
varReader | 用于接受导入文本的java.io.Reader变量名 | 否 | 无 |
varStatus | 显示循环状态的变量 | 否 | 无 |
<c:url>
<c:url>标签输出一个url地址,它有以下属性
属 性 | 描 述 | 是否必须 | 缺省值 |
url | url地址 | 是 | 无 |
context | /后跟本地web应用程序的名字 | 否 | 当前应用程序 |
charEncoding | 用于导入数据的字符集 | 否 | ISO-8859-1 |
var | 接受处理过的url变量名,该变量存储url | 否 | 输出到页 |
scope | 存储url的变量名的变量范围 | 否 | page |
例子:
<c:import url="http://www.url.com/edit.js" var="newsfeed"/> |
将url http://www.url.com/edit.js包含到当前页的当前位置,并将url保存到newsfeed变量中
<a href="<c:url url="/index.jsp"/>"/> |
在当前页的当前位置输出<a href="http://www.yourname.com/index.jsp"/>,http://www.yourname.com是当前页的所在的位置。
<c:redirect>
<c:redirect>标签将请求重新定向到另外一个页面,它有以下属性
属 性 | 描 述 | 是否必须 | 缺省值 |
url | url地址 | 是 | 无 |
context | /后跟本地web应用程序的名字 | 否 | 当前应用程序 |
例子:
<c:redirect url="http://www.yourname.com/login.jsp"/> |
将请求重新定向到http://www.yourname.com/login.jsp页,相当于response.setRedirect("http://www.yourname.com/login.jsp");
<c:param>
<c:param>标签用来传递参数给一个重定向或包含页面,它有以下属性
属 性 | 描 述 | 是否必须 | 缺省值 |
name | 在request参数中设置的变量名 | 是 | 无 |
value | 在request参数中设置的变量值 | 否 | 无 |
例子:
<c:redirect url="login.jsp"> <c:param name="id" value="888"/> </c:redirect> |
将参数888以id为名字传递到login.jsp页面,相当于login.jsp?id=888
EL表达式语言
JSP2.0的一个主要的组件就是这个新的叫做EL的表达式语言。EL被广泛用在JSTL中。然而,重要的是记住,EL是JSP的功能而不是JSTL的。被用在JSP2.0中JSP scriptlet代码能够包含EL表达式。下面这行代码演示了JSP scriptlet代码中的EL:
<p>
Your total, including shipping is ${total+shipping}
</p>
正如你看到的,total和shipping相加后会产生HTML并且在浏览器中显示它们的值。这些表达式也可以在JSTL标签中使用。JSTL1.0的一个重要问题是,JSTL不能用在JSP1.2的版本上。因为JSP1.2不支持EL,所以有必要提供一些额外的JSTL标签来帮助EL的使用。例如,如果你想使用JSTL来显示上面的表达式,你可以使用下面的代码。
<p>
Your total, including shipping is <c:out var="${total+shipping"/>
</p>
值得注意的是,JSTL不需要JSP2.0来运行。通过提供一个能够显示EL表达式的标签,就可以达到这样的需求。
JSTL范例
我们将考察一个简单的使用JSTL的范例。在这个例子里,我们将考察Web应用中的一个常见过程。我们会看到如何提交(POST)一个表单,并处理POST的结果。程序代码如下:
<%@ taglib uri="http://java.sun.com/jstl/core" prefix="c" %>
<html>
<head>
<title>If with Body</title>
</head>
<body>
<c:if test="${pageContext.request.method=='POST'}">
<c:if test="${param.guess=='Java'}">You guessed it!
<br />
<br />
<br />
</c:if>
<c:if test="${param.guess!='Java'}">You are wrong
<br />
<br />
<br />
</c:if>
</c:if>
<form method="post">Guess what computer language
I am thinking of?
<input type="text" name="guess" />
<input type="submit" value="Try!" />
<br/>
</form>
</body>
</html>
这个简单的Web页面显示一个表单,要求用户猜测程序所想的计算机语言。当然,计算机想的是“Java”。这个页面通过检查“是否已提交”来开始。这使得表单和处理表单的代码可以放在同一个页面中。是通过下面的JSTL if语句实现的。
<c:if test="${pageContext.request.method=='POST'}">
现在你看到了,<c:if>标签使用EL表达式来决定是否请求的方式是POST的。如果数据被post到页面,那么用户输入的他们的猜想值就会存储在名为“guest”的参数中。这是因为“guest”是表单输入项的名字。我们现在必须检查是否这个参数等于“Java”。这个是通过下面的<c:if>标签来完成:
<c:if test="${param.guess=='Java'}">
You guessed it!
</c:if>
正如你所看到的,如果表达式为true,<c:if>标签的标签体就被执行。在本文中,我们开始考察了JSTL如何被安装,以及它是如何运转的,也提供了一些JSTL小范例帮助大家理解。
JSTL的核心标签也包含循环,叠代器和变量处理。通过使用标签,你能在collections里进行iterate,访问用户的会话数据(session data),执行其他的核心任务等。除了核心标签库,XML,数据库和格式化标签库也提供了更多高级的用处。