Struts2常用标签总结

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开始的子栈；

对于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"]

[xhtml] view plaincopy

<s:iterator value="days"><s:property /></s:iterator>

2)、使用top 关键字使用(过滤掉Monday)

defined List<String> days ["Monday","Thursday","Friday","Sunday"]

[xhtml] view plaincopy

<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 = { { "一", "二", "三", "四" },{ "一一", "二二", "三三", "四四"} };

[b][xhtml] view plaincopy[/b]

<!--遍历二维数组，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"]

[xhtml] view plaincopy

<!--奇数行显示为红色,偶数行显示为绿色-->

<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属性就的用如下方式：

[xhtml] view plaincopy

<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的子栈（sub-stack），而不仅仅是位置n处的对象。因此'[0]'代表整个栈，而'[1]'是除top对象外所有的栈元素。