struts2标签库
要使用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>
（备注：以上文章来自http://blog.163.com/hzd_love/blog/static/131999881201082111852520/）
实例操作：tags.jsp
<%@page import="com.briup.struts.bean.Book"%> <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> <%@taglib uri="/struts-tags" prefix="s"%> <% String path = request.getContextPath(); String basePath = request.getScheme() + "://" + request.getServerName() + ":" + request.getServerPort() + path + "/"; %> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <base href="<%=basePath%>"> <title>My JSP 'tags.jsp' starting page</title> <meta http-equiv="pragma" content="no-cache"> <meta http-equiv="cache-control" content="no-cache"> <meta http-equiv="expires" content="0"> <meta http-equiv="keywords" content="keyword1,keyword2,keyword3"> <meta http-equiv="description" content="This is my page"> <!-- <link rel="stylesheet" type="text/css" href="styles.css"> --> <style type="text/css"> body { font-size: 30pt; } h1 { font-size: 40pt; color: blue; } </style> </head> <body> <center> <h1> Iterator标签的使用 </h1> <% List<Book> books = new ArrayList<Book>(); Book book1 = new Book(1l, "struts2", 100d); Book book2 = new Book(2l, "HTML", 100d); Book book3 = new Book(3l, "JSP", 100d); books.add(book1); books.add(book2); books.add(book3); session.setAttribute("books", books); %> <table border="1" cellspacing="0"> <tr> <td>id</td> <td>名字</td> <td>价格</td> </tr> <%-- 为什么必须要加上"#"?--%> <s:iterator value="#session.books" var="book" status="s"> <tr> <td><s:property value="#book.id"></s:property></td> <td><s:property value="#book.name"></s:property></td> <td><s:property value="#book.price"></s:property></td> </tr> </s:iterator> </table> <h1> if标签的使用 </h1> <table> </table> <s:if test="2>1"></s:if> <!-- if(2>1){ write("正确") }else if(2<1){ write(不正确) } else{}--> <s:elseif test="2=2">xxx</s:elseif> <s:else>xxxxx'</s:else> <h1> append标签的使用 </h1> <s:append id="newList"> <s:param value="{'a','b','c'}"></s:param> <s:param value="{'d','e','f'}"></s:param> <s:param value="{'g','h','i'}"></s:param> </s:append> <s:iterator value="#attr.newList"> <s:property /> </s:iterator> <h1> generator标签的使用 </h1> <!-- split(":") --> <s:generator separator=":" val="'aa:bb:cc:dd:ee:ff'" count="4" id="newList2"></s:generator> <s:iterator value="#attr.newList2"> <s:property /> </s:iterator> <h1> merge标签的使用 </h1> <s:merge id="newList3"> <s:param value="{'a','b','c'}"></s:param> <s:param value="{'d','e','f'}"></s:param> <s:param value="{'g','h','i'}"></s:param> </s:merge> <s:iterator value="#attr.newList3"> <s:property /> </s:iterator> <h1> subset标签的使用 </h1> <s:subset count="3" source="{'a','b','c','d','e'}" start="2" id="newList4"> </s:subset> <s:iterator value="#attr.newList4"> <s:property /> </s:iterator> <h1> set标签的使用 </h1> <s:set name="newList6" scope="session" value="{1,2,3,4,5}"></s:set> <!-- List xx=session.getAttribute("books") session.setAttribute("newList6",xx); --> <s:iterator value="#session.newList6"> <%-- <s:property value="id" /> <s:property value="name" /> <s:property value="price" /> --%> <s:property/> </s:iterator> <h1> push标签的使用 </h1> <s:push value="#attr.books"> <s:debug></s:debug> <s:property value="id" /> <s:property value="name" /> <s:property value="price" /> </s:push> <h1> bean标签的使用 </h1> <s:bean name="com.briup.struts.bean.Book" id="briup"> <s:param name="id" value="100"></s:param> <s:param name="name" value="'struts2'"></s:param> <s:param name="price" value="100.0"></s:param> </s:bean> <!-- Book briup=new Book(100,"struts2",100D) --> <s:property value="#briup.id" /> <s:property value="#briup.name" /> <s:property value="#briup.price" /> <h1> Date标签的使用 </h1> <% Date date = new Date(); session.setAttribute("now", date); //String Date格式化输出 SimpleDateFormat %> <s:date name="#session.now" format="yyyy-MM-dd HH:mm:ss"/> <h1> form标签的使用 ui </h1> <s:form name="myform" action="index.jsp" theme="simple" method="post"> 用户名： <s:textfield name="username"></s:textfield> <!-- type=text --> <s:checkboxlist list="#{1:'足球',2:'篮球',3:'排球'} " name="hobby" listKey="key" listValue="value" value="{1}"></s:checkboxlist> <s:submit></s:submit> </s:form> </center> </body> </html>
ognl表达式
OGNL运算符基本与Java相同，但它还有一些特殊的运算符：
逗号（,）：用逗号分隔多个OGNL表达式，这些表达式会依次被执行，而最后一个表达式的值为整个表达式的值；
大括号（{}）：用来创建列表，例如：{‘zhangSan’,’liSi’,’wangWu’}表示一个List；
in和not in：in表示判断某个值是否在集合中，not in表达某个值是否不在集合中。
另外，“?”表示所有满足条件的元素都查询出来。还可以使用“^”或“$”，其中“^”表示查询第一个满足条件的元素，而“$”表示查询最后一个满足条件的元素。
<s:debug></s:debug>可以查看valueStack中存放的键值对。
<?xml version="1.0" encoding="UTF-8" ?> <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@page import="com.briup.struts.bean.User"%> <%@ taglib uri="/struts-tags" prefix="s" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <title>OGNL</title> </head> <body> <ol> <% User u = new User(); u.setUsername("briup"); session.setAttribute("user",u); %> <s:debug></s:debug> <li>访问值栈中的action的普通属性: name = <s:property value="name"/></li> <li>访问值栈中user对象的普通属性(get set方法)：<s:property value="user.username"/>|<s:property value="user['username']"/>||</li> <li>访问值栈中对象的普通方法：<s:property value="name.length()"/></li> <li>访问值栈中action的普通方法：<s:property value="execute()" /></li> <hr /> <li>访问静态方法：<s:property value="@com.briup.struts.ognl.OGNLAction@staticMethod()"/></li> <li>访问静态属性：<s:property value="@com.opensymphony.xwork2.ActionSupport@SUCCESS"/></li> <li>访问Math类的静态方法：<s:property value="@java.lang.Math@random()"/></li> <hr /> <% request.setAttribute("foo","test"); %> <!-- ${requestScope.foo} --> <s:property value="#request.foo"/><br/> <s:textfield name="username" label="%{#request.foo}"></s:textfield> <li>访问普通类的构造方法：<s:property value="new com.briup.struts.bean.User(22,'jin','bb').username"/></li> 访问session中的数据: <hr /> <li>访问List:<s:property value="users"/></li> <li>访问List中某个元素:<s:property value="users[0]"/></li> <li>访问List中元素某个属性的集合:<s:property value="users.{age}"/></li> <li>访问List中元素某个属性的集合中的特定值:<s:property value="users.{username}[0]"/></li> <li>访问Map:<s:property value="userMap"/></li> <li>访问Map中某个元素:<s:property value="userMap.u1"/></li> <li>访问Map中所有的key:<s:property value="userMap.keys"/></li> <li>访问Map中所有的value:<s:property value="userMap.values"/></li> <li>访问容器的大小：<s:property value="userMap.size()"/> | <s:property value="users.size()"/> </li> <hr /> <!-- 集合中age属性〉10的所有user 6 12 10--> <li>投影(过滤)：<s:property value="users.{?#this.age>8}"/></li> <!-- 集合中age属性大于8的所有user的age --> <%--为什么#前面有那几个符号？ --%> <li>投影：<s:property value="users.{^#this.age>8}.{age}"/></li> <li>投影：<s:property value="users.{?#this.age<8}.size()==0"/></li> <li>投影：<s:property value="users.{$#this.age>8}.{age}"/></li> <s:property value="8>1"/></li> <hr /> <%-- 下面的[0]代表什么意思？--%> <li>[]:<s:property value="[0].name"/></li> <li>[]:<s:property value="[0]"/></li> <li>[]:<s:property value="[0].users"/></li> </ol> <s:debug></s:debug> </body> </html>