要使用Struts2的标签,仅仅须要在JSP页面加入例如以下一行定义就可以:
<%@ taglib prefix="s" uri="/struts-tags"%>
struts2的标签共分为五大类:
一、逻辑控制标签
用于进行逻辑控制输出。
主要分下面几类:
1)条件标签:用于运行主要的条件流转
<s:if>:拥有一个test属性,其表达式的值用来决定标签里内容是否显示。<s:if test="#request.username=='hzd'">欢迎hzd</s:if>
<s:elseif>:同上。
<s:else>
2)迭代标签:用于遍历集合(java.util.Collection)或者枚举值(java.util.Iterator)类型的对象,value属性表示集合或枚举对象,status属性表示当前循环的对象,在循环体内部能够引用该对象的属性
<s:iterator value="userList" status="user">
姓名:<s:property value="user.userName" />
年龄:<s:property value="user.age" />
</s:iterator>
3)组合标签:用于将多个枚举值对象进行叠加,形成一个新的枚举值列表
如将3个列表对象进行了组合,形成新的列表对象:
<s:append var="newIteratorList">
<s:param value="%{myList1}" />
<s:param value="%{myList2}" />
<s:param value="%{myList3}" />
</s:append>
输出:
<s:iterator value="%{#newIteratorList}">
<s:property />
</s:iterator>
4)切割标签:用于将一个字符串进行分隔,产生一个枚举值列表
下面的代码将分隔为3个字符串,然后循环输出
<s:generator val="%{'aaa,bbb,ccc'}">
<s:iterator>
<s:property />
</s:iterator>
</s:generator>
5)合并标签:用于将多个枚举值依照数组的索引位置进行合并
<s:merge var="newMergeList">
<s:param value="%{mylist1}">--设mylist1列表中有a,b,c三个元素
<s:param value="%{mylist2}">--设mylist2列表中有1,2,3三个元素
</s:merge>
合并后新的列表的元素及其顺序为:a,1,b,2,c,3
<s:iterator value="%{#newMergeList}">
<s:property />
</s:iterator>
6)排序标签:用于对一组枚举值进行排序,属性comparator指向一个继承自java.util.Comparator的比較器,该比較器能够是相应Action页面中的一个比較器变量,source指定要排序的列表对象
<s:sort comparator="myComparator" source="myList">
<s:iterator>
<s:property value="..."/>
</s:iterator>
</s:sort>
7)子集标签:用于取得一个枚举列表的子集。source用于指定检索的列表对象,start用于指定起始检索的索引位置。count用于指定检索的结果数量,decider属性必须是一个org.apache.struts2.util.SubsetIteratorFilter.Decider类的子类实例,用以指定检索的条件。比如在Action中提供了下面方法用来取得一个Decider对象:
public Decider getDecider()
{
return new Decider(){
public boolean decide(Object element) throws Exception{
int i=((Integer)element).intValue();
return (((i%2)==0)?true:false);
}
};
}
然后引用该对象筛选子集:
<s:subset source="myList" decider="decider">
</s:subset>
或者不使用Decider对象:
<s:subset source="myList" count="13" start="3">
</s:subset>
二、数据输出标签
数据输出标签用以输出页面中的元素、属性、隐含变量等。即包括静态文本的输出,也包括struts2集成的各种变量的输出。
1)链接标签:用于创建一个<a>标签,errorText用于显示错误信息。priInvokeJS表示该链接运行时的javascript提示函数,href表示跳转地址.
<s:a errorText="删除错误" preInvokeJS="confirm('确认删除?
')" href="test.jsp">
<img src="/image/delete.gif" />
</s:a>
2)Action标签:能够直接调用Action类中的函数,前提是该Action类在struts.xml中有定义,name属性用于指向映射文件里配置的Action函数,executeResult属性表示是否运行结果集的跳转
<s:action name="LoginAction" executeResult="true" />--表示运行LoginAction的默认处理方法execute()
<s:action name="LoginAction!login" executeResult="true" />--表示运行LoginAction的处理方法login()
3)JavaBean标签:用于创建一个JavaBean对象,name表示JavaBean类全名,var表示变量的实例名,并能够包括<s:param>设置实例化输入參数
<s:bean name="xxx,xxx,xxx" var="xxx">
<s:param name="name" value="hzd" />--为该JavaBean的构造方法传递參数
</s:bean>
4)日期标签:用以输出一个格式化的日期对象,name表示要输出的对象,format表示输出的日期格式
<s:date name="user.birthday" format="dd/MM/yyyy" />
<s:date name="user.birthday" format="%{getText('some.i18n.key')}" />
<s:date name="user.birthday" />--默认格式
5)调用标签:用以输出页面的值栈调试信息,通常在进行程序调用时使用,便于查找JSP页面中的错误
6)引用资源文件标签:用于载入资源包到值栈,它能够同意<s:text>标签訪问不论什么资源包的信息。而不仅仅是当前action相关联的资源包。
name属性用以指定资源包的类路径
如xxx.xxx.xxx.ApplicationMessages中定义了标签:HelloWord=欢迎您。
则能够这样引用:
<s:i18n name="xxx.xxx.xxx.ApplilcationMessages">
<s:text name="HelloWord" />
</s:i18n>
7)包括页面标签:用来包括一个Servlet的输出(Servlet或JSP页面),使用value属性指定包括页名称,能够使用<s:param>传递參数给子页
<s:include value="/test.jsp">
<s:param name="username">hzd</s:param>--參数username=hzd给test.jsp页面
</s:include>
8)传递參数标签:用来为其他标签提供參数,所以通常是嵌套在其他标签的内部。name属性用来指定參数名称。value(可选)属性用来指定參数值
<s:param name="username" value="hzd" />--这样的方式的參数值会以String格式放入stack
<s:param name="username">hzd</s:param>--这样的方式的參数值会以Object的格式放入stack
9)值栈标签:用以加入一个值到值栈中
<s:push value="user">
<s:property value="name" />--为user指定name属性
<s:property value="age" />--为user指定age属性
</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參数
<s:url id="url" value="/test.jsp">
<s:param name="username">hzd</s:param>
</s:url>
13)属性标签:用以输出value属性的值。并拥有一个default属性,在value对象不存在时显示。escape属性为true,来输出原始的HTML文本
<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校验中某一个字段的错误信息或全部字段的错误信息
<s:fielderror />--输出全部字段的错误信息
<s:fielderror>
<s:param>username</s:param>--输出字段username的错误信息
<s:param>password</s:param>--输出字段password的错误信息
<s:fielderror>
4)DIV标签:用以输出一个<div>标签
五、AJAX标签
AJAX标签是struts2专门提供的一组进行AJAX操作的标签。在使用这些标签之前,须要在JSP页面中加入例如以下引用:
<%@ taglib prefix="sx" uri="/struts-dojo-tags"%>
1)链接标签:用于创建一个<a>链接,而且在单击该链接时运行异步的请求,该标签的url属性必须使用<s:url/>标签进行设置,target属性指向要被更新的页面组件,showLoadingText属性决定是否显示文本,indicator表示异步请求时要显示的图片
使用form标签:
<s:div id="targetDiv">
<s:form action="LoginAction">
<sx:a targets="targetDiv" showLoadingText="false" indicator="loadingImage" />
</s:form>
</s:div>
使用url标签:
<s:div id="targetDiv">
<s:url id="ajaxTest" value="/LoginAction.action">
<sx:a targets="targetDiv" href="%{ajaxTest}" showLoadingText="false" indicator="loadingImage" />
</s:div>
2)自己主动完毕标签:是一个组合框组件,在文本框中输入文本。能够给出一个下拉的提示列表。list属性用以指定一个自己主动提示检索的列表集合(能够是Action中的List类型的属性)。autoComplete属性为true时表示进行自己主动提示
<sx:autocompleter name="test" list="{'上海','湖南',广东}" autoCompleter="true" />
3)自己主动事件绑定标签:该标签能够为多个对象的多个事件进行监听,并能够发送异步请求。
src属性指定监听的对象源,events属性指定监听的事件类型(JavaScript事件),target属性指定异步返回内容填充的目标,indicator属性表示运行异步请求时显示的图片
<s:div id="targetDiv">
<s:form action="login">
<s:submit id="bin" />
<s:bind src="bin" events="onclick" targets="targetDiv" showLoadingText="false" indicator="%{getText('loadingImage')}" />
</s:form>
</s:div>
4)日期选择标签:用以弹出一个日期和时间的选择窗体。displayFormat属性指定要选择日期的格式,name表示当前组件的属性的对象,value表示默认值,label表示显示的文本
<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>