STL API，每天更新一点点！
库：Core（核心库)
URI：http://java.sun.com/jsp/jstl/core
前缀：c
1. <c:catch>
<c:catch>动作用于捕获JSP元素在其体中抛出的异常，从而提供细粒度的错误控制，此异常也可以保存为一个页面作用域变量。
语法：
<c:catch [var="var"]>
JSP elements
</c:catch>
属性：
| 属性名 | Java 类型 | 是否接受动态值 | 描述 |
|---|---|---|---|
var | String | No | 变量名 |
示例：
<c:catch var="importException">
<fmt:parseDate value="${param.empDate}" dateStyle="short" />
</c:catch>
<c:if test="${importException != null}">
<jsp:forward page="input.jsp">
<jsp:param name="msg" value="Invalid date format" />
</jsp:forward>
</c:if>
2. <c:choose>
<c:choose>动作用于控制嵌套<c:when>和<c:otherwise>动作的处理，它只允许第一个测试表达式计算为true的<c:when>动作得到处理；如果所有<c:when>动作的测试表达式都计算为false，则会处理一个<c:otherwise>动作。
语法：
<c:catch [var="var"]>
JSP elements
</c:catch>
属性：
无
示例：
<c:choose>
<c:when test="${product.onSale}">
${product.salesPrice} On sale!
</c:when>
<c:otherwise>
${product.price}
</c:otherwise>
</c:choose>
3. <c:forEach>
<c:forEach>动作将其体反复计算固定次数，或者针对一个集合中的每个元素分别计算一次体。当前元素（如果未指定集合则为当前索引）和迭代状态可以通过嵌套变量提供给体中的动作元素。
此动作接受属性表中所列的类型集合。当前元素的类型即为底层集合的类型，仅有两个例外。对于一个基本类型的数组，当前元素将作为相应包装类（Integer、Float等等）的一个实例提供。对于一个java.util.Map，当前元素则作为一个java.util.Map.Entry提供。
语法1：基于集合元素进行迭代
<c:forEach items="collection" [var="var"] [varStatus="varStatus"]
[begin="startIndex"] [end="stopIndex"] [step="increment"]>
JSP elements
</c:forEach>
语法2：迭代固定次数
<c:forEach [var="var"] [varStatus="varStatus"]
begin="startIndex" end="stopIndex" [step="increment"]>
JSP elements
</c:forEach>
属性
| 属性名 | Java 类型 | 是否接受动态值 | 描述 |
|---|---|---|---|
begin | int | Yes | 结合集合使用时的开始索引，从0计起。对于集合来说默认为0 |
end | int | Yes | 结合集合使用时的结束索引（元素引要小于等于此结束索引），从0计起。默认为集合的最后一个元素。如果end小于begin，则根本不计算体集合，迭代即要针对此集合进行。 |
items | java.util.Collection, java.util.Iterator, java.util.Enumeration, java.util.Map, 对象数组或基本类型数组。 | Yes | 集合，迭代即要针对此集合进行。 |
step | int | Yes | 每次迭代时索引的递增值。默认为1。 |
var | String | No | 保存当前元素的嵌套变量的名字。 |
varStatus | String | No | 保存LoopTagStatus对象的嵌套变量的名字。 |
示例：
<%-- Iterate five times, writing 1, 2, 3, 4, 5 --%>
<c:forEach begin="1" end="5" var="current">
${current}
</c:forEach>
<%-- Iterate over all request parameters --%>
<c:forEach items="${param}" var="current">
Name: <c:out value="${current.key}" />
Value: <c:out value="${current.value}" />
</c:forEach>
－－Update:06/10/27
4. <c:forTokens>
<c:forTokens>动作对于String中的每个token（单字）计算其体一次，在String中这些token由某个所指定的分隔符相分隔。当前token和迭代状态可以通过嵌套变量提供给体中的动作元素。
语法
<c:forTokens items="stringOfTokens" delims="delimiters"
[var="var"] [varStatus="varStatus"]
[begin="startIndex"] [end="stopIndex"] [step="increment"]>
JSP elements
</c:forTokens>
属性
| 属性名 | Java 类型 | 是否接受动态值 | 描述 |
|---|---|---|---|
items | String | Yes | 一组token，迭代即要针对这些token进行 |
delims | String | Yes | 分隔符列表 |
var | String | No | 保存当前元素的嵌套变量的名字 |
varStatus | String | No | 保存LoopTagStatus对象的嵌套变量的名字 |
begin | int | Yes | 开始索引，从0计起，默认为0 |
end | int | Yes | 结束索引（小于等于此索引），从0计起。默认为最后一个token。如果end小于begin，则根本不计算体。 |
step | int | Yes | 每次迭代时索引的递增值。默认为1。 |
示例
<%-- Iterate over tokens separated by vertical bars --%>
<c:forTokens items="${tokens}" delims="|" var="current">
<c:out value="${current }" />
</c:forTokens>
5.<c:if>
<c:if>动作仅当所指定的表达式计算为true时才计算其体。计算结果也可以保存为一个作用域Boolean变量。
语法1：没有体
<c:if test="booleanExpression "
var="var " [scope="page |request|session|application"]/>
语法2：有体
<c:if test="booleanExpression">
JSP elements
</c:if>
属性
| 属性名 | Java 类型 | 是否接受动态值 | 描述 |
|---|---|---|---|
test | boolean | Yes | 测试表达式 |
var | String | No | 变量名 |
scope | String | No | 变量作用域 |
示例
<c:if test="${empty param.empDate}"> <jsp:forward page="input.jsp"> <jsp:param name="msg" value="Missing the Employment Date" /> </jsp:forward> </c:if>
JSTL包含以下的标签:
常用的标签：如<c:out>、<c:remove>、<c:catch>、<c:set>等
条件标签：如<c:if><c:when>、<c:choose>、<c:otherwise>等
URL标签：如<c:import>、<c:redirect>和<c:url>等
XML标签：如<xml:out>等
国际化输出标签：如<fmt:timeZone>等
SQL标签：如<sql:query>、<sql:update>、<sql:transaction>等
一般用途的标签:
1．<c:out>
没有Body时的语法
<c:out value="value" [escapeXml="{true|false}"] [default="defaultValue"]/>
有Body时的语法
<c:out value="value" [escapeXml="{true|false}"]>
这里是Body部分
</c:out>
名字 类型 描述
value Object 将要输出的表达式
escapeXml boolean 确定以下字符:<,>,&,',"在字符串中是否被除数，默认为true
default Object 如果vaule计算后的结果是null，那么输出这个默认值2．<c:set>
这个标签用于在某个范围(page、request、session、application等)中使用某个名字设定特定的值，或者设定某个已经存在的javabean对象的属性。他类似于<%request.setAttrbute("name","value");%>
语法1：使用value属性设定一个特定范围中的属性。
<c:set value="value" var="varName" [scope="{page|request|session|application}"]/>
语法2：使用value属性设定一个特定范围中的属性，并带有一个Body。
<c:set var="varName" [scope="{page|request|session|application}"]>
Body部分
</c:set>
语法3：设置某个特定对象的一个属性。
<c:set value="value" target="target" property="propertyName"/>
语法4：设置某个特定对象的一个属性，并带有一个Body。
<c:set target="target" property="propertyName">
Body部分
</c:set>名字 类型 描述
value Object 将要计算的表到式。
var String 用于表示value 值的属性，如果要在其他标签中使用，就是通过这 个var指定的值来进行的。它相当于在标签定义了一个变量，并且这个变量只能在标签中的一个。
scope String var的有效范围，可以是page|request|session|application中的一个
target String 将要设置属性的对象，它必须是javabean或则java.util.Map对象
property Object 待设定的Target对象中的属性名字，比如在javabean中有个name属性，提供了setUserId方法，那么这里填userId。3．<c:remove>
<c:remove var="varName" [scope="{page|request|session|application}"]/>4．<c:catch>
这个标签相当于捕获在它里边的标签抛出的异常对象
<c:catch [var="varName"]> //var是异常的名字
内容
</c:catch>条件标签
1． <c:if>
语法1：无Body情况
<c:if test="testCondition" var="varName" [scope="page|request|session|application"]/>
语法2：有Body的情况
<c:if test="testCondition" var="varName" [scope="page|request|session|application"]>
Body内容
</c:if>名字 类型 描述
test Boolean 表达式的条件，相当于if()中的条件判断语句。
var String 表示这个语句的名字。
scope String var这个变量的作用范围。2．<c:choose>
语法：<c:choose>
Body内容(<c:when>和<c:otherwise>子标签)
</c:choose>
注意：它的Body只能由以下元素组成:
1) 空格
2) 0或多个<c:when>子标签，<c:when>必须在<c:otherwise>标签之前出现.
3) 0个或多个<c:otherwise>子标签。3．<c:when>
代表的是<c:choose>的一个条件分支,只能在<c:choose>中使用
语法：<c:when test="testCondition"> //test是boolean类型,用于判断条件真假
Body语句
</c:when>4．<c:otherwise>
代表的是<c:choose>中的最后选择。必须在最后出现
<c:otherwise>
内容
</c:otherwise>迭代标签
1．<c:forEach>
语法1：在Collection中迭代
<c:forEach[var="varName"] items="collection" [varStatus="varStatusName"]
[begin="begin"] [end="end"] [step="step"]
Body内容
</c:foeEach>语法2：迭代固定的次数.
<c:forEach [var="varName"] [varStatus="varStatusName"]
[begin="begin"] [end="end"] [step="step"]
Body内容
</c:foeEach>名字 类型 描述
var String 迭代的参数，它是标签参数，在其他标签中通过它来引用这个标签中的内容。
Items Collection、ArrayList、 要迭代的items集合.
Iterator、Map、String、
Eunmeration等
VarStatus String 表示迭代的状态，可以访问迭代自身的信息
Begin int 表示开始迭代的位置。
End int 表示结束迭代的位置。
Step int 表示迭代移动的步长，默认为1。URL相关的标签
1．<c:import>
语法1：资源的内容使用String对象向外暴露
<c:import url="url" [context="context"]
[var="varName"] [scope="{page|request|session|application}"] [charEncoding="charEncoding"]>
内容
</c:import>语法2：资源的内容使用Reader对象向外暴露。
<c:import url="url" [context="context"]
varReader="varReaderName" [charEncoding="charEncoding"]>
内容
</c:import>
名字 类型 描述
url String 待导入资源的URL，可以是相对路径和绝对路径，并且可以导入其他主机资源
context String 当使用相对路径访问外部context资源时，context指定了这个资源的名字。
var String 参数的名字。
scope String var参数的作用范围。
cahrEncoding String 输入资源的字符编码。
varReader String 这个参数的类型是Reader,用于读取资源。2．<c:redirct>
语法1:没有Body的情况.
<c:redirect url="value" [context="context"]/>
语法2：有Body情况下，在Body中指定查询的参数
<c:redirect url="value" [context="context"]>
<c:param name="name" value="value"/>
</c:redirect>3．<c:url>
语法1：没有Body
<c:url value="value" [context="context"] [var="varName"] [scope="{page|request|session+application}"]/>
语法2：有Body
<c:url value="value" [context="context"] [var="varName"] [scope="{page|request|session+application}"]>
<c:param name="name" value="value"/>
</c:url>名字 类型 描述
value String URL值
context String 当使用相对路径访问外部context资源时，context指定了这个资源的名字
var String 标识这个URL标量。
Scope String 变量作用范围。SQL相关的标签
1．<sql:setDataSource>
2．<sql:query>
3．<sql:update>
4．<transaction>
5．<param>[JSTL]<c:out>标签的用法
<c:out>标签的作用是用来显示表达式的值。它的作用是用来替代通过JSP内置对象out或者<%=%>标签来输出对象的值。
<c:out>标签的语法说明如下：
<c:out value="expression" default="expression" escapeXml="boolean"/>
<c:out>标签具有以下一些属性：
l value：用来定义需要求解的表达式。
l default：缺省值。当求解后的表达式为null或者String为空时将打印这个缺省值。
l escapeXML：这个属性是可选的。用于指定在使用<c:out>标记输出诸如“<”、“>;”和“&”之类的字符（在 HTML 和 XML 中具有特殊意义）时是否应该进行转义。如果将 escapeXml 设置为true，则会自动的进行编码处理。
[JSTL]<c:forEach>标签的使用
在JSP的开发中，迭代是经常要使用到的操作。例如，逐行的显示查询的结果等。在早期的JSP中，通常使用Scriptlets来实现Iterator或者Enumeration对象的迭代输出。现在，通过JSTL的迭代标签可以在很大的程度上简化迭代操作。
JSTL所支持的迭代标签有两个，分别是<c:forEach>和<c:forTokens>。在这里介绍的是<c:forEach>标签。
简单点说，<c:forEach>标签的作用就是迭代输出标签内部的内容。它既可以进行固定次数的迭代输出，也可以依据集合中对象的个数来决定迭代的次数。
<c:forEach>标签的语法定义如下所示。
<c:forEach var="name" items="expression" varStatus="name"
begin="expression" end="expression" step="expression">
body content
</c:forEach>
<c:forEach>标签具有以下一些属性：
l var：迭代参数的名称。在迭代体中可以使用的变量的名称，用来表示每一个迭代变量。类型为String。
l items：要进行迭代的集合。对于它所支持的类型将在下面进行讲解。
l varStatus：迭代变量的名称，用来表示迭代的状态，可以访问到迭代自身的信息。
l begin：如果指定了items，那么迭代就从items[begin]开始进行迭代；如果没有指定items，那么就从begin开始迭代。它的类型为整数。
l end：如果指定了items，那么就在items[end]结束迭代；如果没有指定items，那么就在end结束迭代。它的类型也为整数。
l step：迭代的步长。
<c:forEach>标签的items属性支持Java平台所提供的所有标准集合类型。此外，您可以使用该操作来迭代数组（包括基本类型数组）中的元素。它所支持的集合类型以及迭代的元素如下所示：
l java.util.Collection：调用iterator()来获得的元素。
l java.util.Map：通过java.util.Map.Entry所获得的实例。
l java.util.Iterator：迭代器元素。
l java.util.Enumeration：枚举元素。
l Object实例数组：数组元素。
l 基本类型值数组：经过包装的数组元素。
l 用逗号定界的String：分割后的子字符串。
l javax.servlet.jsp.jstl.sql.Result：SQL查询所获得的行。
不论是对整数还是对集合进行迭代，<c:forEach>的varStatus属性所起的作用相同。和var属性一样，varStatus用于创建限定了作用域的变量（改变量只在当前标签体内起作用）。不过，由varStatus属性命名的变量并不存储当前索引值或当前元素，而是赋予javax.servlet.jsp.jstl.core.LoopTagStatus类的实例。该类包含了一系列的特性，它们描述了迭代的当前状态，如下这些属性的含义如下所示：
l current：当前这次迭代的（集合中的）项。
l index：当前这次迭代从0开始的迭代索引。
l count：当前这次迭代从1开始的迭代计数。
l first：用来表明当前这轮迭代是否为第一次迭代，该属性为boolean类型。
l last：用来表明当前这轮迭代是否为最后一次迭代，该属性为boolean类型。
l begin：begin属性的值。
l end：end属性的值
l step：step属性的值
下面就来看两个基本的例子，第一个例子是依次输出集合内的元素。
<c:forEach var="item" items="${contents}" varStatus="status">
$status.count：${item}
</c:forEach>
下面的例子是一个固定次数的迭代，用来输出1到9的平方。
<c:forEach var="x" begin="1" end="9" step="1">
${x*x}
</c:forEach>
[JSTL]<c:if>标签的使用
<c:if>标签用来在页面中实现条件化的判断功能。它的主要目的就是替换Java脚本中的if语句，来实现页面内容的条件化输出功能。这个标签所进行的判读主要是依据表达式来进行的，如果该表达式的求解值为true，那么表示条件成立，将会输出标签体中的内容。否则将不会产生任何的输出。
<c:if>标签的语法说明如下：
<c:if test="expression" var="name" scope="scope">
body content
</c:if>
<c:if>标签具有以下一些属性：
l test：用来指定条件判断的表达式。
l var：测定结果的变量名，用来保存条件判断表达式的结果。这样做的目的就是避免在页面中多次进行相同的判断。
l scope：测试结果变量的作用域范围。
在下面的示例中，所实现的判断表达式进行了两个判断，一个是listSiz是否大于pageSize，另一个是pageEnd是否小于listSize。两个判断是并且（and）的关系。
<c:if test="${(listSize gt pageSize) and (pageEnd lt listSize)}">
……
</c:if>
这里的<c:if>标签为条件化内容的一些简单情形提供了一种非常简洁的表示法。对于需要进行互斥测试来确定应该显示什么内容的情况下，就需要使用JSTL核心库的<c:choose>标签来实现了。
[JSTL]<c:set>标签的用法
<c:set>标签的作用是在JSP页面中创建限制了作用域的变量。如果在该作用域中已经存在了要创建的变量，那么该标签只会简单的将所指定的值赋给该变量。
<c:set>标签的语法定义如下所示：
<c:set var="name" scope="scope" value="expression"/>
<c:set>标签具有以下一些属性：
l var：所定义或者使用的变量的名称。
l scope：该变量的作用域，缺省值为page。
l value：变量的值。
这个标签的用法相对来说是比较简单的，下面来看两个简单的示例。在第一个示例中，将会话作用域变量设置成String值。在第二个示例中，用表达式来设置数值：将页面作用域内名为square的变量赋值为名为x的请求参数的值的平方。
<c:set var="timezone" scope="session" value="CST"/>
<c:set var="square" value="${param['x'] * param['x']}"/>
另外，还可以将所定义的变量的值设置为<c:set>标签体中的内容。所以，上面第一个示例也可以使用如下的形式来实现。
<c:set var="timezone" scope="session">CST</c:set>
扫一扫
811
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
