常用Struts 2标签用法【整理】

文章目录

1、s:if , s:elseif , s:else标签
2、s:iterator标签
3、merge标签和append标签
4、generator标签
5、sort标签
6、subset标签

1、s:if , s:elseif , s:else标签

Struts2 标签库中的 <s:if>、<s:elseif>、<s:else> 标签与 Java 中的 if、else if 和 else 语句功能类似，主要用于程序的分支逻辑控制。其中，只有 <s:if> 标签可以单独使用，而 <s:elseif>、<s:else> 都必须与 <s:if> 标签结合才能使用。其使用语法格式如下所示：

<s:if test="表达式1">
    标签体
</s:if>
<s:elseif test="表达式2">
    标签体
</s:elseif>
<s:else>
    标签体
</s:else>

2、s:iterator标签

<s:iterator>标签对集合进行迭代输出，可以指定三个属性：

①value：指定的就是被迭代的集合，该集合通常是使用 OGNL 表达式指定。如果没有指定该属性，则使用 ValueStack 栈顶的集合。

②var：等同 id 标签，但是不推荐使用。指定集合元素的当前对象

③status：该属性指定迭代时的 IteratorStatus 实例，通过该实例即可判断当前迭代元素的属性。该属性包含如下几种方法：

int getCount() : 返回当前迭代了几个元素。
int getIndex() : 返回当前迭代元素的索引。
boolean isEven() : 返回当前被迭代的元素的索引是否是偶数。
boolean isFirst() : 返回当前被迭代的元素的索引是否是第一个元素。
boolean isLast() : 返回当前被迭代的元素的索引是否是最后一个元素。
boolean isOdd() : 返回当前被迭代的元素的索引是否是技术。

<s:iterator> 标签主要用于对集合中的数据进行迭代，它可以根据条件遍历集合中的数据。<s:iterator> 标签的属性及相关说明如下表所示：

属性	是否必须	默认值	类型	描述
begin	否	0	Integer	迭代数组或集合的起始位置
end	否	数组或集合的长度大小减 1，若 Step 为负，则为 0。	Integer	迭代数组或集合的结束位置
status	否	false	Boolean	迭代过程中的状态
step	否	1	Integer	指定每一次迭代后索引增加的值
value	否	无	String	迭代的数组或集合对象
var	否	无	String	将生成的 Iterator 设置为 page 范围的属性
id	否	无	String	指定了集合元素的 id，现已用 var 代替

如果在 <s:iterator> 标签中指定 status 属性，就可以通过该属性获取迭代过程中的状态信息，如元素数、当前索引值等。通过 status 属性获取信息的方法如表 2 所示（假设其属性值为 st）

方法	说明
st.count	返回当前已经遍历的集合元素的个数
st.first	返回当前遍历元素是否为集合的第一个元素
st.last	返回当前遍历元素是否为集合的最后一个元素
st.index	返回遍历元素的当前索引值

示例：
在项目的 WebContent 下创建一个名称为 controlTags.jsp 文件，编辑后如下所示:

<%@ page language="java" contentType="text/html; charset=utf-8"
    pageEncoding="utf-8"%>
<%@taglib prefix="s" uri="/struts-tags" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>控制标签</title>
</head>
<body>
<center>
    <table border="1px" cellpadding="1">
        <s:iterator var="name" value="{'apple','orange','pear','banana'}" status="st">
            <s:if test="#st.odd">
                <tr style="background-color:white;">
                    <td><s:property value="name"/></td>
                </tr>
            </s:if>
            <s:else>
                <tr style="background-color:grey;">
                    <td><s:property value="name"/></td>
                </tr>
            </s:else>
        </s:iterator>
    </table>
</center>
</body>
</html>

上述代码中，首先引入了 Struts2 的标签库，然后在

标签内，使用 <s:iterator> 标签循环输出集合中的，并将通过该标签 status 属性的 odd 方法获取的值作为 <s:if> 和 <s:else> 标签的判断条件，对表格进行控制显示。

在这里插入图片描述

3、merge标签和append标签

演示1（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:iterator value="%{#newMergeList}">

<s:property />

</s:iterator>

演示2（append）
使用append标签合并两个param的集合，然后使用iterator标签遍历append中的内容

<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<%@ taglib uri="/struts-tags" prefix="s" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>

    <title>append.jsp</title>
  </head>

  <body>
        <s:append id="books">
        <s:param value="{'C语言程序设计','数据结构与算法','数据库系统概论'}"></s:param>
        <s:param value="{'Java语言程序设计','计算机组成原理','操作系统教程'}"></s:param>
        </s:append>

        <table border="1" cellspacing="0" >
        <s:iterator value="#books" status="st">
        <tr>
            <td> <s:property value="#st.count"/>
            <td> <s:property/>
        </tr>
        </s:iterator>

        </table>
  </body>
</html>

显示效果
在这里插入图片描述

4、generator标签

generator 标签可以将指定的字符串按照指定的分隔符分割成多个子字符串，然后可以使用 iterator 标签将临时生成的多个子字符串迭代输出。
语法：

<s:generator val="'Value'" separator=",">
  <s:iterator>
    <s:property/><br>
  </s:iterator>
</s:generator>

generator 标签各属性的详细介绍如表所示

属性	可选性	描述
id	可选	如果指定该属性，则将生成的集合放在pageContext属性中
count	可选	指定生成集合中元素的总数
val	必选	指定被分割的字符串
separator	必选	指定用于界定字符串的分隔符
converter	可选	指定一个转换器，该转换器负责将集合中的每个字符串转换成对象

示例
在页面中引用 Struts2 标签库的 generator 标签，并设定 separator 和 val 属性，指定被分割的字符串，关键代码如下：

<body>
  <h3>使用generator标签拆分一个字符串</h3>
  <s:generator val="'Java,C#,Javaweb'" separator=",">
    <s:iterator>
      <s:property/><br>
    </s:iterator>
  </s:generator>
  <h3>设置count的属性来确定迭代器中可用元素的数量</h3>
  <!--由于count属性设置为2，因此生成的迭代器中只有2个元素可用-->
  <s:generator separator="," val="'Java,C#,Javaweb'" count="2">
    <s:iterator>
      <s:property/><br>
    </s:iterator>
  </s:generator>
</body>

5、sort标签

sort标签对于指定的集合元素进行排序，排序时，必须提供自己的排序规则，即实现自己的Comparator，自己的Comparator需要实现java.util.Comparator接口。

使用sort标签时可指定如下几个属性：

comparator：必填属性，指定进行排序的Comparator实例。
source：可选属性，指定被排序的集合。默认对valuestack栈顶的集合进行排序。
var: 可选，如果指定了改属性，则生成Iterator对象设置成page范围的属性，该属性可以换成ID ，但推荐使用var属性；改属性的作用与subset标签中var属性作用不同！

6、subset标签

下面的代码subset.jsp截取了原集合从第二个元素（start=1）开始的三个元素（count=3）

<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<%@ taglib uri="/struts-tags" prefix="s" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <title>subset.jsp</title>
  </head>

  <body>
    <s:subset source="{'C++程序设计','VC++实用教程','SQL Server应用','C#程序设计','Java程序设计'}" start="1" count="3">
            <s:iterator>  
                <s:property/><br>
            </s:iterator> 
    </s:subset>
  </body>
</html>

显示效果如下：
在这里插入图片描述
例2
使用decider自定义截取方式
①.实现Decider接口

package org.common;

import org.apache.struts2.util.SubsetIteratorFilter.Decider;

public class SubsetTagDecider implements Decider{

    public boolean decide(Object arg0) throws Exception {
        //包含C的图书名称
        return arg0.toString().contains("C");
    }
}

②.应用subset标签的decider属性

<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<%@ taglib uri="/struts-tags" prefix="s" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <title>subset2.jsp</title>
  </head>

  <body>
    <s:bean name="org.common.SubsetTagDecider" id="subsetTagDecider"/>
    <s:subset source="{'C++程序设计','VC++实用教程','SQL Server应用','C#程序设计','Java程序设计'}" decider="subsetTagDecider">
            <s:iterator>  
                <s:property/><br>
            </s:iterator> 
    </s:subset>
  </body>
</html>