JSP标准标签库(JavaServer Page Standard Tag Library, JSTL)
JSTL的目的是简化JSP页面的设计。
JSTL1.0需要支持Servlet2.3和JSP1.2的Web容器,
JSTL1.1需要支持Servlet2.4和JSP2.0的Web容器。
JSTL API下载地址为:http://jcp.org/aboutJava/communityprocess/final/jsr052/index2.html
JSTL是由5个不同的功能的标签库组成的。在JSTL1.1规范中,为5个标签库分别指定了不同的URI,并对标签库的前缀做出了规定:
功能范围 | URI | 前缀 |
core | c | |
i18n | fmt | |
sql | sql | |
XML | x | |
Functions | http://java.sun.com/jsp/jstl/functions
| fn
|
为了使用JSTL,我们需要先下载jstl安装包。
下载地址:http://www.apache.org/dist/jakarta/taglibs/standard
下载的文件名为: jakarta-taglibs-standard-current.zip
解压下载的zip包,在lib目录下有2个jar文件:jstl.jar和standard.jar。
将jstl.jar和standard.jar复制到WEB-INF/lib目录下
Core标签库
在JSP中使用Core标签库,要使用taglib指令,指定引用的标签库。
<%@ taglib uri=http://java.sun.com/jsp/jstl/core prefix=“c” %>
一般用途的标签有:
<c:out>
<c:set>
<c:remove>
<c:catch>
l <c:out>
用于计算一个表达式,并将结果输出到当前的JspWriter对象。
<c:out>标签的功能类似于JSP的表达式<%=expression %>, 或者EL表达式${el-expression}
语法1:没有标签体:
<c:out value=“value” [escapeXml=“{true|false}”] [default=“value”] />
语法2:有标签体:
<c:out value=“value” [escapeXml=“{true|false}”]>
default value
</c:out>
<c:out>属性.
名称 | 类型 | 描述 |
value | Object | 被计算的表达式 |
escapeXml | boolean | 确定在结果字符串中的字符”<“, “>”, “’”, “&”是否应该被转换为对应的字符引用或预定义实体引用。默认为true. |
default | Object | 如果value为null,则使用这个默认值 |
如果value为null,将输出default的值。
如果没有指定default的值,将输出空字符串。
如果属性escapeXml是true,那么字符”<“, “>”, “ ’ ”, “ ” ”, “&”将被转换成:< > ' " &
<c:out>示例
l 例子1:
<c:out value=“${customer.address.city}” default=“unknown” />
l 例子2:
<c:out value=“${sessionScope.desc}” escapeXml=“false”>
no description
</c:out>
l <c:set>
用于设置范围变量的值或JavaBean对象的属性。
语法1:使用value属性设置范围变量的值
<c:set value=“value” var=“varname” [scope=“{page|request|session|application}”] />
语法2:使用标签体设置范围变量的值
<c:set var=“varName” [scope=“{page|request|session|application}”] >
body content
</c:set>
语法3:使用value属性设置target对象的属性
<c:set value=“value” target=“target” property=“propertyName” />
语法4:使用标签体的内容设置target对象的属性
<c:set target=“target” property=“propertyName”>
body content
</c:set>
<c:set>属性
名称 | 类型 | 动态值 | 描述 |
value | Object | true | 被计算的表达式 |
var | String | false | 被导出的保存了value属性计算结果的范围变量的名称。这个范围变量的类型是属性value指定的表达式计算结果的类型 |
scope | String | false | var的JSP范围,默认是page |
target | Object | true | 要设置属性的对象,必须是JavaBean对象(有setter方法)或者java.util.Map对象 |
property | String | true | 要设置的target对象的属性的名称 |
var和scope属性不能接受动态的值,对于其他标签也不能接受动态的值。
<c:set>示例
例子1:
<c:set var=“user” value=“zhou” scope=“session” />
例子2:
<c:set var=“name”>zhou</c:set>
例子3:
<c:set target=“${user}” property=“age” value=“18” />
例子4:
<c:set target=“${preferences}” property=“color”>
${param.color}
</c:set>
<c:remove>
用于移除范围变量。
语法:
<c:remove var=“varName” [scope=“{page|request|session|application}”] />
<c:catch>
用与捕获在其中嵌套的操作所抛出的异常对(java.lang.Throwable对象),并将异常信息保存到变量中
语法:<c:catch [var=“varName”]>
nested actions
</c:catch>
将可能抛出异常的代码放置在<c:catch>和</c:catch>之间,如果其中的代码抛出异常,异常将被捕获,并被保存到var所标识的范围变量中,该变量总是有page范围ie。
如果没有发生异常,而var所标识的范围变量存在,那么它将被移除。
如果没有指定var属性,那么异常只是被简单地捕获,异常信息并不会被保存。
<c:catch var=“exception”>
<%
int i = 5;
int j = 0;
int k = i / j;
%>
</c:catch>
<c:out value=“${exception}” /><p>
<c:out value=“${exception.message}” /><p>
${exception.message}相当于调用exception.getMessage()
条件标签
<c:if>
<c:choose>
<c:when>
<c:otherwise>
<c:if>
用于实现Java语言中if语句的功能。
语法1:没有标签体。
<c:if test=“testCondition” var=“varName”[scope=“{page|request|session|application}”] />
语法2:有标签体。
<c:if test="testCondition" [scope="{page|request|session|application}"]
[var="varName"] >
body content
</c:if>
示例
<c:if test="${user.visitCount==1}">
This is your first visit. Welcome to the site!
</c:if>
<c:if test="${param.name==‘admin’}" var="result" />
<c:out value=“${result}” />
<c:choose>, <c:when>和<c:otherwise>
<c:choose>
<c:when test="testCondition">
body content
</c:when>
……
<c:otherwise>
conditional block
</c:otherwise>
</c:choose>
迭代标签
<c:forEach>用于对包含了多个对象的集合进行迭代,重复执行它的标签体,或者重复迭代固定的次数。
l 对集合进行迭代
<c:forEach [var="varName"] items="collections" [varStatus="varStatusName"] [begin="begin"] [end="end"] [step="step"]>
body content
</c:forEach>
l 迭代固定的次数:
<c:forEach [var=“varName”] [varStatus=“varStatusName”] begin=“begin” end=“end” [step=“step”]>
body content
</c:forEach>
<c:forEach>属性
var:迭代参数的名称。在迭代体中可以使用的变量的名称,用来表示每一个迭代变量。类型为String。
items:要进行迭代的集合。对于它所支持的类型java.util.Collection, java.util.Map, java.util.Iterator, java.util.Enumeration,数组元素
varStatus:迭代变量的名称,用来表示迭代的状态,可以访问到迭代自身的信息。varStatus属性命名的变量是javax.servlet.jsp.jstl.core.LoopTagStatus类的实例
current:当前这次迭代的(集合中的)项。
index:当前这次迭代从0开始的迭代索引。
count:当前这次迭代从1开始的迭代计数。
first:用来表明当前这轮迭代是否为第一次迭代
last:用来表明当前这轮迭代是否为最后一次迭代
示例1
<c:forEach var=“entry” items=“${myHashmap}”>
下一个元素的键是 ${entry.key}
下一个元素的值是 ${entry.value}
</c:forEach>
示例2
<c:forEach var="user" items="<%=arrList%>" varStatus="status">
<tr>
<td>${status.count}</td>
<td>${status.index}</td>
<td>${status.first} </td>
<td>${status.last}</td>
<td>${user.name}</td>
</tr>
</c:forEach>
<c:forTokens>
用于迭代字符串中由分隔符分隔的各成员。
语法:<c:forTokens items="string" delims="delimiters" [var="varName"] [varStatus="varStatusName"] [begin="begin"] [end="end"] [step="step"]>
body content
</c:forTokens>
Items:要迭代的String对象
delims:指定分隔字符串的分隔符,可有多个,如果delims是null,items所表示的字符串被看作一个单独的整体。
<c:forTokens>示例
<c:forTokens items="kris:zhang:hi" delims=":" var="name">
${name}
</c:forTokens>