struts2 标签详解

• 博客分类： 
• ssh框架

struts2 标签 java jsp 

要使用Struts2的标签,只需要在JSP页面添加如下一行定义即可： 

Java代码  

1. <%@ taglib prefix="s" uri="/struts-tags"%>  

struts2的标签共分为五大类： 

一、逻辑控制标签 

用于进行逻辑控制输出。主要分以下几类： 

1）条件标签：用于执行基本的条件流转 

<s:if>：拥有一个test属性,其表达式的值用来决定标签里内容是否显示。

Java代码  

1. <s:if test="#request.username=='hzd'">欢迎hzd</s:if>  
2.   
3. <s:elseif>：同上。  
4.   
5. <s:else>  

2）迭代标签：用于遍历集合(java.util.Collection)或者枚举值(java.util.Iterator)类型的对象,value属性表示集合或枚举对象,status属性表示当前循环的对象,在循环体内部可以引用该对象的属性 

Java代码  

1. <s:iterator value="userList" status="user">  
2.   
3. 姓名：<s:property value="user.userName" />  
4.   
5. 年龄：<s:property value="user.age" />  
6.   
7. </s:iterator>  

3）组合标签：用于将多个枚举值对象进行叠加，形成一个新的枚举值列表 

如将3个列表对象进行了组合，形成新的列表对象： 

Java代码  

1. <s:append var="newIteratorList">  
2.   
3. <s:param value="%{myList1}" />  
4.   
5. <s:param value="%{myList2}" />  
6.   
7. <s:param value="%{myList3}" />  
8.   
9. </s:append>  
10.   
11. 输出：  
12.   
13. <s:iterator value="%{#newIteratorList}">  
14.   
15. <s:property />  
16.   
17. </s:iterator>  

4）分割标签：用于将一个字符串进行分隔，产生一个枚举值列表 

下面的代码将分隔为3个字符串，然后循环输出 

Java代码  

1. <s:generator val="%{'aaa,bbb,ccc'}">  
2.   
3. <s:iterator>  
4.   
5. <s:property />  
6.   
7. </s:iterator>  
8.   
9. </s:generator>  

5）合并标签：用于将多个枚举值按照数组的索引位置进行合并 

Java代码  

1. <s:merge var="newMergeList">  
2.   
3. <s:param value="%{mylist1}">--设mylist1列表中有a,b,c三个元素  
4.   
5. <s:param value="%{mylist2}">--设mylist2列表中有1,2,3三个元素  
6.   
7. </s:merge>  
8.   
9. 合并后新的列表的元素及其顺序为：a,1,b,2,c,3  
10.   
11. <s:iterator value="%{#newMergeList}">  
12.   
13. <s:property />  
14.   
15. </s:iterator>  

6）排序标签：用于对一组枚举值进行排序，属性comparator指向一个继承自java.util.Comparator的比较器，该比较器可以是对应Action页面中的一个比较器变量,source指定要排序的列表对象 

Java代码  

1. <s:sort comparator="myComparator" source="myList">  
2.   
3. <s:iterator>  
4.   
5. <s:property value="..."/>  
6.   
7. </s:iterator>  
8.   
9. </s:sort>  

7）子集标签：用于取得一个枚举列表的子集，source用于指定检索的列表对象，start用于指定起始检索的索引位置，count用于指定检索的结果数量，decider属性必须是一个org.apache.struts2.util.SubsetIteratorFilter.Decider类的子类实例，用以指定检索的条件。例如在Action中提供了以下方法用来取得一个Decider对象： 

Java代码  

1. public Decider getDecider()  
2.   
3. {  
4.   
5. return new Decider(){  
6.   
7. public boolean decide(Object element) throws Exception{  
8.   
9. int i=((Integer)element).intValue();  
10.   
11. return (((i%2)==0)?true:false);  
12.   
13. }  
14.   
15. };  
16.   
17. }  

然后引用该对象筛选子集： 

Java代码  

1. <s:subset source="myList" decider="decider">  
2.   
3. </s:subset>  

或者不使用Decider对象： 

Java代码  

1. <s:subset source="myList" count="13" start="3">  
2.   
3. </s:subset>  

二、数据输出标签 

数据输出标签用以输出页面中的元素、属性、隐含变量等，即包括静态文本的输出，也包括struts2集成的各种变量的输出。 

1）链接标签：用于创建一个<a>标签,errorText用于显示错误信息，priInvokeJS表示该链接执行时的javascript提示函数,href表示跳转地址. 

Java代码  

1. <s:a errorText="删除错误" preInvokeJS="confirm('确认删除?')" href="test.jsp">  
2.   
3. [img]/image/delete.gif[/img]  
4.   
5. </s:a>  

2）Action标签：可以直接调用Action类中的函数,前提是该Action类在struts.xml中有定义,name属性用于指向映射文件中配置的Action函数,executeResult属性表示是否执行结果集的跳转 

Java代码  

1. <s:action name="LoginAction" executeResult="true" />--表示执行LoginAction的默认处理方法execute()  
2.   
3. <s:action name="LoginAction!login" executeResult="true" />--表示执行LoginAction的处理方法login()  

3）JavaBean标签：用于创建一个JavaBean对象，name表示JavaBean类全名，var表示变量的实例名，并可以包含<s:param>设置实例化输入参数 

Java代码  

1. <s:bean name="xxx,xxx,xxx" var="xxx">  
2.   
3. <s:param name="name" value="hzd" />--为该JavaBean的构造方法传递参数  
4.   
5. </s:bean>  

4）日期标签：用以输出一个格式化的日期对象，name表示要输出的对象，format表示输出的日期格式 

Java代码  

1. <s:date name="user.birthday" format="dd/MM/yyyy" />  
2.   
3. <s:date name="user.birthday" format="%{getText('some.i18n.key')}" />  
4.   
5. <s:date name="user.birthday" />--默认格式  

5）调用标签：用以输出页面的值栈调试信息，通常在进行程序调用时使用，便于查找JSP页面中的错误 

6）引用资源文件标签：用于加载资源包到值栈,它可以允许<s:text>标签访问任何资源包的信息，而不只是当前action相关联的资源包。name属性用以指定资源包的类路径 

如xxx.xxx.xxx.ApplicationMessages中定义了标签：HelloWord=欢迎您！ 

则可以这样引用： 

Java代码  

1. <s:i18n name="xxx.xxx.xxx.ApplilcationMessages">  
2.   
3. <s:text name="HelloWord" />  
4.   
5. </s:i18n>  

7）包含页面标签：用来包含一个Servlet的输出(Servlet或JSP页面)，使用value属性指定包含页名称,可以使用<s:param>传递参数给子页 

Java代码  

1. <s:include value="/test.jsp">  
2.   
3. <s:param name="username">hzd</s:param>--参数username=hzd给test.jsp页面  
4.   
5. </s:include>  

8）传递参数标签：用来为其他标签提供参数,所以一般是嵌套在其它标签的内部，name属性用来指定参数名称，value(可选)属性用来指定参数值 

Java代码  

1. <s:param name="username" value="hzd" />--这种方式的参数值会以String格式放入stack  
2.   
3. <s:param name="username">hzd</s:param>--这种方式的参数值会以Object的格式放入stack  

9）值栈标签：用以加入一个值到值栈中 

Java代码  

1. <s:push value="user">  
2.   
3. <s:property value="name" />--为user指定name属性  
4.   
5. <s:property value="age" />--为user指定age属性  
6.   
7. </s:push>  

10）变量赋值标签：赋予变量一个特定范围内的值，name属性表示变量的名字，scope表示变量的作用域(application.session.request.page.action)，value变量的值 

<s:set> 

11）国际化标签：用于输出国际化信息,name属性指定国际化资源文件中消息文本的key,可以与<s:i18n>标签结合使用 

<s:text name="HelloWord" />--它会按照一定的顺序查找资源文件,直到找到定义HellowWord标签的资源文件为止 

12）链接标签：用于创建一个URL链接，并可以通过<s:param>标签提供request参数 

Java代码  

1. <s:url id="url" value="/test.jsp">  
2.   
3. <s:param name="username">hzd</s:param>  
4.   
5. </s:url>  

13）属性标签：用以输出value属性的值，并拥有一个default属性,在value对象不存在时显示。escape属性为true,来输出原始的HTML文本 

Java代码  

1. <s:property value="getText('some.key')">  

三、HTML表单标签 

HTML标签都拥有以下3个设置样式的属性。 

templateDir：执行模板路径 

theme：指定主题名称，可选值包括simple、xhtml、ajax等 

template：指定模板名称 

使用HTML表单标签会生成大量格式化的HTML代码，这些代码是由struts2的模板生成的，这样的好处是可以让我们的jsp代码十分简单，只需要配置使用不同的主题模板，就可以显示不同的页面样式。 

struts2默认提供了5种主题(在此不做详细介绍)： 

simple主题：最简单的主题 

XHTML主题：默认主题，使用常用的HTML技巧 

CSS XHTML主题：使用CSS实现的XHTML主题 

archive主题：使用文档生成主题 

AJAX主题：基于AJAX实现的主题 

通过在struts.properties文件中改变struts.ui.theme,struts.ui.templateDir,struts.ui.templateSuffix三个标签来自由切实可行换主题 

由于HTML表单标签也不少,所以还是要用的时候在网上找吧... 

四、HTML非表单标签 

主要用来输出各种错误和消息。 

1）错误标签：用以输出Action错误信息 

<s:actionerror /> 

2）消息标签：用以输出Action普通消息 

<s:atcionmessage /> 

3）字段错误标签：用以输出Action校验中某一个字段的错误信息或所有字段的错误信息 

Java代码  

1. <s:fielderror />--输出所有字段的错误信息  
2.   
3. <s:fielderror>  
4.   
5. <s:param>username</s:param>--输出字段username的错误信息  
6.   
7. <s:param>password</s:param>--输出字段password的错误信息  
8.   
9. <s:fielderror>  

4）DIV标签：用以输出一个<div>标签 



五、AJAX标签 

AJAX标签是struts2专门提供的一组进行AJAX操作的标签，在使用这些标签之前，需要在JSP页面中添加如下引用： 

Java代码  

1. <%@ taglib prefix="sx" uri="/struts-dojo-tags"%>  

1）链接标签：用于创建一个<a>链接，并且在单击该链接时执行异步的请求,该标签的url属性必须使用<s:url/>标签进行设置,target属性指向要被更新的页面组件,showLoadingText属性决定是否显示文本,indicator表示异步请求时要显示的图片 

使用form标签： 

Java代码  

1. <s:div id="targetDiv">  
2.   
3. <s:form action="LoginAction">  
4.   
5. <sx:a targets="targetDiv" showLoadingText="false" indicator="loadingImage" />  
6.   
7. </s:form>  
8.   
9. </s:div>  

使用url标签： 

Java代码  

1. <s:div id="targetDiv">  
2.   
3. <s:url id="ajaxTest" value="/LoginAction.action">  
4.   
5. <sx:a targets="targetDiv" href="%{ajaxTest}" showLoadingText="false" indicator="loadingImage" />  
6.   
7. </s:div>  

2）自动完成标签：是一个组合框组件,在文本框中输入文本，能够给出一个下拉的提示列表。list属性用以指定一个自动提示检索的列表集合(可以是Action中的List类型的属性)，autoComplete属性为true时表示进行自动提示 

Java代码  

1. <sx:autocompleter name="test" list="{'上海','湖南',广东}" autoCompleter="true" />  

3）自动事件绑定标签：该标签可以为多个对象的多个事件进行监听，并能够发送异步请求。src属性指定监听的对象源，events属性指定监听的事件类型(JavaScript事件),target属性指定异步返回内容填充的目标，indicator属性表示执行异步请求时显示的图片 

Java代码  

1. <s:div id="targetDiv">  
2.   
3. <s:form action="login">  
4.   
5. <s:submit id="bin" />  
6.   
7. <s:bind src="bin" events="onclick" targets="targetDiv" showLoadingText="false" indicator="%{getText('loadingImage')}" />  
8.   
9. </s:form>  
10.   
11. </s:div>  

4）日期选择标签：用以弹出一个日期和时间的选择窗口，displayFormat属性指定要选择日期的格式,name表示当前组件的属性的对象,value表示默认值,label表示显示的文本 

Java代码  

1. <sx:datetimepicker name="order.date" label="Order Date" displayFormat="yyyy-MM-dd" value="%{'2006-01-01'}" />  

5）树标签：用以输出一个树形结构 

<sx:tree> 

6）Tab页标签：使用AJAX的方式显示多个Tab页 

<s:tabbedpanel>