JSTL核心标签库

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	http://java.sun.com/jsp/jstl/core	c
i18n	http://java.sun.com/jsp/jstl/fmt	fmt
sql	http://java.sun.com/jsp/jstl/sql	sql
XML	http://java.sun.com/jsp/jstl/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，那么字符”<“, “>”, “ ’ ”, “ ” ”, “&”将被转换成：&lt; &gt; &#039; &#034; &amp;

<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>