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("消息");