JSTL标签用法

关键字：JSTL标签、<c:choose>、<c:forEach>、<c:forTokens>、<c:if>、<c:import>、<c:otherwise>、<c:out>、<c:param>、<c:redirect>、<c:remove>、<c:url>、<c:when>、<c:set>、<c:catch>

原来一直没有看过，我说过我是新手，但是好多资料上似乎也不重视 JSTL 。我看项目源代码发现其中使用到了这个标签库，感觉其还真是方便，页面看起来更加清爽。减少了 JAVA 程序员亲自写的代码量，还真验证了，不懒不做程序员，程序员如果写代码不想着偷懒，那么生活是很无趣的。

下面总结总结，学习学习。：）

JSP 标准标记库（ Standard Tag Library ， JSTL) 是一组以标准化格式实现许多通用的 Web 站点功能的定制标记。

JSP 技术的优势之一在于其定制标记库工具。除了核心 JSP 标记，如 jsp:include 之外，定制标记库工具使您能够创建唯一的标记来描述以站点或应用程序为导向的操作。一旦您创建了定制标记库 ( 简称 taglib) ，当您扩展项目或转向另一个项目时您可以重复使用这些标记。您还可以将 taglib 传递给其它开发人员，从而他们可以在自己的网站上使用，或者在您 Web 应用程序的其它部分使用。

     

       JSTL 的目标是为了简化 JSP 页面的设计。对于页面设计人员来说，使用脚本语言（默认值是 JAVA 语言）操作动态数据是比较困难的，而采用标签和表达式语言相对容易一些， JSTL 的使用为页面设计人员和程序开发人员的分工协作提供了便利。


一． 配置 JSTL


包括两个 JAR 文件， jstl.jar 和 standard.jar 。是什么没有必要管，重在应用（ 1+1 ？ =2 ，我们没有必要深究，只需要知道这么用就行。）。


原文引入：

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>

<%@ taglib prefix="sql" uri="http://java.sun.com/jsp/jstl/sql" %>

<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>

                                                           
二． Core 标签库


Core 标签库主要包括了一般用途的标签、条件标签、迭代标签和 URL 相关的标签。在 JSP 页面使用 Core 标签，要使用 taglig 指令，指定引用的标签库，如下：

<%@ taglib rui=”http://java.sun.com/jsp/jstl/core” prefix=”c” %>


一般用途的标签有 <c:out> 、 <c:set> 、 <c:remove> 、 <c:cath>

1.<c:out>

用于计算一个表达式并将结果输出。类似于 JSP 中 <%=%> 表达式，或者是 EL 中 $ ${el-expression} 。


2.<c:set>

用于设置范围变量的值或者 javabean 对象的属性。

看个实际例子：

<c:set var=”username” value=”lisi” scope=”session”/>

这样就相当于设置了 session 。


3.<c:remove>

相对 <c:set> 其作用是移除范围变量。比如： <c:remove var=”nusername” scope=”session”/>


4.<c:catch>


用于捕获在其中嵌套的操作所抛出的异常对象，并将异常信息保存到变量中。

我们将有可能抛出异常的代码放置到开始标签 :<c:catch> 和结束标签 :</c:catch> 之间。如果其中代码出现异常，异常对象将被捕获，保存在 var 声明的变量中，该变量总是有 page 范围。如果没有发生异常，而 var 所标识的范围变量将被移除。

如果没有指定 var 属性，异常只是简单的被捕获，异常信息并不会被保存。

Eg ：

<c:catch var=”exception”>

<%

       int i = 5;

       int j = 0;

       int k=i/j;

%>

</c:catch>

<c:out value=”${exception}” /><br>

<c:out value=”${exception.massage}”/>

后一句相当于： exception.getMessage()


条件标签包括 <c:if><c:choose><c:when><c:otherwise>

1.<c:if>

用于实现 java 中的 if 语句功能。


<c:if test=”${user.visitCount==1}”>

       This is your first visit .

</c:if>


若为 true ，会打印中间部分。也可以声明 var ，方便下一步判断。

<c:if test=”${param.name==’admin’}” value=”result”/>

<c:out value=”${result}” />


2.<c:choose>

<c:choose> 和 <c:when> 、 <c:otherwise> 一起实现互斥条件执行，类似于 java 中的 if else.

<c:choose> 一般作为 <c:when> 、 <c:otherwise> 的父标签。

eg ：

<c:choose>

       <c:when test="${row.v_money<10000}">

              初学下海

       </c:when>

       <c:when test="${row.v_money>=10000&&row.v_money<20000}">

              身手小试

       </c:when>

       <c:otherwise>

              商业能手

       </c:otherwise>

</c:choose>


迭代标签

迭代标签有 <c:forEach> 和 </c:forEach>


// 遍历记录集

<c:forEach items="${finalResult.rows}" var="row">      

<tr class="<%=tdClass[(rank+1)%2]%>">

<td align="center"><span><%=rank%> </span></td>

<td align="center"><span ><c:out value="${row.player_name}"/></span> </td>

<td align="center"><span > ￥ <c:out value="${row.money}"/></span></td>

</tr>

<%rank++;%>    

</c:forEach>


也可以设定固定次数。

<c:forEach var =”i” begin=”100 “ end= “110”>

       ${i}

</c:forEach>

如果再加个 step= “ 2 ”那么每次增长为 2 。


三． sql 标签


设置数据源：

<sql:setDataSource dataSource="proxool.breadTycoon" />

// 将数据库某查询的结果声明为一个变量

<sql:query var="finalResult" >

    select player_name,money from tb_player order by money DESC LIMIT 10  

</sql:query>

       然后可以：

<c:forEach items="${ finalResult.rows}" var="row" varStatus="s">

        advCosts[${s.index}]=${row.adv_cost};

   </c:forEach>

       数据更新标签：

<sql:update> 

                call proc_set_role_salespro(?,?,?,?,?);

                <sql:param value="30"/>

                <sql:param value="39"/>

                <sql:param value="<%=spID%>"/>

                <sql:param value="<%=productID%>"/>

                <sql:param value="1"/>              

            </sql:update>


<sql:query var="queryAllChannelCount">

SELECT COUNT(*) as total FROM tb_channel WHERE game_id=? AND begin_round<func_cur_round(?) AND player_id=? AND channel_flag=0

<sql:param value="${gameID}"/>

<sql:param value="${gameID}"/>

<sql:param value="${playerID}"/>

</sql:query>

<c:forEach items="${queryAllChannelCount.rowsByIndex}" var="channelCN">

       <c:set value="${channelCN[0]}" var="channelTotal"/>

</c:forEach>


调用存储过程更新数据库：

<c:if test="${param.changsubmit!=null}" >

<c:forEach items="${paramValues.pro_id}" var="getpro_id" varStatus="getparamsta">

<sql:update>


call proc_set_role_product(?,?,?,?,?,?,?,?);


<sql:param value="${gameID}"/>

<sql:param value="${playerID}"/>

<sql:param value="${getpro_id}"/>

<sql:param value="${getpro_id}"/>

<sql:param value="${paramValues.pro_sort[getparamsta.index]}"/>

<sql:param value="${paramValues.price[getparamsta.index]}"/>

<sql:param value="${paramValues.output[getparamsta.index]}"/>

<sql:param value="0"/>

</sql:update>

</c:forEach>

</c:if>

四． 格式化标签


<fmt: formatNumber value =”12.3” pattern=”.000”/>

将输出 12.300. 应用样式 ”.000”, 将使格式化后的小数部分有 3 位。不足 3 位将以 0 补齐。


       <fmt:formatDate value=”<%=new java.util.Date() %>” type=”date” />

       格式化的结果是： 2007-5-27 .

<fmt:formatDate value=”<%=new java.util.Date() %>” type=”time” />

格式化的结果是： 9:25:11

<fmt:formatDate value=”<%=new java.util.Date() %>” type=”both” />

格式化的结果是： 2007-5-27 9:25:11




补充知识点：


1. 替换 request.getParameter("test"):

<c:if test="${param.test!=null}" >

<c:out value="${param.test}" />

</c:if>


2. <c:redirect url="a.jsp">


3.<c:redirect url="/max.jsp" context="/ch16">

<c:param name="name1" value="665"/>

<c:param name="name3" value=" 斯蒂芬 "/>

</c:redirect>


4.<c:forTokens items="zhangsan:lisi:as" delims=":" var="name">

${name}

</c:forTokens>




----------------------------------------------------------------------
JSTL简介
JSTL是一个不断完善的开放源代码的JSP标签库，是由apache的jakarta小组来维护的。JSTL只能运行在支持JSP1.2和Servlet2.3规范的容器上，如tomcat 4.x。但是在即将推出的JSP 2.0中是作为标准支持的。
JSTL目前的最新版本为1.02，最终发布版为1.0。JSTL包含两个部分：标签库和EL（Exdivssion 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语言只能通过建立表达式来进行调用。在属性值中使用表达式有三种方式。
1、 value属性包含一个表达式
<some:tag value=""/>
在这种情况下，表达式值被计算出来并根据类型转换规则赋值给value属性。比如：<c:out value="" />中的就是一个EL，它相当于JSP语句<%=request.getAttribute(“username”)%>或<% =session.getAttribute(“username”)%>
2、 value属性包含一个或多个属性，这些属性被文本分割或围绕
<some:tag value="sometext"/>
在这种情况下，表达式从左到右进行计算，并将结果转换为字符串型（根据类型转换规则），并将结果赋值给value属性
3、 value属性仅仅包含文本
<some:tag value="sometext"/>
在这种情况下，字符串型属性value将根据类型转换规则转换为标签所希望的类型。
EL语言的操作符
取得某个对象或集合中的属性值
为了获得集合中的属性，EL支持以下两种操作
1．使用.操作符来获得有名字的属性。例如表达式表明对象user的username属性
2． 使用[]操作符来获得有名字或按数字排列的属性。
表达式和表达式含义相同
表达式 表明row集合的第一个条目。
在这里user是一个类的对象，它的属性username必须符合标准JavaBean的规范，即必须为username属性定义相应的getter、setter方法。
Empty操作符(空值检查)
使用empty操作符来决定对象、集合或字符串变量是否为空或null。例如：
true
如果request的参数列表中的username值为null，则表达式的值为true。 EL也可以直接使用比较操作符与null进行比较。如true。
比较操作符 操作符 描述
==或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=”” default=”guest”/>
显示用户的用户名，如为空则显示guest
<c:out value=""/>
指定从session中获取username的值显示；
<c:out value="" />
显示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="" var="test2" scope=”session” />
将test.testinfo的值保存到session的test2中，其中test是一个javabean的实例，testinfo是test对象的属性。
<c:set target="" property="city" value=""/>
将对象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 is true.
</c:if>
如果user.wealthy值true，则显示user.wealthy is true.
<c:choose>
<c:when test="">
user.generous is true.
</c:when>
<c:when test="">
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="" var="vector">
<c:out value=""/>
</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=""/><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=""/>
</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的书都是精品。



----------------------------------------------------------------