Struts 2 标签库使用大全
n672
10年前
<s:if>标签
拥有一个test属性,其表达式的值用来决定标签里内容是否显示<s:if test="#request.username=='clf'">欢迎clf</s:if> <s:elseif test="#request.username=='yqy'>欢迎yqy</s:elseif> <s:else>请登录</s:else>
<s: iterator>标签
用于遍历集合(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> <s:debug></s:debug> <s:iterator value="#request.strs" var="strs"> <s:property value="#strs"/> </s:iterator> <s:debug></s:debug>
<s:textfield>
文本框标签,可填写文本内容,同时该标签含有很多有用的属性:readonly 只读属性
disabled 可用/不可用属性,如果设置为不可用在提交表单的时候该文本框的值不会传到后台
cssClass 指定css的class
cssStyle 自定义css样式
maxlength 文本框可输入的文字个数
tooltip 冒泡提示
<s:form action="register" method="post"> <s:textfield name="username" label="用户名"></s:textfield> </s:form>
<s:password>
与<s:textfield>类似<s:textarea>
与<s:textfield>类似其核心属性cols和rows分别指定文本域的宽度和高度
<s:file>标签
与<s:textfield>类似<s:submit>标签
生成提交按钮<s:reset>标签
生成重置按钮<s:radio>标签
<s:radio name="sex" list="#{'male':'男','female':'女'}" value="male" label="性别" tooltip="选择性别">
使用value指定默认值
radio标签的list属性必须是Map类型,key为实际值,value为显示值,如果为List类型会抛出异常
<s:checkbox>标签
<s:checkbox name="checkName" value="true" fieldValue="Y"/>
struts2的checkbox标签在使用的时候需要注意它的两个属性。value和fieldValue,在其他的标签中value是真实值。而在checkbox中,value如果为true,就表示复选框被选中;如果为false就表示不被选中。fieldValue才是此复选框对应的真实的值。
<s: checkboxlist>标签
拥有list、listKey、listValue属性,参照<s:select>标签的注解<s:checkbox list name="interest" list="{'足球','篮球','排球','游泳'}" label="兴趣爱好"/>
需要用复选框时,如果对应的属性为Boolean类型时用checkbox标签,如果为集合类或者数组类则用checkboxlist标签
<s: combobox>标签
此标签用于生成一个组合框,即可选择,也可编辑,就是一个编辑框加一个下拉框<s:combobox list="#request.list2" name="fruit" label="最喜爱的水果"/>
<s:select>标签
输出一个下拉列表框,相当于HTML代码中的<select/>常用属性如下:
list:必需,可以为Cellection、Map、Enumeration、Iterator、array类型,指定要迭代的集合,使用集合中的元素来设置各个选项,如果list的属性为Map则Map的key成为选项的value,Map的value会成为选项的内容
listKey:指定集合对象中的哪个属性作为选项的value
listValue:指定集合对象中的哪个属性作为选项的内容
headerKey:设置当用户选择了header选项时,提交的的value,如果使用该属性,不能为该属性设置空值,headerKey指定缺省的选项"value",headerValue指定缺省的选项"text"
headerValue:显示在页面中header选项内容
emptyOption:是否在header选项后面添加一个空选项
multiple:是否多选
size:显示的选项个数
示例如下
<s:select list="{'aa','bb','cc'}" headerKey="00" headerValue="00"></s:select> <s:select list="#{1:'aa',2:'bb',3:'cc'}" label="abc" listKey="key" listValue="value" headerKey="0" headerValue="aabb"> <% java.util.HashMap map = new java.util.LinkedHashMap(); map.put(1,"aaa"); map.put(2,"bbb"); map.put(3,"ccc"); request.setAttribute("map",map); request.setAttribute("aa","2"); %> <s:select list="#request.map" label="abc" listKey="key" listValue="value" value="#request.aa" headerKey="0" headerValue="aabb"></ s:select>
<s:doubleselect>标签
输出关联的两个HTML列表框,产生联动效果list、listKey、listValue、headerKey、headerValue、emptyOption、multiple、size属性与<s:select>标签一样,作用域第一个下拉框
doubleId:指定第二个列表框的ID
doubleList:指定第二个下拉框要迭代的集合
doubleListKey:指定集合对象中的哪个属性作为选项的value,该选项只对第二个列表框起作用
doubleListValue:指定集合对象中的哪个属性作为选项的内容,该选项只对第二个列表框起作用
doubleSize:选项个数
doubleName:指定第二个列表框的name映射
doubleValue:第二个列表框的初始选项
注意,list属性必须为结合类型或者数组类型,而doublelist属性必须为Map类型
//城市对象 public class CityBean { private int cityid; private String cityname; //省略了setter、getter方法 } //区域对象 public class AreaBean { private int areaid; private String areaname; private int cityid; //省略了setter、getter方法 } public class CityAction extends ActionSupport { //map映射cityid--区域列表 private Map<Integer, List<AreaBean>> areaMap = new HashMap<Integer, List<AreaBean>>(); //list装所有city集合 private List<CityBean> cityBeans = new ArrayList<CityBean>(); public Map<Integer, List<AreaBean>> getAreaMap() { return areaMap; } public void setAreaMap(Map<Integer, List<AreaBean>> areaMap) { this.areaMap = areaMap; } public List<CityBean> getCityBeans() { return cityBeans; } public void setCityBeans(List<CityBean> cityBeans) { this.cityBeans = cityBeans; }
<!-- areaMap[top.cityid]: top是指前一个下拉框整个的选中项cityBean, cityid就是指cityBean中cityid 所以areaMap[top.cityid]指map集合中第一个下拉框选中的id对应的list集合 list里面每个元素放的是AreaBean --> <s:doubleselect tooltip="选择城市操作" label="请选择城市" name="city" list="cityBeans" listKey="cityid" listValue="cityname" doubleList="areaMap[top.cityid]" doubleName="area" doubleListKey="areaid" doubleListValue="areaname" />
让它们一行显示,比较简单的做法是:
定义样式:
<style type="text/css"> .doubleselect br{ display: none; } < /style>
< div class="doubleselect">把<s:form>的代码放进来</div>
<s:date>标签
用以输出一个格式化的日期对象,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" />--默认格式
<s:append>标签
用于将多个枚举值对象进行叠加,形成一个新的枚举值列表如将3个列表对象进行了组合,形成新的列表对象:
<s:append var="newIteratorList"> <s:param value="%{myList1}" /> <s:param value="%{myList2}" /> <s:param value="%{myList3}" /> </s:append>
<s:generator>标签
下面的代码将分隔为3个字符串,然后循环输出<s:generator val="%{'aaa,bbb,ccc'}"> <s:iterator> <s:property /> </s:iterator> </s:generator>
<s:merge>标签
用于将多个枚举值按照数组的索引位置进行合并<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:sort>标签
用于对一组枚举值进行排序,属性comparator指向一个继承自java.util.Comparator的比较器,该比较器可以是对应Action页面中的一个比较器变量,source指定要排序的列表对象<s:bean id="myComparator" name="com.clf.MyComparator"></s:bean> <s:sort comparator="myComparator" source="budget.approve"> <s:iterator value="budget.approve" status="st"> </s:iterator> </s:sort>
import java.util.Comparator; public class MyComparator implements Comparator<Object> { public int compare(Object arg0, Object arg1) { System.out.println(arg0.toString().compareTo(arg1.toString())); //默认从小到大排列 return arg0.toString().compareTo(arg1.toString()); //从大到小排列 //return -(arg0.toString().compareTo(arg1.toString())); } }
<s:subset>标签
subset标签用于取得集合的子集,该标签的底层通过org.apache.Struts2.util.Subset.IteratorFilter类提供实现。使用subset标签可以指定如下几个属性:count:可选属性,指定子集中元素的个数,默认取得源集合的所有元素
source:可选属性,指定源集合,如果不指定,默认取得valueStack栈顶的集合,一般都会指定
start:可选属性,指定从源集合的第几个元素开始截取,默认从第一个元素(即start=0)开始
decider:可选属性,由开发者自己决定是否选中该元素
<!--截取从下标1开始的三个元素--> <s:subset source="{'Java','Spring2.0','J2EE','Ajax','WebWork'}" start="1" count="3"> </s:subset>
此外,Struts2还允许开发者决定截取标准,开发者只需要实现一个Decider类,实现SubsetIteratorFilter.Decider接口中的boolean decide(Object element)方法,如果该方法返回真,则表明该元素将被选入子集中。看如下代码:
import org.apache.struts2.util.SubsetIteratorFilter; public class MyDecider implements SubsetIteratorFilter.Decider { public boolean decide(Object element) throws Exception { String str = (String)element; return str.indexOf("J2EE") > 0; } }
<!--截取包含"J2EE"的所有元素--> <s:subset source="{'Java','Spring2.0','J2EE','Ajax','WebWork'}" decider="#mydecider"> </s:subset>
<s:a>标签
用于创建一个<a>标签,errorText用于显示错误信息,preInvokeJS表示该链接执行时的javascript提示函数,href表示跳转地址.<s:a errorText="删除错误" preInvokeJS="confirm('确认删除?')" href="test.jsp"> <img src="/image/delete.gif" /> </s:a>
带参数的链接
<s:iterator value="#request.userList"> <tr align="center"> <td><s:property value="id"/> : <s:property value="username"/></td> <td><s:property value="age"/></td> <td><s:property value="sex"/></td> <td><s:property value="address"/></td> <td> <s:a href="userAction!addUser.action">添加</s:a> | //第一种方式,在标签内使用标签时用% <s:a href="userAction!loadUser.action?user.id=%{id}">编辑</s:a> | //第二种方式:使用<s:url>标签解决 <s:url id="idUrl" action="userAction!delUser.action"> <s:param name="user.id" value="%{id}"></s:param> </s:url> <s:a href="%{idUrl}">删除</s:a> //第三种:直接加入 <a href="<s:url action="userAction!delUser.action"> <s:param name="user.id" value="id"/> </s:url>">删除2 </a> </td> </tr> </s:iterator>
<s:url>标签
<s:url>生成一个url地址,可以通过url标签制定的<s:param>子元素向URL地址发送请求参数<s:url action=""> --指定请求地址 <s:param name="" value=""></s:param> --指定参数 </s:url>
属性includeParams:该属性有三个值:none、get、 all,默认值为get
当该属性值为get时,该url会将访问其所在jsp的的请求的所有get方法的参数添加到自身来
当它的属性值为all时,更是将get和post的的参数值全部添加到自身来
当includeParams的值是all或get,param标签中定义的参数将有优先权,也就是说其会覆盖其他同名参数的值
<s:action>标签
使用action标签,可以允许在jsp页面中直接调用Action,在调用Action时候,可以指定需要被调用的Action的name和namespace.如果指定了executeResult参数的属性值为true,该标签会把Action的处理结果(视图资源)包含到本页面中. 使用action标签指定属性有:id: 可选属性,作为该Action的引用ID
<s:action name="actionName" executeResult="true" namespace="/"> <s:param name="currentPage" value="传递的值"></s:param> </s:action> <!-- <s:param ></s:param>是以request.setAttribute方式的值的,而不是以参数传值 -->
name:必选属性,指定调用Action
namespace:可选属性,指定该标签调用Action所属namespace
executeResult:可选属性,指定是否将Action的处理结果包含到本页面中.默认值为false,不包含.
ignoreContextParam:可选参数,指定该页面的请求参数是否需要传入调用的Action中,默认值是false,即传入参数.
上例中,以request.getParameter("")会获取不到值
通过request.getAttribute("")方式才可以获取
另外,使用<s:param ></s:param> value指代的是action定义的对象的名称,而不是一个具体的值,和 <s:textfield>中的name是一个意思,所以要要传递字符串不能把值写value中而应该写到
<s:param >写到这里</s:param>
<s:param >标签
param标签用来把一个参数传递给包含着它的那个标签。不管在给出value属性值时有没有使用"%{"和"}",Struts都会对它进行求值。就是说value指代的是action定义的对象、属性的名称,而不是一个具体的值
例如,下面这个param标签的值是userName动作属性:
<s:param name="userName" value="userName"/>它与下面这个标签是等价的:
<s:param name="userName" value="%{userName}"/>如果想传递一个String类型的字符串作为参数值,必须把它用单引号括起来。例如,下面这个param标签的值是字符串"clf"
<s:param name="userName" value="'clf'"/>
该值会以java.lang.Object的格式放入statck
等价于
<s:param name="userName">clf</s:param>
参数会以String的格式放入statck
这种写法还可以使用一个EL表达式,例如,下面代码将把当前主机名传递给host参数:
而下面这样的写法就不行了:
<s:param name="host" value="${header.host}"/> <!-- 无效的。-->
<s:bean>标签
用于创建一个JavaBean对象,name表示JavaBean类全名,var表示变量的实例名,并可以包含<s:param>设置实例化输入参数public class Test1 { private String str; public String getStr() { return str; } public void setStr(String str) { this.str = str; } public String hello() { return "Hello World!"; } public String hello(String name) { return "Hello," + name; } }
然后就可以使用这个bean了:
<s:bean name="test.Test1" id="mybean"> <s:param name="str" value="'abc'"></s:param> </s:bean> <s:property value="#mybean.str"/><br/> <s:property value="#mybean.hello()"/><br/> <s:property value="#mybean.hello('tom')"/>
<s:property>标签
1,访问Action值栈中的普通属性:<s:property value="attrName"/>
2,访问Action值栈中的对象属性(要有getter、 setter方法):
<s:property value="obj.attrName"/> <s:property value="obj1.obj2.attrName"/>
3,访问值栈中对象属性的方法
<s:property value="obj.methodName()"/>
4,访问值栈中action的普通方法:
<s:property value="methodName()"/>
5,访问静态方法:
<s:property value="@com.softeem.LoginAction@methodName()"/>
6,访问静态属性:
配置属性文件,允许ognl访问静态方法struts.ognl.allow...=true
<s:property value="@com.softeem.LoginAction@attrName"/>
7,访问Math类的静态方法:
<s:property value="@@min(9,7)"/>
8,访问普通类的构造方法:
<s:property value="new com.softeem.User(2)"/>
9,访问集合:
①list集合对象
<s:property value="listName"/>
②list集合中的某个元素
<s:property value="listName[1]"/>
③list中某个属性的集合
<s:property value="listName.{field}"/>
④list中某个属性集合的特定值
<s:property value="listName.{field}[0]"/>
⑤访问set
<s:property value="setName"/>
⑥访问set中某个元素
<s:property value="setName[0]"/>
⑦访问map
<s:property value="mapName"/>
⑧根据key访问Map中的元素
<s:property value="mapName.username"/> <s:property value="mapName['username']"/> <s:property value="mapName[/"username/"]"/>
⑨访问map中所有的key
<s:property value="mapName.keys"/>
10,访问map中所有的values
<s:property value="mapName.values"/>
11,访问map的大小
<s:property value="mapName.size()"/>
12,投影
<s:property value="listName.{?#this.age==1}"/> <s:propertyvalue="listName.{^#this.age>1}"/> <s:propertyvalue="listName.{$#this.age==1}"/> <s:propertyvalue="listName.{$#this.age==1}.{age}==null"/> <s:propertyvalue="[0]"/>值栈中的对象
<s:i18n>与<s:text>标签
<s:i18n>加载资源包到值堆栈。它可以允许<s:text>访问任何资源包的信息,而不只当前action相关联的资源包用<s:text>标签来访问国际化信息,只需要在它的name属性上填入需要的key即可
<s:i18n name="xxx.xxx.xxx.ApplilcationMessages"> <s:text name="HelloWord" /> </s:i18n>
<s:debug>标签
用以输出页面的值栈调试信息,通常在进行程序调用时使用,便于查找JSP页面中的错误它提供的是Struts ValueStack Debug ..也就是说,都是struts2的值栈(就是各个值的信息).
这个值栈又分为两种.Value Stack Contents 和 Stack Context .
(1).Value Stack Contents 里面的信息我们可以用 <s:property value="sss"> 这样来直接访问.
(2) Stack Context 里面的信息我们可以 <s:property value="#sss">这样来访问
<s:include>标签
用来包含一个Servlet的输出(Servlet或JSP页面),使用value属性指定包含页名称,可以使用<s:param>传递参数给子页<s:include value="/test.jsp"> <s:param name="username">clf</s:param> </s:include>
<s:push>标签
用以加入一个值到值栈中user为一个JavaBean对象,里面包含name和age属性
<s:push value="user"> <s:property value="name" /> <s:property value="age" /> </s:push>
<s:set>标签
赋予变量一个特定范围内的值name: 必填,重新生成的新变量的名字
scope: 可选,指定新变量被放置的范围,该属性可以接受application、session、request、page或action 5个值。如果没有指定,默认是放置在Stack Context中。
value: 可选,指定将赋给变量的值。如果没指定,则将ValueStack栈顶的值赋给新变量。
var: 可选,指定该元素的引用ID,如果指定了将会将该值放在ValueStack中
将Stack Context中的p值放入默认范围内。
<s:set value="#p" name="xxx"/> <s:property value="#xxx.name"/>将Stack Context中的p值放入application范围内
<s:set value="#p" name="xxx" scope="application"/> <s:property value="#attr.xxx.name"/>将Stack Context中的p值放入session范围内
<s:set value="#p" name="xxx" scope="session"/> <!--使用JSP2.0表达式语言直接访问session中的属性--> ${sessionScope.xxx.name}
<s:fielderror>标签
显示数据校验错误信息在action中使用
this.addFieldError("错误信息");
然后错误信息会在JSP页面的
<s: fielderror/>说在的地方显示出来
<s:actionerror>标签
显示Action中的错误信息Action中的对应方法
this.addActionError("错误信息");
<s:actionmessage>标签
显示Action中的消息Action中的对应方法
this.addActionMessage("消息");