Struts2标签库常用标签（转）

struts2标签讲解

要使用Struts2的标签,只需要在JSP页面添加如下一行定义即可：<%@ taglib prefix="s" uri="/struts-tags"%>

Struts2的标签共分为五大类：

一、逻辑控制标签

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

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

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

<s:if test="#request.username=='hzd'">北京欢迎你</s:if>
<selseif test="#request.username=='清风'">上海欢迎你</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、分割标签：用于将一个字符串进行分割，产生一个枚举值列表，下面的代码将分割成三个字符串，然后输出

<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函数，excuteResult是否执行结果集的跳转

<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>

Struts2工作原理

Struts2请求响应流程：

（1）  客户端（Client）向Action发用一个请求（Request）

（2）  Container通过web.xml映射请求，并获得控制器（Controller）的名字

（3）  容器（Container）调用控制器（StrutsPrepareAndExecuteFilter或FilterDispatcher）。在Struts2.1以前调用FilterDispatcher，Struts2.1以后调用StrutsPrepareAndExecuteFilter

（4）  控制器（Controller）通过ActionMapper获得Action的信息

（5）  控制器（Controller）调用ActionProxy

（6）  ActionProxy读取struts.xml文件获取action和interceptor stack的信息。

（7）  ActionProxy把request请求传递给ActionInvocation

（8）  ActionInvocation依次调用action和interceptor

（9）  根据action的配置信息，产生result

（10） Result信息返回给ActionInvocation

（11） 产生一个HttpServletResponse响应

（12） 产生的响应行为发送给客服端。

Struts2.3.4 所需的Jar包及介绍

Jar包的分类	jar包名称	jar包版本	jar包 文件名	jar包 的作用	jar包内包含的主要包路径及主要类	依赖的自有jar包名称	依赖的第三方jar包名称	本jar包是否为第三方包
Struts 2.3.4 的 核 心 包	struts2-core -2.3.4.jar	2.3.4	struts2-core -2.3.4	struts2的核心包	org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter	xwork-core -2.3.4.jar		否
	xwork-core -2.3.4.jar	2.3.4	xwork-core -2.3.4	xwork核心包	com.opensymphony.xwork2/ com.opensymphony.xwork2.cinfig/ com.opensymphony.xwork2.ognl/			否
	aopalliance.jar	1.0	aopalliance	这个包为AOP提供了最普通和通用的接口	org.aopalliance.aop/org.aopalliance.aop.intercept			否
	commons-fileupload-1.2.2.jar	1.2.2	commons-fileupload-1.2.2	Struts文件的上传下载	org.apacher.commons.fileupload/ org.apacher.commons.fileupload.util			否
	commons-lang 3-3.1.jar	3.3.1	commons-lang3-3.1	为java.lang包提供扩展	org.apacher.commons.lang3/ org.apacher.commons.lang3.builder			否
	commons-logging -1.1.1.jar	1.1.1	commons-logging -1.1.1	Jakarta的通用日志记录包	org.apacher.commons.logging/org.apacher.commons.logging.impl			否
	freemarker-2.3.19.jar	2.3.19	freemarker-2.3.19	FreeMarker是一个模板引擎，一个基于模板生成文本输出的通用工具				否
	ognl-3.0.5.jar	3.0.5	ognl-3.0.5	支持ognl表达式	Ognl			否
辅 助 Jar 包	struts2-spring -plugin-2.3.4.jar	2.3.4	struts2-spring -plugin-2.3.4	struts2和spring整合需要的包				否
	antlr-2.7.2.jar	2.7.2	antlr-2.7.2	它是这样的一种工具,它可以接受词文法语言描述,并能产生识别这些语言的语句的程序
	asm-3.3.jar	3.3	asm-3.3	操作java字节码的类库
	asm-commons-3.3.jar	3.3	asm-commons-3.3	提供了基于事件的表现形式
	asm-tree-3.3.jar	3.3	asm-tree-3.3	提供了基于对象的表现形式
	classworlds-1.1.jar	1.1	classworlds-1.1	基于java操作类装载的开发框架。java的classloader的机制和本地类可以引起头痛，多为某些类型的应用程序开发的混乱。
	commons-beanutils-1.8.0.jar	1.8.0	commons-beanutils-1.8.0	jakarta commons项目中的一个子项目。这个项目开发的目的是帮助开发者动态的获取/设值JavaBean的属性，同时解决每次都要写getXXX和setXXX的麻烦
	commons-chain-1.2.jar	1.2	commons-chain-1.2	Apache 的 Commons-Chain 项目已将命令模式(Command)和责任链(Chain of Responsebility)模式两者完美的结合
	commons-collections-3.1.jar	3.1	commons-collections-3.1	包含了一些Apache开发的集合类，扩展了标准的Java Collection框架，提供了额外的Map、List 和Set实现以及多个有用的工具类库。功能比java.util.*强大。
	commons-digester-2.0.jar	2.0	commons-digester-2.0	Jakarta Struts中的一个工具，用于处理struts-config.xml配置文件
	commons-logging-api-1.1.jar	1.1	commons-logging-api-1.1	Apache Commons包中的一个，包含了一些数据类型工具类，是java.lang.*的扩展。
	commons-validator-1.3.1.jar	1.3.1	commons-validator-1.3.1	校验方法)和校验规则。支持校验规则的和错误消息的国际化。 struts使用它对表单进行验证
	dwr-1.1.1.jar	1.1.1	dwr-1.1.1	Direct Web Remoting是一个WEB远程调用框架.Java开发利用这个框架可以让AJAX开发变得很简单.
	ezmorph-1.0.6.jar	1.0.6	ezmorph-1.0.6	EZMorph是一个简单的java类库用于将一种对象转换成另外一种对象。EZMorph原先是Json-lib项目中的转换器。EZMorph支持原始数据类型（Primitive），对象（Object），多维护数组转换与DynaBeans的转换。struts2中，json的处理便使用了EZMorph库
	google-collections-1.0.jar	1.0	google-collections-1.0	对现有Java集合类的一个扩展。
	jackson-core-asl-1.9.2.jar	1.9.2	jackson-core-asl-1.9.2	一个高性能的解析器的核心库
	json-lib-2.3-jdk15.jar	2.3	json-lib-2.3-jdk15	提供了强大的JSON支持，利用Ajax提交上来的JSON字符串进行解析，可以转化为POJO对象，可以从POJO转化为js可以识别的JSON对象。
	juli-6.0.18.jar	6.0.18	juli-6.0.18	用于tomcat 错误日志查看
	oro-2.0.8.jar	2.0.8	oro-2.0.8	RO一套文本处理工具,能提供perl5.0兼容的正则表达式,AWK-like正则表达式, glob表达式。还提供替换,分割,文件名过虑等功能
	oval-1.31.jar	1.31	oval-1.31	OVal是一个提供事务和对象的可扩展验证框架的任何类型的Java对象。
	plexus-container-default-1.0-alpha-10.jar	1.0	plexus-container-default-1.0-alpha-10	Plexus项目提供完整的软件栈，用于创建和执行软件项目。根据丛容器，应用程序可以利用面向组件编程构建模块化，它可以轻易地组装和重用可重用组件。根据Plexus容器，应用程序可以利用面向组件编程构建模块化，它可以轻易地组装和重用可重用组件。
	plexus-utils-1.2.jar	1.2	plexus-utils	Plexus项目提供完整的软件栈，用于创建和执行软件项目。根据丛容器，应用程序可以利用面向组件编程构建模块化，它可以轻易地组装和重用可重用组件。
	sitemesh-2.4.2.jar	2.4.2	sitemesh-2.4.2	SiteMesh是一个用来在JSP中实现页面布局和装饰（layout and decoration）的框架组件，能够帮助网站开发人员较容易实现页面中动态内容和静态装饰外观的分离。
	struts2-codebehind-plugin-2.3.4.jar	2.3.4	struts2-codebehind-plugin-2.3.4	通常JSP页面来自于文件系统。利用这个插件，你可以将jsp页面部署到jar包中
	struts2-config-browser-plugin-2.3.4.jar	2.3.4	struts2-config-browser-plugin-2.3.4	struts配置浏览器所需要的插件
	struts2-convention-plugin-2.3.4.jar	2.3.4	struts2-convention-plugin-2.3.4	在默认情况下该公约插件查找操作类在以下软件包支柱,struts2的行为或行动,任何包相匹配这些名称将被考虑作为根包为常规插件。
	struts2-dojo-plugin-2.3.4.jar	2.3.4	struts2-dojo-plugin-2.3.4	为struts所提供的一些控件例如：日历
	struts2-dwr-plugin-2.3.4.jar	2.3.4	struts2-dwr-plugin-2.3.4	用于整合DWR
	struts2-embeddedjsp-plugin-2.3.4.jar	2.3.4	struts2-embeddedjsp-plugin-2.3.4	用于将jsp页面放在jar包中
	struts2-jasperreports-plugin-2.3.4.jar	2.3.4	struts2-jasperreports-plugin-2.3.4	用于整合JasperReports
	struts2-javatemplates-plugin-2.3.4.jar	2.3.4	struts2-javatemplates-plugin-2.3.4	Apache提供的'javatemplates'用于代替默认的Freemarker渲染器
	struts2-jfreechart-plugin-2.3.4.jar	2.3.4	struts2-jfreechart-plugin-2.3.4	struts2使用jfreechart的插件包
	struts2-jsf-plugin-2.3.4.jar	2.3.4	struts2-jsf-plugin-2.3.4	sturts整合jsf的插件包
	struts2-json-plugin-2.3.4.jar	2.3.4	struts2-json-plugin-2.3.4	struts2所用到的json插件包
	struts2-junit-plugin-2.3.4.jar	2.3.4	struts2-junit-plugin-2.3.4	struts所提供的junit调试
	struts2-osgi-plugin-2.3.4.jar	2.3.4	struts2-osgi-plugin-2.3.4	这个插件提供了支持启动一个实例的Apache Felix在一个web应用程序,和扫描安装的bundle的Struts配置。还提供了一个管理包
	struts2-oval-plugin-2.3.4.jar	2.3.4	struts2-oval-plugin-2.3.4	插件定义了拦截器”ovalValidation”和拦截器堆栈”ovalValidationStack”在“oval-default”包。使用这个拦截器,扩大“oval-default””包
	struts2-plexus-plugin-2.3.4.jar	2.3.4	struts2-plexus-plugin-2.3.4	使用该插件,当配置Struts动作,拦截器,在Struts或结果。xml,设置class属性包含丛对象id,而不是实际的Java类。这将允许丛来创建对象和注入任何依赖关系也由管理丛。
	struts2-portlet-plugin-2.3.4.jar	2.3.4	struts2-portlet-plugin-2.3.4	Portlet的插件,用于发展中JSR286 Portlet使用Struts
	struts2-rest-plugin-2.3.4.jar	2.3.4	struts2-rest-plugin-2.3.4	rest插件用于自动处理序列化,并反序列化每种格式。
	struts2-sitegraph-plugin-2.3.4.jar	2.3.4	struts2-sitegraph-plugin-2.3.4	生成一个web应用程序的图形视图
	struts2-struts1-plugin-2.3.4.jar	2.3.4	struts2-struts1-plugin-2.3.4	这个jar包是用于将strusts和spring进行整合的一个插件，在处理数据库的事物时，通过这个插件将数据源配置到底层的sessionFactory中，然后再将sessionFactory注入到相应Dao层或者service层，在配置请求页面的处理结果页面配置struts.xml文件由spring进行管理的
	struts2-testng-plugin-2.3.4.jar	2.3.4	struts2-testng-plugin-2.3.4	这个插件是用来在单元测试,而不是在运行时。因此,它包含在您的构建的类路径中,但不要将它部署WEB-INF/lib在Struts2的应用程序
	struts2-tiles-plugin-2.3.4.jar	2.3.4	struts2-tiles-plugin-2.3.4	这个插件可以安装插件jar复制到应用程序的WEB-INF/lib 目录中
	struts2-tiles-plugin-2.3.4.jar	2.3.4	struts2-tiles-plugin-2.3.4	这个插件可以安装插件jar复制到应用程序的WEB-INF/lib 目录中
	testng-5.1-jdk15.jar	5.1	testng-5.1-jdk15	TestNG是一个测试框架从JUnit和NUnit启发,但该框架引入了一些新功能,使它更强大,也更容易使用。而该jar包就是用于整合使用该框架。
	tiles-api-2.0.6.jar	2.0.6	tiles-api-2.0.6	提供对tiles的支持：类和标记库在一个JSP环境中使用tiles。
	tiles-core-2.0.6.jar	2.0.6	tiles-core-2.0.6	tiles核心库,包括基本的实现的api。
	tiles-jsp-2.0.6.jar	2.0.6	tiles-jsp-2.0.6	提供对tilesJSP的支持:类和标记库在一个JSP环境使用tiles。
	velocity-1.6.3.jar	1.6.3	velocity-1.6.3	Java模板技术-velocity
	xmlpull-1.1.3.1.jar	1.1.3.1	xmlpull-1.1.3.1	支持可扩展的XML
	xpp3_min-1.1.4c.jar	1.1.4	xpp3_min-1.1.4c	Java对象和XML之间相互转换所需JAR包
	xstream-1.4.2.jar	1.4.2	xstream-1.4.2	xstream 提供对象和xml之间的转换