Struts2 常用标签

Struts2有一个标签库，里面预定义了非常多的标签供我们开发者使用，首先在页面使用以下代码引入标签库：

<%@ taglib prefix="s" uri="/struts-tags"%>

Struts2的标签一共分为四大类

1 逻辑控制类标签

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

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

<s:if test="#request.username=='eric'">
    一点教程网
</s:if>
<s:elseif test="#request.username=='jack'">
   www.yiidian.com
</s:elseif>
<s:else>
   欢迎一起学习IT技术
<s:/else>

2）迭代标签：用于遍历集合或者枚举值类型的对象。

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>

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>

2 数据输出类

数据输出标签用以输出页面中的元素、属性、隐含变量等，即包括静态文本的输出，也包括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）引用资源文件标签：用于加载资源包到值栈,它可以允许<s:text>标签访问任何资源包的信息，而不只是当前action相关联的资源包。name属性用以指定资源包的类路径。

<s:i18n name="com.yiidian.ApplilcationMessages">
     <s:text name="HelloWord" />
</s:i18n>

6）包含页面标签：用来包含一个Servlet的输出(Servlet或JSP页面)，使用value属性指定包含页名称,可以使用。

<s:include value="/test.jsp">
      <s:param name="username">www.yiidian.com</s:param>--参数username=www.yiidian.com给test.jsp页面
</s:include>

7）传递参数标签：用来为其他标签提供参数,所以一般是嵌套在其它标签的内部，name属性用来指定参数名称，value(可选)属性用来指定参数值。

<s:param name="username" value="www.yiidian.com" />--这种方式的参数值会以String格式放入stack
<s:param name="username">www.yiidian.com</s:param>--这种方式的参数值会以Object的格式放入stack

8）值栈标签：用以加入一个值到值栈中。

<s:push value="user">
   <s:property value="name" />--为user指定name属性
   <s:property value="age" />--为user指定age属性
</s:push>

9）变量赋值标签：赋予变量一个特定范围内的值，name属性表示变量的名字，scope表示变量的作用域(application.session.request.page.action)，value变量的值。

<s:set>

10）国际化标签：用于输出国际化信息,name属性指定国际化资源文件中消息文本的key,可以与<s:i18n>标签结合使用

<s:text name="HelloWord" />--它会按照一定的顺序查找资源文件,直到找到定义HellowWord标签的资源文件为止

11）链接标签：用于创建一个URL链接，并可以通过<s:param>标签提供request参数。

<s:url id="url" value="/test.jsp">
     <s:param name="username">www.yiidian.com</s:param>
</s:url>

12）属性标签：用以输出value属性的值，并拥有一个default属性,在value对象不存在时显示。escape属性为true,来输出原始的HTML文本。

<s:property value="getText('some.key')">

3 HTML表单类标签

1）<s:form>标签
<s:form> 标签用于呈现 HTML 语言中的表单元素

2）<s:textfield>和<s:textarea>标签
<s:textfield> 和 <s:textarea> 标签的作用比较相似，都用于创建文本框，其主要区别在于 <s:textfield> 创建的是单行文本框，而 <s:textarea> 创建的是多行文本框。二者的使用也比较简单，一般只需要指定其 label 和 name 属性即可。两个标签的用法如下所示。

<s:textfield label="用户名" name="username"/>

<s:textarea label="描述" name="description"/>

在上述两个用法中，name 属性用于指定单行/多行文本框的名称，在 Action 中，通过 name 属性即可获取单行/多行文本框的值。
此外，<textarea> 标签还可以通过 value 属性指定单行/多行文本框的当前值，通过 cols 和 rows 属性分别指定多行文本框的列数和行数。

3）<s:password>标签
<s:password> 标签用于创建一个密码输入框，它可以生成 HTML 中的 <input type="password"/> 标签。
需要注意的是，Struts2 的 <s:password> 标签与 HTML 的 <input type="password"/> 标签也略有不同：<input type="password"/> 标签只要设置 value 属性就可以将 value 的属性值作为默认显示值；而 Struts2 的 <s:password> 标签除了要设置 value 属性值以外，还要设置 showPassword 属性值为 true。

4）<s:radio>标签
<s:radio> 标签用于创建单选按钮，生成 HTML 中的 <input type="radio"/> 标签

5）<s:reset>标签
<s:reset> 标签用于创建一个重置按钮，会生成 HTML 中的 <input type="reset"/> 标签，该标签的使用比较简单，其常用属性为 name 和 value。

6）<s:submit>标签
<s:submit> 标签主要用于产生 HTML 中的提交按钮，该表单元素中，可以指定提交时的 Action 对应的方法。该标签通常与 <s:form> 标签一起使用。

7）<s:checkboxlist>标签
<s:checkboxlist> 标签用于一次性创建多个复选框，用户可以选择创建零到多个复选框，它可以产生一组<input type="checkbox"/>标签。

8）<s:select>标签
<s:select> 标签用于创建一个下拉列表框，它会生成 HTML 中的 <select> 标签。

9）<s:optgroup>标签
<s:optgroup> 标签用于生成选项组，通常作为 <s:select> 标签的子标签使用。由于在一个下拉列表框中可以包含多个选项组，所以 <s:select> 标签也能够包含多个 <s:optgroup> 标签。

10）<s:file>标签
<s:file> 标签用于创建一个文件选择框，它会生成 HTML 中的 <input type="file"/> 标签。

11）<s:hidden>标签
<s:hidden> 标签用于创建隐藏表单元素，它会生成 HTML 中的隐藏域标签 <input type="hidden"/>。

4 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>标签