标签 | 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 ...> |
1. <c:out>
库 :Core(核心库)
URI : http://java.sun.com/jsp/jstl/core
前缀 : c
描述 :<c:out> 标签是一个最常用的标签,用于在 JSP 中显示数据。 它的作用是用来替代通过 JSP 内 置对象 out 或者 <%=%> 标签来输出对象的值。
语法 :
没有Body时的语法
<c:outvalue=”value”[escapeXml=”{true|false}”][default=”defaultValue”]/>
有Body时的语法
<c:outvalue=”value”[escapeXml=”{true|false}”]>
这里是Body部分
</c:out>
属性 :
属性名 |
描述 |
类型 |
是否接受动态值 |
是否支持 EL |
是否 必须 |
默认值 |
说明 |
value |
需要显示的值 |
Object |
Y |
Y |
Y |
无 |
用来定义需要求解的表达式。 |
escapeXml |
是否转换特殊字符 |
boolean |
Y |
Y |
N |
true |
用于指定在使用 <c:out> 标记输出诸如“ < ”、“ > ”、“ ’ ”、“ ” ”和“ & ”之类的字符(在 HTML 和 XML 中具有特殊意义)时是否应该进行转义。如果将 escapeXml 设置为 true ,则会自动的进行编码处理。 |
default |
缺省值 |
Object |
Y |
Y |
N |
无 |
当求解后的表达式为 null 或者 String 为空时将打印这个缺省值。 |
Null和错误说明
假若value为null,会显示default的值;假若没有设定default的值,则会显示一个空的字符串。
实例 :
------------------------------------------------------------------------------------------------------------------------------------------
Example1
<c:outvalue="${sessionScope.anyValue}"default="novalue"escapeXml="false"/>
该示例将从Session查找名为“anyValue”的参数,并显示在页面,若没有找到则显示“novalue”。
------------------------------------------------------------------------------------------------------------------------------------------
Example2
您的用户名是:<c:outvalue=”${user.username}”default=”guest”/>
显示用户的用户名,如为空则显示guest
<c:outvalue="${sessionScope.username}"/>
指定从session中获取username的值显示;
<c:outvalue="${username}"/>
显示username的值,默认是从request(page)中取,如果request中没有名为username的对象则从session中取,session中没有则从application(servletContext)中取,如果没有取到任何值则不显示
------------------------------------------------------------------------------------------------------------------------------------------
2. <c:set>
库 :Core(核心库)
URI : http://java.sun.com/jsp/jstl/core
前缀 : c
描述 : <c:set>标签用于为变量或JavaBean中的变量属性赋值的工作。这个标签用于在某个范围(page、request、session、application等)中使用某个名字设定特定的值,或者设定某个已经存在的javabean对象的属性。他类似于<%request.setAttrbute("name","value");%>
语法 :
语法1:没有body
将value的值存储至范围为scope的varName变量之中
<c:setvalue="value"var="varName"[scope="{page|request|session|application}"]/>
语法2:有body
将body内容存储至范围为scope的varName变量之中
<c:setvalue="value"[scope="{page|request|session|application}"]>
body.....
</c:set>
语法3:将value的值存储至target对象属性中
<c:setvalue="value"target="target"property="propertyNmae"/>
语法4:将body内容的数据存储至target对象属性中
<c:settarget="target"property="propertyNmae">
body....
</c:set>
Ø Null和错误处理:
语法3和语法4会产生异常错误,有以下两种情况:
.target为null
.target不是java.util.Map或JavaBean对象
假若value为null时:将由存储变量改为移除变量
.语法1:由var和scope所定义的变量,将被移除
.若scope已指定时,则PageContext.removeAttribute(varName,scope);
.若scope未指定时,则PageContext.removeAttribute(varName);
.语法3:
.假若target为Map时,则Map.remove(property);
.假若target为JavaBean时,propertye指定的属性为null
注意:var和scope这两个属性不能使用表达式来表示,我们不能写成scope="${ourScope}"或var="${a}"
属性 :
属性名 |
描述 |
类型 |
是否接受动态值 |
是否支持 EL |
是否 必须 |
默认值 |
说明 |
value |
要被存储的值 |
Object |
true |
Y |
否 |
无
|
被计算的表达式 |
var |
变量名 |
String |
false |
N |
否 |
无
|
被导出的保存了value属性计算结果的范围变量的名称 |
scope |
范围 |
String |
true |
N |
否 |
page |
var的JSP范围 |
target |
目标对象 |
String |
true |
Y |
否 |
无
|
要设置属性的对象。必须是JavaBean对象或java.util.Map对象 |
property |
指定target对象属性 |
Object |
true |
Y |
否 |
无
|
要设置的target对象的属性的名称 |
实例 :
------------------------------------------------------------------------------------------------------------------------------------------
Example1
<c:setvalue="thisisandy"var="oneString"/>
该示例将为名为“oneString”的变量赋值为“thisisandy”,其作用范围为page。
------------------------------------------------------------------------------------------------------------------------------------------
Example2
<c:settarget="${cust.address}"property="city"value="$"/>
将对象cust.address的city属性值保存到变量city中。
------------------------------------------------------------------------------------------------------------------------------------------
Example3
设置不同的属性,并且指定它们的范围:
<c:setvalue="10000"var="maxUser"scope="application"/>
<c:setvalue="20"var="maxIdelTime"scope="session"/>
<c:setvalue="next.jsp"var="nextPage"scope="page"/>
------------------------------------------------------------------------------------------------------------------------------------------
Example4
<c:setvar="bid"value="${param.bookId}"/>
<jsp:setPropertyname="bookDB"property="bookId"value="${bid}"/>
------------------------------------------------------------------------------------------------------------------------------------------
Example5
<%Foofoo=newFoo();pageContext.setAttribute("foo",foo);%>
<c:outvalue="${foo.date}"/><br><c:settarget="${foo}"property="day"value="1"/>
<c:outvalue="${foo.date}"/>
------------------------------------------------------------------------------------------------------------------------------------------
3. <c:remove>
库 :Core(核心库)
URI : http://java.sun.com/jsp/jstl/core
前缀 : c
描述 : <c:remove>标签用于删除存在于scope中的变量。 类似于 <%session.removeAttribute(“name”)%> 、
<%request.removeAttribute(“name”)%>...
语法 :
<c:removevar="varName"[scope="{page|request|session|application}"]/>
属性 :
属性名 |
描述 |
类型 |
是否接受动态值 |
是否支持 EL |
是否 必须 |
默认值 |
说明 |
var |
变量名 |
String |
N |
N |
是 |
无 |
欲移除变量的名称 |
scope |
范围 |
String |
N |
N |
否 |
page |
var变量的JSP范围;若没有指定,默认为全部查找 |
------------------------------------------------------------------------------------------------------------------------------------------
实例 :
Example1
<c:removevar="sampleValue"scope="session"/>
${sessionScope.sampleValue}
------------------------------------------------------------------------------------------------------------------------------------------
Example2
<c:removevar="username"scope="session"/>
将username变量从session范围移除。若我们不设定scope,则<c:remove>会移除所有范围名称为username
的数据。
------------------------------------------------------------------------------------------------------------------------------------------
4. <c:catch>
库 :Core(核心库)
URI : http://java.sun.com/jsp/jstl/core
前缀 : c
描述 : <c:catch>动作用于捕获JSP元素在其体中抛出的异常,从而提供细粒度的错误控制, 此异常也可以保存为一个页面作用域变量。当错误发生<c:catch>和</c:catch>之间时,只有<c:catch>和</c:catch>之间的程序会被中止忽略,但整个网页不会被中止。 它包含一个var属性,是一个描述异常的变量,该变量可选。若没有var属性的定义,那么仅仅捕捉异常而不做任何事情,若定义了var属性,则可以利用var所定义的异常变量进行判断转发到其他页面或提示报错信息。
语法 :
<c:catch[var="var"]>
//可能发生错误的部分
JSPelements
</c:catch>
属性 :
属性名 |
描述 |
类型 |
是否接受动态值 |
是否支持 EL |
是否 必须 |
默认值 |
说明 |
var |
变量名 |
String |
N |
N |
N |
无 |
用来存储错误信息的变量 |
实例 :
------------------------------------------------------------------------------------------------------------------------------------------
Example1
<c:catchvar="importException">
<fmt:parseDatevalue="${param.empDate}"dateStyle="short"/>
</c:catch>
<c:iftest="${importException!=null}">
<jsp:forwardpage="input.jsp">
<jsp:paramname="msg"value="Invaliddateformat"/>
</jsp:forward>
</c:if>
------------------------------------------------------------------------------------------------------------------------------------------
Example2
<c:catchvar="err">
${param.sampleSingleValue[9]==3}
</c:catch>
${err}
当“${param.sampleSingleValue[9]==3}”表达式有异常时,可以从var属性“err”得到异常的内容,通常判断“err”是否为null来决定错误信息的提示。
------------------------------------------------------------------------------------------------------------------------------------------
5. <c:if>
库 :Core(核心库)
URI : http://java.sun.com/jsp/jstl/core
前缀 : c
描述 : <c:if>动作仅当所指定的表达式计算为true时才计算其体。计算结果也可以保存为一个作用域Boolean变量。
语法 :
语法1:没有体
<c:iftest=" booleanExpression "
var=" var "[scope=" page |request|session|application"]/>
语法2:有体
<c:iftest=" booleanExpression ">
JSPelements
</c:if>
属性 :
属性名 |
描述 |
类型 |
是否接受动态值 |
是否支持 EL |
是否 必须 |
默认值 |
说明 |
test |
测试表达式 |
boolean |
Y
|
Y |
是 |
无 |
如果表达式的结果为true则执行body,false则相反 |
var |
变量名 |
String |
N |
N |
否 |
无 |
用来存储test运算后的结果,即true或false |
scope |
变量作用域 |
String |
N |
N |
否 |
page |
var变量的JSP范围 |
实例 :
<c:iftest="${emptyparam.empDate}">
<jsp:forwardpage="input.jsp">
<jsp:paramname="msg"value="MissingtheEmploymentDate"/>
</jsp:forward>
</c:if>
6. <c:choose>
库 :Core(核心库)
URI : http://java.sun.com/jsp/jstl/core
前缀 : c
描述 : <c:choose>动作用于控制嵌套<c:when>和<c:otherwise>动作的处理,它只允许第一个测试表达式计算为true的<c:when>动作得到处理;如果所有<c:when>动作的测试表达式都计算为false,则会处理一个<c:otherwise>动作。<c:choose>标签没有属性,可以被认为是父标签,<c:when>、<c:otherwise>将作为其子标签来使用。
语法 :
<c:choose>
body(<when>和<otherwise>)
</c:choose>
限制:
<c:choose>的本地内容只能有:
.空白
.1或多个<c:when>
.0或多个<c:otherwise>
属性 :
无
实例 :
----------------------------------------------------------------------------------------------------------------------------------------
Example1
<c:choose>
<c:whentest="${product.onSale}">
${product.salesPrice}Onsale!
</c:when>
<c:otherwise>
${product.price}
</c:otherwise>
</c:choose>
---------------------------------------------------------------------------------------------------------------------------------------
Example2
<c:choose>
<c:whentest="${condition1}">
condition1为true
</c:when>
<c:whentest="${condition2}">
condition2为true
</c:when>
<c:otherwise>
condition1和conditon2都为false
</<c:otherwise>
说明:
在同一个<c:choose>中,假如所有的<c:when>的test都不为true时,则执行<c:otherwise>的本体内容。
在同一个<c:choose>中,假若有好几个<c:when>都会true时,只能有一个<c:when>成立。
</c:choose>
----------------------------------------------------------------------------------------------------------------------------------------
7. <c:when>
库 :Core(核心库)
URI : http://java.sun.com/jsp/jstl/core
前缀 : c
描述 :<c:when>标签等价于“if”语句,它包含一个test属性,该属性表示需要判断的条件。
语法 :
<c:whentest="testCondition">
Bodycontent
</c:when>
属性 :
属性名 |
描述 |
类型 |
是否接受动态值 |
是否支持 EL |
是否 必须 |
默认值 |
说明 |
test |
测试表达式 |
boolean |
Y |
Y |
是 |
无 |
如果表达式的结果为true则执行body,false则相反 |
实例 :
8. <c:otherwise>
库 :Core(核心库)
URI : http://java.sun.com/jsp/jstl/core
前缀 : c
描述 :<c:otherwise>标签没有属性,它等价于“else”语句。
语法 :
<c:otherwise>
conditionalblock
</c:otherwise>
属性 :
无
实例 :
<c:choose>、<c:when>、<c:otherwise>标签 综合实例
<c:choose>
<c:whentest="${paramValues.sampleValue[2]==11}">
not12not13,itis11
</c:when>
<c:whentest="${paramValues.sampleValue[2]==12}">
not11not13,itis12
</c:when>
<c:whentest="${paramValues.sampleValue[2]==13}">
not11not12,itis13
</c:when>
<c:otherwise>
not11、12、13
</c:otherwise>
</c:choose>