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具体做什么，但有两点需要注意：

1.  一个value stack本质上是一个List；
2. 在栈中调用[n]将返回一个从位置n开始的子栈；

对于2举个例子说明。假定Value Stack包含了[model,action,others]，那么

1. [0] --- 返回 [model,action,others]；
2. [1] --- 返回 [action,others]；
3. [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对象外所有的栈元素。