Struts2 标签库讲解
转自:http://blog.163.com/hzd_love/blog/static/131999881201082111852520/
要使用Struts2的标签,只需要在JSP页面添加如下一行定义即可:
<%@ taglib prefix="s" uri="/struts-tags"%>
struts2的标签共分为五大类:
一、逻辑控制标签
用于进行逻辑控制输出。主要分以下几类:
1) 条件标签:用于执行基本的条件流转
:拥有一个test属性,其表达式的值用来决定标签里内容是否显示。欢迎hzd
:同上。
2) 迭代标签:用于遍历集合(java.util.Collection)或者枚举值(java.util.Iterator)类型的对象, value属性表示集合或枚举对象, status属性表示当前循环的对象,在循环体内部可以引用该对象的属性
姓名:
年龄:
3) 组合标签:用于将多个枚举值对象进行叠加,形成一个新的枚举值列表
如将3个列表对象进行了组合,形成新的列表对象:
输出:
4) 分割标签:用于将一个字符串进行分隔,产生一个枚举值列表
下面的代码将分隔为3个字符串,然后循环输出
5) 合并标签:用于将多个枚举值按照数组的索引位置进行合并
--设mylist1列表中有a,b,c三个元素
--设mylist2列表中有1,2,3三个元素
合并后新的列表的元素及其顺序为:a,1,b,2,c,3
6) 排序标签:用于对一组枚举值进行排序,属性 comparator指向一个继承自java.util.Comparator的比较器,该比较器可以是对应Action页面中的一个比较器变量, source指定要排序的列表对象
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);
}
};
}
然后引用该对象筛选子集:
或者不使用Decider对象:
 
二、数据输出标签
数据输出标签用以输出页面中的元素、属性、隐含变量等,即包括静态文本的输出,也包括struts2集成的各种变量的输出。
2) Action标签:可以直接调用Action类中的函数, 前提是该Action类在struts.xml中有定义,name属性用于指向 映射文件中配置的Action函数,executeResult属性表示是否执行结果集的跳转
--表示执行LoginAction的默认处理方法execute()
--表示执行LoginAction的处理方法login()
3) JavaBean标签:用于创建一个JavaBean对象, name表示JavaBean类全名, var表示变量的实例名,并可以包含 >设置实例化输入参数
--为该JavaBean的构造方法传递参数
4) 日期标签:用以输出一个格式化的日期对象, name表示要输出的对象, format表示输出的日期格式
 
--默认格式
5) 调用标签:用以输出页面的值栈调试信息, 通常在进行程序调用时使用,便于查找JSP页面中的错误
6) 引用资源文件标签:用于 加载资源包到值栈, 它可以允许标签访问任何资源包的信息,而不只是当前action相关联的资源包。name属性用以指定资源包的类路径
如xxx.xxx.xxx.ApplicationMessages中定义了标签:HelloWord=欢迎您!
则可以这样引用:
7) 包含页面标签:用来包含一个Servlet的输出(Servlet或JSP页面),使用 value属性指定包含页名称,可以使用 传递参数给子页
hzd--参数username=hzd给test.jsp页面
8) 传递参数标签:用来 为其他标签提供参数,所以一般是嵌套在其它标签的内部, name属性用来指定参数名称, value(可选)属性用来指定参数值
--这种方式的参数值会以String格式放入stack
hzd--这种方式的参数值会以Object的格式放入stack
9) 值栈标签:用以加入一个值到值栈中
--为user指定name属性
--为user指定age属性
10) 变量赋值标签:赋予变量一个特定范围内的值, name属性表示变量的名字, scope表示变量的作用域(application.session.request.page.action), value变量的值
11) 国际化标签:用于输出国际化信息, name属性指定国际化资源文件中消息文本的key,可以与标签结合使用
--它会按照一定的顺序查找资源文件,直到找到定义HellowWord标签的资源文件为止
12) 链接标签:用于创建一个URL链接,并可以通过标签提供request参数
hzd
13) 属性标签:用以输出 value属性的值,并拥有一个 default属性,在value对象不存在时显示。 escape属性为true,来输出原始的HTML文本
 
三、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错误信息
2) 消息标签:用以输出Action普通消息
3) 字段错误标签:用以输出Action校验中 某一个字段的错误信息或所有字段的错误信息
--输出所有字段的错误信息
username--输出字段username的错误信息
password--输出字段password的错误信息
4) DIV标签:用以输出一个
标签
 
五、AJAX标签
AJAX标签是struts2专门提供的一组进行AJAX操作的标签,在使用这些标签之前,需要在JSP页面中添加如下引用:
<%@ taglib prefix="sx" uri="/struts-dojo-tags"%>
使用form标签:
targetDiv">
targetDiv" showLoadingText="false" indicator="loadingImage" />
使用url标签:
targetDiv">
ajaxTest" value="/LoginAction.action">
targetDiv" href="%{ ajaxTest}" showLoadingText="false" indicator="loadingImage" />
2) 自动完成标签:是一个组合框组件,在文本框中输入文本,能够给出一个下拉的提示列表。 list属性用以指定一个自动提示检索的列表集合(可以是Action中的List类型的属性), autoComplete属性为true时表示进行自动提示
3) 自动事件绑定标签:该标签可以为多个对象的多个事件进行监听,并能够发送异步请求。 src属性指定监听的对象源, events属性指定监听的事件类型(JavaScript事件), target属性指定异步返回内容填充的目标, indicator属性表示执行异步请求时显示的图片
bin" />
bin"  events="onclick" targets="targetDiv" showLoadingText="false" indicator="%{getText('loadingImage')}" />
4) 日期选择标签:用以弹出一个日期和时间的选择窗口, displayFormat属性指定要选择日期的格式, name表示当前组件的属性的对象, value表示默认值, label表示显示的文本
5) 树标签:用以输出一个树形结构
6) Tab页标签:使用AJAX的方式显示多个Tab页