JSTL 标签库详细介绍资料
前言
从jsp 1.1规范开始,jsp就支持在jsp中使用自定义标签了,自定义标签的广泛使用造成了程序员重复定义,这样就促成了jstl(javaserver pages standard tag library)的诞生。
因为工作中需要用到jstl,但网上却苦于找不到有关jstl的中文资料,所以就有了这篇文章。
jstl简介
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对数据库的操作。
由于本人水平有限,本文仅介绍core标签,如有兴趣,可一起探讨其它三种标签的使用与扩充。
el语言介绍
el语言是jstl输出(输入)一个java表达式的表示形式。
在jstl中,el语言只能在属性值中使用。el语言只能通过建立表达式${exp1}来进行调用。在属性值中使用表达式有三种方式。
1、 value属性包含一个表达式
<some:tag value="${expr}"/>
在这种情况下,表达式值被计算出来并根据类型转换规则赋值给value属性。比如:<c:out value="${username}" />中的${username}就是一个el,它相当于jsp语句<%=request.getattribute(“username”)%>或<%=session.getattribute(“username”)%>
2、 value属性包含一个或多个属性,这些属性被文本分割或围绕
<some:tag value="some${expr}${expr}text${expr}"/>
在这种情况下,表达式从左到右进行计算,并将结果转换为字符串型(根据类型转换规则),并将结果赋值给value属性
3、 value属性仅仅包含文本
<some:tag value="sometext"/>
在这种情况下,字符串型属性value将根据类型转换规则转换为标签所希望的类型。
el语言的操作符
取得某个对象或集合中的属性值
为了获得集合中的属性,el支持以下两种操作
1. 使用.操作符来获得有名字的属性。例如表达式${user.username}表明对象user的username属性
2. 使用[]操作符来获得有名字或按数字排列的属性。
表达式${user["username"]}和表达式${user. username }含义相同
表达式${row[0]} 表明row集合的第一个条目。
在这里user是一个类的对象,它的属性username必须符合标准javabean的规范,即必须为username属性定义相应的getter、setter方法。
empty操作符(空值检查)
使用empty操作符来决定对象、集合或字符串变量是否为空或null。例如:
${empty param.username}
如果request的参数列表中的username值为null,则表达式的值为true。 el也可以直接使用比较操作符与null进行比较。如${param.firstname == null}。
比较操作符
操作符 | 描述 |
==或eq | 相等检查 |
!=或ne | 不等检查 |
<或lt | 小于检查 |
>或gt | 大于检查 |
<=或le | 小于等于检查 |
>=或ge | 大于等于检查 |
数字运算符与逻辑运算符均与java语言相同,不再列表。
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
jstl的优点
1、 在应用程序服务器之间提供了一致的接口,最大程序地提高了web应用在各应用服务器之间的移植。
2、 简化了jsp和web应用程序的开发。
3、 以一种统一的方式减少了jsp中的scriptlet代码数量,可以达到没有任何scriptlet代码的程序。在我们公司的项目中是不允许有任何的scriptlet代码出现在jsp中。
4、 允许jsp设计工具与web应用程序开发的进一步集成。相信不久就会有支持jstl的ide开发工具出现。
总结
上面介绍的仅仅是jstl的一部分,如果有时间我会继续把其它部分写出来分享给大家。如果要使用jstl,则必须将jstl.jar和standard.jar文件放到classpath中,如果你还需要使用xml processing及database access (sql)标签,还要将相关jar文件放到classpath中,这些jar文件全部存在于下载回来的zip文件中。这个zip文件可以从http://jakarta.apache.org/builds/jakarta-taglibs/releases/standard/jakarta-taglibs-standard-1.0.zip下载。
参考资料
1、 http://java.sun.com/products/jsp/jstl/
sun公司的jstl站点
2、 http://jakarta.apache.org/taglibs/doc/standard-doc/intro.html
jakarta小组的jstl站点
3、 http://www.manning.com/bayern/appendixa.pdf
jstl的参考文档,本文很多内容都是从这个pdf文件里翻译的。
4、 <<j2ee编程指南(1.3版)>>
介绍了jstl的雏形,wrox的书都是精品。