JSTL(1.1)之Core tag Libray

Posted on 2006-07-04 13:47 多力宇扬 阅读(564) 评论(0)  编辑  收藏 所属分类: View tier

JavaServer Pages Standard Tag Libray(1.1),其中文名字为JSP标准标签函数库。JSTL是一个标准的已
制定好的标签库,可以应用于各种领域,如:基本输入输出,流程控制,循环,XML文件剖析,数据库查
询以及国际化和文字格式标准化的应用等。JSTL所提供的标签库分为以下五大类:
 核心标签库(Core tag Liabry)
 I18N格式标签库(I18N-capable formatting tag libary)
 SQL标签库(SQL tag Libary)
 XML标签库(XML tag Libary)
 函数标签库(Functions tag Libary)

核心标签库(Core tag Liabry)主要有:基本输入输出,流程控制,迭代操作和URL操作。
 ----------------------------------------------------------------------------
      分类            功能分类                 标签分类
                                                             out
                                                              set
                          表达式操作                     remove
                                                                   catch
  
     Core                                                      if
                                                                   choose
                           流程控制                            when
                                                                       outherwise

                                                                    forEach
                              迭代操作                      forTokens

                                                                       import
                                                                          param
                                                                       url
                                 URL操作                          param
                                                                     redirect
                                                                           param
------------------------------------------------------------------------------------------
在JSP中使用JSTL中的标签库时,必须使用<%@taglib%>指令,并且设定prefix和uri的值得,通常设定:
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
这样就可以使用核心标签库了。

.表达式操作
 表达式操作分类中包含四个标签: <c:out>,<c:set>,<c:remove>和<c:catch>
<c:out>:重要用来显示数据的内容,类似与<%=scripting-language%>。它的语法如下:
语法1: 没有body内容
<c:out value="value" [escapeXml="{true|false}"] [default="defaultValue"]/>

语法2: 有body内容
<c:out value="value"  [escapeXml="{true|false}"]>
  default value
</c:out>

Attribute
-----------------------------------------------------------------------------------------------------------------------
 名称                      说明                                                               EL     类型     必须       默认值
value                  需要显示的值                                                     Y      Object    是          无
default               如果value值为null,则显示default的值                  Y      Object    否          无
escapeXml        是否转换特殊字符,如: <转换为&It                 Y      Object    否          true
----------------------------------------------------------------------------------------------------------------------
Null和错误说明
假若value为null,会显示default的值;假若没有设定default的值,则会显示一个空的字符串。

<c:set>:主要用来把变量存储至JSP范围或是JavaBean的属性中。
语法1: 没有body
将value的值存储至范围为scope的varName变量之中
<c:set value="value" var="varName" [scope="{page|request|session|application}"]/>

语法2: 有body
将body内容存储至范围为scope的varName变量之中
<c:set value="value" [scope="{page|request|session|application}"]>
  body.....
</c:set>

语法3: 将value的值存储至target对象属性中
<c:set value="value" target="target" property="propertyNmae"/>

语法4: 将body内容的数据存储至target对象属性中
<c:set target="target" property="propertyNmae">
 body....
</c:set>

Attribute
----------------------------------------------------------------------------------------
 名称                    说明                                              EL     类型      必须      默认值
value             要被存储的值                                      Y      Object      否          无
var                欲存入的变量名                                  N      String        否          无
scope            var变量的JSP范围                               N      String        否         page
target            为一JavaBean或java.util.Map对象        Y      Object       否          无
property        指定target对象属性                              Y      String        否          无
------------------------------------------------------------------------------------------
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}"

<c:remove>:主要用来移除变量。
语法:
<c:remove var="varName" [scope="{page|request|session|application}"]/>

Attribute
----------------------------------------------------------------------------------------
 名称                 说明                                     EL     类型     必须       默认值
 var             欲移除变量的名称                     N      String     是              无
 scope           var变量的JSP范围                    N      String     否             page
----------------------------------------------------------------------------------------
说明:
<c:remove>必须要有var属性,即要被移除的属性名称,scope则可有可无,如:
<c:remove var="username" scope="session"/>
将username变量从session范围移除。若我们不设定scope,则<c:remove>会移除所有范围名称为username
的数据。

<c:catch>:主要用来处理产生错误的异常情况,并且将信息保存起来。
语法:
<c:catch [var="varName"]>
 ...欲抓取错误的部分...
</c:catch>

Attribute
----------------------------------------------------------------------------------------
 名称                 说明                                           EL     类型     必须       默认值
 var           用来存储错误信息的变量                 N      String       否          无
-----------------------------------------------------------------------------------------
说明:
<c:catch>主要将可能发生错误的部分放在<c:catch>和</c:catch>之间。如果真的发生错误,可将错误
信息保存至变量varName标量中,如:
<c:catch var="message">
    //可能发生错误的部分
</catch>
另外,当错误发生<c:catch>和</c:catch>之间时,只有<c:catch>和</c:catch>之间的程序会被中止忽
略,但整个网页不会被中止。

流程控制
流程控制分类中包含四个标签:<c:if>,<c:choose>,<c:when>和<c:otherwise>。

<c:if>:的用途和我们在一般程序中写的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|appliation}"]>
  ...body....
</c:if>

Attribute
------------------------------------------------------------------------------------------------------------------------
 名称                           说明                                                                           EL     类型        必须       默认值
test                   如果表达式的结果为true则执行body,false则相反              Y      boolean       是           无
var                   用来存储test运算后的结果,即true或false                           N     String          否           无
scope               var变量的JSP范围                                                                  N     String          否          page
------------------------------------------------------------------------------------------------------------------------
说明:
<c:if>标签必须要有test属性,body里除了能是静态文本之外可以是任何JSP代码,标签或HTML代码。

<c:choose>:本身只当作<c:when>和<c:otherwise>的父标签。
语法:
<c:choose>
  body(<when>和<otherwise>)
</c:choose>
限制:
<c:choose>的本地内容只能有:
 .空白
 .1或多个<c:when>
 .0或多个<c:otherwise>
如:
<c:choose>

 <c:when test="${condition1}">
   condition1 为 true
 </c:when>

 <c:when test="${condition2}">
   condition2 为 true
 </c:when>

 <c:otherwise>
   condition1和conditon2都为false
 </<c:otherwise >
 
</c:choose>
说明:
在同一个<c:choose>中,假如所有的<c:when>的test都不为true时,则执行<c:otherwise>的本体内容。
在同一个<c:choose>中,假若有好几个<c:when>都会true时,只能有一个<c:when>成立。

迭代操作
迭代(Iterator)操作主要包含两个标签: <c:forEach>和<c:forTokens>。

<c:forEach>为循环控制,它可以将集合(Collection)中的成员循序浏览一遍。运做方式为当条件符合
时,就会持续重复执行<c:forEach>的body内容。
语法:
语法1: 迭代一集合对象之所有成员
<c:forEach [var="varName"] items="collection" [varStatus="varStatusName"]
           [begin="begin"] [end="end"] [step="step"]>
 ...body内容.....
<c:forEach>

语法2: 迭代指定的次数
<c:forEach [var="varName"] [varStatus="varStatusName"]
           begin="begin" end="end" [step="step"]>
 ...body内容.....
<c:forEach>

Attribute
--------------------------------------------------------------------------------------------------------------------------
 名称                 说明                                                   EL     类型             必须       默认值
 var          用来存放现在指到的成员                          N      String               否           无

                                                                                               Arrays
                                                                                              Collection
                                                                                               Iterator             否           无
items         被迭代的集合对象                                    Y        Enumeration            
                                                                                               Map
                                                                                                String

varStatus     用来存放到指到的相关成员信息          N        String               否           无
begin           开始的位置                                             Y          int                    否           0
end              结束的位置                                             Y          int                   否           最后一个成员
setp             每次迭代的间隔数                                 Y          int                   否            1
-------------------------------------------------------------------------------------------------------------------------
Null 和 错误处理
.假若items为null时,则表示为一空的集合对象
.假若begin大于或等于items时,则迭代不运算
注意:
varName的范围只存在<c:forEach>的本体中,如果超出了本题,则不能取得varName的值。如:
<c:forEach items="${atts}" var="item">
</c:forEach>
${item}</br>
${item}则不会显示item的内容。<c:forEach>除了支持数组之外,还有标准的J2SE的结合类型,例如:
ArrayList,List,LinkedList,Vector,Stack和Set等等;另外包括java.util.Map类的对象,例如:
HashMap,Hashtable,Properties,Provider和Attributes。

另外<c:forEach>还提供了varStatus属性,主要用来存放现在指到成员的相关信息。例如:我们写成
varStatus="s",那么就会把信息存放到名称为s的属性当中。varStatus属性还提供另外四个属性:index,
count,fist和last,它们个自的意义如下:
------------------------------------------------------------------------------------------
   属性                    类型                                   意义
   index                   number                      现在指到成员的索引
   count                   number                      总共指到成员的总和
   first                     boolean                     现在指到成员是否为第一个
   last                     boolean                     现在指到成员是否为最后一个
-------------------------------------------------------------------------------------------
如下例子:
<%@page contentType="text/html;charset=gb2312"%>
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<%
 String atts[] = new String[5];
 atts[0]="hello";
 atts[1]="this";
 atts[2]="is";
 atts[3]="a";
 atts[4]="girl";
 request.setAttritue("atts",atts);
%>
<c:forEach items="${atts}" var="item" varStatus="s">
<h2><c:out value="${item}"/>的四种属性></h2>
 index: ${s.index}</br>
 count: ${s.count}</br>
 first: ${s.first}</br>
 last:  ${s.last}</br>
</c:forEach>

<c:forTokens>
<c:forTokens>:用来浏览一字符串中所有的成员,起成员是由定义符号(delimiters)所分隔的。
语法:
<c:forTokens items="stringFoTokens" delims="delimmmmiters" [var="varName"]
             [varStatus="varStatusName"] [begin="begin"] [end="end"] [step="step"]>
 ...body内容....
</c:forTokens>

Attribute
--------------------------------------------------------------------------------------------------------------------
 名称                                    说明                                               EL     类型      必须       默认值
 var                   用来存放现在指到的成员                                Y      String       否          无
 items                被迭代的字符串                                                Y      String       是          无
 delims              定义用来分割字符串的字符                            N      String       是          无
 varStatus          用来存放现在指到的相关成员信息                N      String       否          无
 begin               开始的位置                                                         Y       int           否           0
 end                 结束的位置                                                          Y       int          否           最后一个成员
 step                每次迭代间隔数                                                  Y       int           否           1
---------------------------------------------------------------------------------------------------------------------
限制:
.假若有begin属性时,begin必须大于等于0
.假若有end属性时,必须大于begin
.假若有step属性时,step必须大于等于1

Null 和 错误处理
.假如itmes为null时,则表示为有空的集合对象
.假若begin大于等于items的大小时,则迭代不运算

例子:
<c:forToken items="A,B,C,D,E,F,G" delims="," var="item>
${item}
</c:forToken>
items属性也可以用EL,例如:
<%
 String phonenumber="123-456-7899";
 request.setAttribute("userPhone",phonenumber);
%>
<c:forTokens items="${userPhone}" delims="-" var="item">
${item}
</c:forTokens>

URL操作
JSTL包含三个URL操作有关的标签,分别是: <c:import>,<c:redirect>和<c:url>。它们的主要功能是:
用来将其他文件的内容包含起来,网页的向导,还有url的产生。


只有注册用户登录后才能发表评论。


网站导航: