常用的Struts 2.0的标志（Tag）介绍

 伦理片 http://www.dotdy.com/

在介绍常用标志前，我想先从总体上，对Struts 1.x与Struts 2.0的标志库（Tag Library）作比较。

 Struts 1.xStruts 2.0分类将标志库按功能分成HTML、Tiles、Logic和Bean等几部分严格上来说，没有分类，所有标志都在URI为“/struts-tags”命名空间下，不过，我们可以从功能上将其分为两大类：非UI标志和UI标志表达式语言（expression languages）不支持嵌入语言（EL）OGNL、JSTL、Groovy和Velcity

以上表格，纯属个人总结，如有所不足或错误，请不吝指正

好了，我要开始介绍“常用”（这里所谓的“常用”，是指在已往工作中使用Struts里经常用到的）的标志了。

 

 要在JSP中使用Struts 2.0标志，先要指明标志的引入。通过在JSP的代码的顶部加入以下代码可以做到这点。
<%@ taglib prefix = "s" uri = "/struts-tags" %>

1. 非UI标志
   • if、elseif和else

     描述：
     执行基本的条件流转。

     参数：

     名称必需默认类型描述备注test是Boolean决定标志里内容是否显示的表达式else标志没有这个参数id否Object/String用来标识元素的id。在UI和表单中为HTML的id属性

     例子：

     <% @ page contentType = " text/html; charset=UTF-8 "   %> 
     <% @ taglib prefix = " s "  uri = " /struts-tags "   %> 
     <! DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" > 
     < html > 
          < head > 
              < title > Condition Flow </ title > 
          </ head > 
          < body > 
              < h3 > Condition Flow </ h3 >             
              <!-- 
                 这里有点小技巧：
                 本来可以用#parameters.name[0]来获得，请求中name的值。但是，在我实现include例子时，
                 无论我用param标志给name赋任何值，#parameters里面不会含有任何值，所以#parameters.name也为空值。
                 
                 其原因为：
                 当使用include标志时，被包含的页面（included）里#parameters拿到的是包含页面里的请求参数。
                 
                 因此，这里必须手工调用request.getParameter("name")。
              --> 
              < s:set  name ="name"  value ="<%= " '" + request.getParameter("name") + "'" % > " />
              < s:if  test ="#name == 'Max'" > 
                 Max's file here
              </ s:if > 
              < s:elseif  test ="#name == 'Scott'" > 
                 Scott's file here
              </ s:elseif > 
              < s:else > 
                 Other's file here
              </ s:else >         
          </ body > 
     </ html >

     例1 condition.jsp
   • iterator

     描述：
     用于遍历集合（java.util.Collection）或枚举值（java.util.Iterator）。

     参数：

     名称必需默认类型描述status否String如果设置此参数，一个IteratorStatus的实例将会压入每个遍历的堆栈value否Object/String要遍历的可枚举的（iteratable）数据源，或者将放入新列表（List）的对象id否Object/String用来标识元素的id。在UI和表单中为HTML的id属性

     例子：

     <% @ page contentType = " text/html; charset=UTF-8 "   %> 
     <% @ page import = " java.util.List "   %> 
     <% @ page import = " java.util.ArrayList "   %> 
     <% @ taglib prefix = " s "  uri = " /struts-tags "   %> 
     
     <! DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" > 
     <% 
         List list  =   new  ArrayList();
         list.add( " Max " );
         list.add( " Scott " );
         list.add( " Jeffry " );
         list.add( " Joe " );
         list.add( " Kelvin " );
         request.setAttribute( " names " , list);
     %> 
     < html > 
          < head > 
              < title > Iterator </ title > 
          </ head > 
          < body > 
              < h3 > Names:  </ h3 > 
              <!--  
                 1、此处的空property元素用于获得当前iterator的值 
                 2、 status被设成stuts，在iterator的里面就可以通过#stuts取得IteratorStatus的对象。IteratorStatus 类包含当前序号信息，如是否第一个或最后一个，是否为奇数序号。这些信息在我们做格式化的时候，显得非常有用。
              --> 
              < ol > 
                  < s:iterator  value ="#request.names"  status ="stuts" >                 
                      < s:if  test ="#stuts.odd == true" > 
                          < li > White  < s:property  /></ li > 
                      </ s:if > 
                      < s:else > 
                          < li  style ="background-color:gray" >< s:property  /></ li > 
                      </ s:else > 
                  </ s:iterator > 
              </ ol > 
          </ body > 
     </ html >

     例2 iterator.jsp
   • i18n

     描述：
     加载资源包到值堆栈。它可以允许text标志访问任何资源包的信息，而不只当前action相关联的资源包。

     参数：

     名称必需默认类型描述value是Object/String资源包的类路径（如com.xxxx.resources.AppMsg）id否Object/String用来标识元素的id。在UI和表单中为HTML的id属性

     例子：

     HelloWorld = Hello Wrold!

     例3 classes\ ApplicationMessages.properties 
     
     

     <% @ page contentType = " text/html; charset=UTF-8 "   %> 
     <% @ taglib prefix = " s "  uri = " /struts-tags "   %> 
     
     <! DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" > 
     < html > 
          < head > 
              < title > Internationization </ title > 
          </ head > 
          < body > 
              < h3 > 
                  < s:i18n  name ="ApplicationMessages" > 
                      < s:text  name ="HelloWorld"   /> 
                  </ s:i18n > 
              </ h3 > 
          </ body > 
     </ html >

     例3 i18n.jsp
   • include

     描述：
     包含一个servlet的输出（servlet或jsp的页面）。

     参数：

     名称必需默认类型描述value是String要包含的jsp或servletid否Object/String用来标识元素的id。在UI和表单中为HTML的id属性

     例子：

     <% @ page contentType = " text/html; charset=UTF-8 "   %> 
     <% @ taglib prefix = " s "  uri = " /struts-tags "   %> 
     
     <! DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" > 
     < html > 
          < head > 
              < title > Iterator </ title > 
          </ head > 
          < body > 
              < h3 > Interator Page </ h3 > 
              < s:include  value ="/condition.jsp" > 
                  < s:param  name ="name" > Max </ s:param > 
              </ s:include > 
              < h3 > i18n </ h3 > 
              < s:include  value ="/i18n.jsp"   /> 
          </ body > 
     </ html >

     例4 include.jsp
   • param

     描述：
     为其他标签提供参数,比如include标签和bean标 签. 参数的name属性是可选的,如果提供，会调用Component的方法addParameter(String, Object), 如果不提供，则外层嵌套标签必须实现UnnamedParametric接口(如TextTag)。

      value的提供有两种方式,通过value属性或者标签中间的text,不同之处我们看一下例子:
     

     < param name = "color" > blue </ param > <!-- (A) -->

     < param name = "color" value = "blue" /> <!-- (B) --> 
     (A)参数值会以String的格式放入statck. 
     (B)该值会以java.lang.Object的格式放入statck.

     参数：

     名称必需默认类型描述name否String参数名value否Stringvalue表达式id否Object/String用来标识元素的id。在UI和表单中为HTML的id属性

     例子：
     请参考例4。

   • set

     描述：
     set标签赋予变量一个特定范围内的值。当希望给一个变量赋一个复杂的表达式,每次访问该变量而不是复杂的表达式时用到。其在两种情况下非常有用: 复杂的表达式很耗时 (性能提升) 或者很难理解 (代码可读性提高)。

     参数：

     名称必需默认类型描述name是String变量名字scope否String变量作用域,可以为application, session, request, page, 或action.value否Object/String将会赋给变量的值id否Object/String用来标识元素的id。在UI和表单中为HTML的id属性

     例子：
     请参考例1。

   • text

     描述：
     支持国际化信息的标签。国际化信息必须放在一个和当前 action同名的resource bundle中,如果没有找到相应message,tag body将被当作默认message,如果没有tag body,message的name会被作为默认message。

     参数：

     名称必需默认类型描述name是String资源属性的名字id否Object/String用来标识元素的id。在UI和表单中为HTML的id属性

     例子：
     请参考例3。

   • url

     描述：
     该标签用于创建url,可以通过"param"标签提供request参数。

      当includeParams的值时'all'或者'get', param标签中定义的参数将有优先权,也就是说其会覆盖其他同名参数的值。

     参数： 略

     例子：

     <% @ page contentType = " text/html; charset=UTF-8 "   %> 
     <% @ taglib prefix = " s "  uri = " /struts-tags "   %> 
     <! DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" > 
     < html > 
          < head > 
              < title > URL </ title > 
          </ head > 
          < body > 
              < h3 > URL </ h3 >             
              < a  href ='<s:url  value ="/i18n.jsp"   /> '>i18n </ a >< br  /> 
              < s:url  id ="url"  value ="/condition.jsp" > 
                  < s:param  name ="name" > Max </ s:param > 
              </ s:url >         
              < s:a  href ="%{url}" > if\elseif\else </ s:a > 
          </ body > 
     </ html >

     例5 url.jsp
   • property

     描述：
     得到'value'的属性,如果value没提供,默认为堆栈顶端的元素。

     参数：

     名称必需默认类型描述default否String如果属性是null则显示的default值escape否trueBooelean是否escape HTMLvalue否栈顶Object要显示的值id否Object/String用来标识元素的id。在UI和表单中为HTML的id属性

     例子：
     请参考例2。