Struts2常用标签总结
一 介绍
1．Struts2的作用
Struts2标签库提供了主题、模板支持，极大地简化了视图页面的编写，而且，struts2的主题、模板都提供了很好的扩展性。实现了更好的代码复用。Struts2允许在页面中使用自定义组件，这完全能满足项目中页面显示复杂，多变的需求。
Struts2的标签库有一个巨大的改进之处，struts2标签库的标签不依赖于任何表现层技术，也就是说strtus2提供了大部分标签，可以在各种表现技术中使用。包括最常用的jsp页面，也可以说Velocity和FreeMarker等模板技术中的使用
2．Struts2分类
（1）UI标签：（User Interface, 用户界面）标签，主要用于生成HTML元素标签，UI标签又可分为表单标签非表单标签
（2）非UI标签，主要用于数据访问，逻辑控制等的标签。非UI标签可分为流程控制标签（包括用于实现分支、循环等流程控制的标签）和数据访问标签（主要包括用户输出ValueStack中的值，完成国际化等功能的）
（3）ajax标签
3．Struts2标签使用前的准备：
（1）在要使用标签的jsp页面引入标签库：
<%@ taglib uri="/struts-tags" prefix="s"%>
（2）在web.xml中声明要使用的标签 这样是struts2 2.3.1.2版本的引入方式
<filter>
<filter-name>struts2</filter-name>
<filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
</filter>
4．标签的使用
（1）property标签
用于输出指定的值：
<s:property value="%{@cn.csdn.hr.domain.User@Name}"/><br/>
<s:property value="@cn.csdn.hr.domain.User@Name"/><Br/><!-- 以上两种方法都可以 -->
<s:property value="%{@cn.csdn.hr.domain.User@study()}"/>
以上可以访问某一个包的类的属性的集中方式，study()是访问方法的方法，并输出。
以下用java代码代替的，访问某一个范围内的属性
<%
//采用pageContext对象往page范围内存入值来 验证#attr搜索顺序是从page开始的 ，搜索的顺序为：page，reques，session，application。
set存值的时候存到的是request中，在jsp页面中访问的时候不用加任何的标识符，即可直接访问，如果不同的作用域不一样了，
pageContext.setAttribute("name", "laoowang", PageContext.PAGE_SCOPE);
%>
<s:property value="#attr.name" />
假设在action中设置了不同作用域的类
不同的作用域的标签的访问:
<h3>获取的是requet中的对象值</h3>
第一种方式:<s:property value="#request.user1.realName"/>
<br/>
第二种方式:<s:property value="#request.user1['realName']"/>
<br/>
第三种方式:<s:property value="#user1.realName"/>
<br/>
第四种方式:<s:property value="#user1['realName']"/>
<br/>
第五种方式：${requestScope.user1.realName } || ${requestScope.user1['realName'] }
第六种：<s:property value="#attr.user1.realName"/>
attr对象按page==> request sessionapplictio找的
<h3>获取session中的值</h3>
第一种方式:<s:property value="#session.user1.realName"/>
<br/>
第二种方式:<s:property value="#session.user1['realName']"/>
第五种方式：${sessionScope.user1.realName } || ${sessionScope.user1['realName'] }
<h3>获取application中的对象的值</h3>
第一种方式:<s:property value="#application.user1.realName"/>
<br/>
第二种方式:<s:property value="#application.user1['realName']"/>
第五种方式：${applicationScope.user1.realName } || ${applicationScope.user1['realName'] }
（2）iterator标签的使用
第一种：list集合
<!-- 设置set集合 value-->
<!-- status 可选属性，该属性指定迭代时的IteratorStatus实例 -->
<!-- value="#attr.list" list存放到了request中 可以value="#request.list"
statu.odd返回当前被迭代元素的索引是否是奇数
-->
<s:set name="list" value="{'a','b','c','d'}"></s:set>
<s:iterator var="ent" value="#request.list" status="statu">
<s:if test="%{#statu.odd}">
<font color="red"><s:property value="#ent" />
</font>
</s:if>
<s:else>
<s:property value="#ent" />
</s:else>
</s:iterator>
第二种：map集合中的使用
<h3>Map集合</h3>
<!-- map集合的特点：
语法格式：# {key:value,key1:value1,key2:value2,.....}
以上的语法中就直接生成了一个Map类型的集合,该Map对象中的每个key-value对象之间用英文的冒号隔开
，多个元素之间用逗号分隔。
-->
</div>
<s:set var="map" value="#{'1':'laowang','2':'老王','3':'猩猩'}"></s:set>
遍历Map：
<br />
<s:iterator value="#map">
<s:property value="key" />:::<s:property value="value" />
<Br />
</s:iterator>
第三种：集合的变量
<h3>遍历集合:::</h3>
<div>
<!-- 遍历出价格大于3000的 -->
<s:iterator var="user" value="#session['users']">
<s:if test="%{#user['price']>3000}">
<s:property value="#user['price']"/>
</s:if>
</s:iterator>
<hr color="blue"/><!-- $是取出价格 大于3000的最后一个值 -->
<s:iterator var="u" value="#session.users.{$(#this['price']>3000)}">
<s:property value="price"/>
</s:iterator>
</div>
注：users是User的对象，price是User中的一个属性
简述一下iterator的介绍：
iterator标签用于对集合进行迭代，这里的集合包含List、Set和数组。
<s:set name="list" value="{'zhangming','xiaoi','liming'}" />
<s:iterator value="#list" status="st">
<font color=<s:if test="#st.odd">red</s:if><s:else>blue</s:else>>
<s:property /></font><br>
</s:iterator>
value：可选属性，指定被迭代的集合，如果没有设置该属性，则使用ValueStack栈顶的集合。
id：可选属性，指定集合里元素的id。
status：可选属性，该属性指定迭代时的IteratorStatus实例。该实例包含如下几个方法：
int getCount()，返回当前迭代了几个元素。
int getIndex()，返回当前迭代元素的索引。
boolean isEven()，返回当前被迭代元素的索引是否是偶数
boolean isOdd()，返回当前被迭代元素的索引是否是奇数
boolean isFirst()，返回当前被迭代元素是否是第一个元素。
boolean isLast()，返回当前被迭代元素是否是最后一个元素。
（3）if else语句的使用
<s:set name="age" value="21" />
<s:if test="#age==23">
23
</s:if>
<s:elseif test="#age==21">
21
</s:elseif>
<s:else>
都不等
</s:else>
（4）URL标签
<!-- 声明一个URL地址 -->
<s:url action="test" namespace="/tag" var="add">
<s:param name="username">laowangang</s:param>
<s:param name="id">12</s:param>
</s:url>
<s:a href="%{add}">测试URL</s:a>
<s:a action="test" namespace="/tag"></s:a>
以上的两个<s:a>标签的作用是一样的。
（5）data标签
<%
pageContext.setAttribute("birth",new Date(200,03,10),PageContext.REQUEST_SCOPE);
%>
<s:date name="#request.birth" format="yyyy年MM月dd日"/>
<s:date name="#request.birth" nice="true"/>
这个标签是按照format的格式去输出的。
（6）表单
<h1>from表单</h1>
<s:form action="test" namespace="/tag">
<s:textfield label="用户名" name="uname" tooltip="你的名字" javascriptTooltip="false"></s:textfield>
<s:textarea name="rmake" cols="40" rows="20" tooltipDelay="300" tooltip="hi" label="备注" javascriptTooltip="true"></s:textarea>
<s:password label="密码" name="upass"></s:password>
<s:file name="file" label="上传文件"></s:file>
<s:hidden name="id" value="1"></s:hidden>
<!--
<select name="edu">
<option value="listKey">listValue</option>
-->
<s:select list="#{'1':'博士','2':'硕士'}" name="edu" label="学历" listKey="key" listValue="value"></s:select>
<s:select list="{'java','.net'}" value="java"></s:select><!-- value是选中的 -->
<!-- 必须有name -->
<s:checkbox label="爱好 " fieldValue="true" name="checkboxFiled1"></s:checkbox>
<!-- 多个checkbox -->
<s:checkboxlist list="{'java','css','html','struts2'}" label="喜欢的编程语言" name="box" value="{'css','struts2'}"></s:checkboxlist>
<!-- map集合前要加# -->
<s:checkboxlist list="#{1:'java',2:'css',3:'html',4:'struts2',5:'spring'}" label="喜欢的编程语言" name="boxs" value="{1,2}"></s:checkboxlist>
<!-- listKey
listValue
<input type="text" name="boxs" value="listKey">显示值listValue
-->
<!-- radio -->
<%
//从服务器传过来值
pageContext.setAttribute("sex","男",PageContext.REQUEST_SCOPE);
pageContext.setAttribute("sex1","男",PageContext.REQUEST_SCOPE);
%>
<s:radio list="{'男','女'}" name="sex" value="#request.sex"></s:radio>
<s:radio list="#{1:'男',2:'女'}" name="sex1" listKey="key" listValue="value" value="#request.sex1"></s:radio>
<!-- 防止表单提交的方式 -->
<s:token></s:token>
<s:submit value="提交"></s:submit>
</s:form>
在说明s:iterator标签的使用前，先了解下struts2中的Value Stack。这里参考了webwork中对Value Stack的描述，由于struts2是在webwork的基础上进行升级的，因此webwork对于Value Stack的表述同样适用于struts2。在这里不描述Value Stack具体做什么，但有两点需要注意：
- 一个value stack本质上是一个List；
- 在栈中调用[n]将返回一个从位置n开始的子栈；
对于2举个例子说明。假定Value Stack包含了[model,action,others]，那么
- [0] --- 返回 [model,action,others]；
- [1] --- 返回 [action,others]；
- [2] --- 返回 [others];
现在将开始介绍s:iterator的一些使用。以下代码片段均在开发环境eclipse3.4 wtp、tomcat5.5、jdk5上使用struts2.1.6测试通过。
1)、访问 days
defined List<String> days ["Monday","Thursday","Friday","Sunday"]
- <s:iterator value="days"><s:property /></s:iterator>
2)、使用top 关键字使用(过滤掉Monday)
defined List<String> days ["Monday","Thursday","Friday","Sunday"]
- <s:iterator value="days">
- <s:if test="top!='Monday'">
- <s:property />
- </s:if>
- </s:iterator>
- top 指代当前迭代元素，可以为对象；
- 这里的top可用[0].top替代，但不能使用[0]。[0]代表整个栈对象。如果单纯调用[0]将会调用其toString()方法输出对象信息；
3)、使用 last / first 关键字
defined String[][] aTs = { { "一", "二", "三", "四" },{ "一一", "二二", "三三", "四四"} };
- <!--遍历二维数组，The trick here is to use 'top' as the value for the inner iterator-->
- <s:iterator value="aTs" status="of">
- <s:if test="#of.last"><br/></s:if>
- <s:iterator value="top">
- <!--亦可用[0].top替代。如果单纯用[0],则会同时打印该处栈对象信息-->
- <s:property />
- </s:iterator>
- </s:iterator>
- iterator 标签中的status属性代表当前迭代的位置；
- #of.last用于判断当前迭代到的元素是否为最后一个元素；
- last返回一个boolean类型;
- first返回一个boolean类型;
4)、使用 odd / even 关键字
下面的例子要实现每行输出颜色不同的效果。
defined List<String> days ["Monday","Thursday","Friday","Sunday"]
- <!--奇数行显示为红色,偶数行显示为绿色-->
- <s:iterator value="days" status="offset">
- <s:else>
- <s:if test="#offset.odd==true">
- <li style="color: red" mce_style="color: red"><s:property /></li>
- </s:if>
- <s:else>
- <li><s:property /></li>
- </s:else>
- </s:else>
- </s:iterator>
- odd关键字用来判断当前迭代位置是否为奇数行。odd返回boolean类型;
- even关键字用来判断当前迭代位置是否为偶数行。even返回boolean类型
5)、总结下，当声明iterator的status属性时，通过#statusName.method可以使用以下方法:
- even : boolean - 如果当前迭代位置是偶数返回true
- odd : boolean - 如果当前迭代位置是奇数返回true
- count : int - 返回当前迭代位置的计数(从1开始)
- index : int - 返回当前迭代位置的编号(从0开始)
- first : boolean - 如果当前迭代位置是第一位时返回true
- last : boolean - 如果当前迭代位置是最后一位时返回true
- modulus(operand : int) : int - 返回当前计数(从1开始)与指定操作数的模数
6)、最后再来看下在iterator中调用value stack的用法。
假定countries是一个List对象，每一个country有一个name属性和一个citys List对象，并且每一个city也有一个name属性。那么我们想要在迭代citys时访问所属country的name属性就的用如下方式：
- <s:iterator value="countries">
- <s:iterator value="cities">
- <s:property value="name"/>, <s:property value="[1].name"/><br>
- </s:iterator>
- </s:iterator>
- 这里的 <ww:property value="name"/>取的是ctiy.name;<ww:property value="[1].name"/>取得是country.name
- <ww:property value="[1].name"/> 等价于 <ww:property value="[1].top.name"/>
- we refer to a specific position on the stack: '[1]'. The top of the stack, position 0, contains the current city, pushed on by the inner iterator; position 1 contains the current country, pushed there by the outer iterator.(city处于当前栈，即top或者[0],而[1]指明了外层iterator对象，即country)
- '[n]'标记引用开始位置为n的子栈（sub-stack），而不仅仅是位置n处的对象。因此'[0]'代表整个栈，而'[1]'是除top对象外所有的栈元素。