Struts2标签

一. Struts2标签概述

Struts2把所有的标签都定义在URI为”/struts-tag”的命名空间下。

Struts2标签分类如下：

(1) UI标签：生成HTML元素的标签。

    表单标签：主要用于生成HTML页面的表单元素的标签。

    非表单标签：主要用于生成页面上的tree，Tab页等标签。

(2) 非UI标签：数据访问和逻辑控制等标签。

    流程控制标签：主要包含用于实现分支，循环等流程控制的标签。

    数据访问标签：主要包含用于输出ValueStack中的值，完成国际化等功能的标签。

(3) Ajax标签：用于Ajax支持的标签。（该标签不常用，因为最常使用的是Ajax框架。）

 

 

二. 使用Struts2标签库的准备

可以在struts2-core-2.0.11.jar压缩文件的META-INF目录下找到struts-tags.tld文件，该文件里定义了Struts2的标签。

要在jsp中使用Struts2的标志，先要指明标志的引入。通过jsp的代码的顶部加入以下的代码：

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

 

 

 

三. Struts2标签语法

Struts2的标签都支持动态数据的访问，标签的属性都可以使用OGNL表达式，struts2标签的属性具有类型，这些类型可以简单地分为字符串类型和非字符串类型。

 

(1) 对于字符串类型的属性，如果要访问动态数据，需要使用%{…}这样的语法。

例如：<s:include value="%{url}" />

Include标签的value属性是字符串类型，Struts2将对这个属性进行解析，查找符合%{…}样式的字符串，然后将花括号之间的内容作为OGNL表达式进行求值。如果属性中没有%{…}样式的字符串，那么属性的值将被直接看成是字符串数据。

例如：<s:include value="urlTag.action" />

 

(2) 对于非字符串类型的属性，将作为OGNL表达式进行求值。

例如：<s:property value="username"/>

说明：property标签的value属性是Object类型，username将作为OGNL表达式进行求值，即取得值栈栈顶的对象的username。

 

如果要为非字符串类型的属性直接指定字符串数据，那么需要使用OGNL中的字符串常量，即用单引号（'）或双引号（"）将字符串括起来。

例如：<s:property value="'zhangsan'"/>

value属性的值’zhangsan’作为字符串常量，计算结果就是zhangsan，因此输出zhangsan。

 

(3) 除上述用法之外，可以使用%{…}这样的语法来指定字符串常量。

例如：<s:property value="%{'zhangsan' }"/>

在这种情况下，%{ }将被忽略，花括号中的内容将作为表达式被计算。

 

总结一下，struts2标签的属性按照下列的三个规则进行计算。

a. 所有的字符串属性类型都会解析“%{…}”这样的语法。

b. 所有的非字符属性类型都不会被解析，而是直接被看作一个OGNL表达式进行求值

c. 对于第二个规则的例外情况是，如果非字符串属性使用了“%{…}”语法，那么%{…}将被忽略，花括号中的内容将作为表达式计算。

 

如果使用标签时， 忘记了某个属性是字符串类型，还是非字符串类型，那么有一个简单的方法，那就是不考虑它是什么类型，统一使用“%{…}”语法。

 

 

 

四. Struts2通用标签

参考链接 http://struts.apache.org/2.x/docs/struts-tags.html  

说明：官方文档可能有写地方是错误的。关键是自己的理解和实验。

 

Struts2中通用标签可以分为二类：数据标签和控制标签。控制标签用于呈现页面时控制执行流程，数据标签用于访问值栈中的数据。

 

数据标签：用于访问ActionContext和值栈中的数据。数据标签包括：

property   set   push          param      bean         action       include    

url    a       i18n text  date debug

 

控制标签：用于在呈现结果页面时控制程序的执行流程，根据程序执行的状态输出不同的结果，控制标签包括下列标签：

if/elseif/else           iterator         append         merge

generator               subset sort          

 

 

1. property标签

property标签用于输出指定值。使用value属性来指定要输出的对象属性，如果没有指定value属性，那么默认输出值栈栈顶对象。 

property标签的属性

default ：String类型。如果value属性是null，则使用default值.

Escape ：Boolean类型。是否转义输出内容中的HTML，例如，当该属性的值为true时，.&将被转移为&amp;

value ：Object类型。进行求值的表达式。默认为栈顶对象。

例：<s:property value=”usename” default=”游客” />

 

 

2. set标签   http://struts.apache.org/2.x/docs/set.html

set标签用于将值赋给指定范围内的变量。即将对象放入值栈中指定的范围中去。使用set标签常用于在循环或其他情况下更换名称。

name ：2.1废弃。

val ：String类型。新变量的名字。

value ：Object类型。指定一个表达式，计算的结果赋给变量。默认为栈顶对象。

scope ：String类型。变量的范围，可选的值为application、session、request、page、action。默认为action。

说明：

set标签以name属性的值作为键(key)，将value属性的值保存到指定的范围对象中。scope属性取值中的page，request，session，application同JSP4种范围，如果指定action范围(默认值)，value属性的值将被同时保存到request范围和OgnlContext中。

 

 

3. include标签

include标签的属性

 

在jsp2.jsp中，我们使用JSP的EL表达式来获取传的请求参数。注意：在include标签内部使用param标签向被包含的页面传递的请求参数，不能使用如下的property标签来访问：<s:property value=“#parameters.username” />

 

#parameters引用的实质是一个Map对象，并不等同于HttpServletRequest对象。

 

在包含页面时，如果页面中有中文，将会出现乱码，要解决这个问题，可以在struts.xml文件中配置struts.i18n.encoding属性，如下：

<constant name=“struts.i18n.encoding” value=“gbk” />

 

访问路径：http://localhost:8080/.../includeTag.jsp

 

 

 

4. date标签

date标签用于格式化输出日期值，也可用于输出当前日期值与指定日期值之间的时差

date标签的属性

 

注意：

1、format属性用于指定日期的格式化样式，具体的样式规则可以参看java.text.SimpleDateFormat类的API文档。

2、将nice属性设为true，可以输出指定日期值和当前日期值之间的时差，此时format属性失效，也就是说，当nice属性为true时，即使你指定了format属性，它也不会起作用

3、如果没有使用nice属性，也没有指定format属性，那么date标签将会在国际化资源包中查找struts.date.format键，并以这个键的值作为日期的格式化样式；如果这个键不存在，那么默认将会使用DateFormat.MEDIUM格式化样式。

4、如果找不到name属性指定的Date对象，那么将返回空。

 

date标签示例

第一步

在ApplicationResources.properties文件中添加struts.date.format键

struts.date.format=yyyy/MM/dd hh:mm:ss

 

第二步

可以使用struts2的struts.custom.i18n.resources属性来设置默认的资源包，编辑struts.xml文件，使用constant元素来配置struts.custom.i18n.resources属性，内容如下

<constant name=“struts.custom.i18n.resources” value=“ApplicationResources”/>

 

 

 

 

控制标签

if/elseif/else 标签

分支控制

格式：

<s:if test=”表达式”>

    标签体

</s:if>

<s:elseif test=”表达式”>

    标签体

</s:elseif>

……其他<s:elseif>标签……

<s:else>

    标签体

</s:else>

 

 

 

 

 

 

 

 

 

iterator标签

主要用于对集合进行遍历。

<s:iterator…/>标签对集合进行遍历输出时.可以指定如下3个属性.

 

 

IteratorStauts实例包含方法

int getCount():返回当前迭代过元素的总数。

int getIndex():返回当前迭代元素的索引。

boolean isEven():判断当前迭元素是否为偶数。

boolean isOdd():判断当前迭元素是否为奇数。

boolean isFirst():判断当前迭元素是否为第一个元素。

boolean isLast():判断当前迭元素是否为最后一个元素

 

IteratorStauts的这些方法分别对应了count,index,even,odd,first,last属性

 

控制标签----- iterator标签示例

 

 

控制标签----- iterator（迭代标签）举例

<s:iterator value ="{'第一个元素','第二个元素'}" >

  <p>day is: <s:property/></p>

</s:iterator>

 

private List myList;

private Map myMap;

public String execute() throws Exception {

myList = new ArrayList();

myList.add("第一个元素");

myList.add("第二个元素");

myList.add("第三个元素");

myMap = new HashMap();

myMap.put("key1", "第一个元素");

myMap.put("key2", "第二个元素");

myMap.put("key3", "第三个元素");

return SUCCESS;

}

 省略生成setter/getter方法

 

<table>

                   <s:iterator value="{'第一个元素','第二个元素'}" status="st">

                   <tr>

                   <td><s:property value="#st.getIndex()" /></td>

                            <td><s:property /></td>

                   </tr>

                            </s:iterator>

         </table>

 

                   <h2>显示List属性</h2>

                   <table>

                 <s:iterator value="myList" status="st">

                            <tr>

                                     <td><s:property value="#st.getIndex()" /></td>

                                     <td><s:property /></td>

                            </tr>

                        </s:iterator>

                   </table>

<h2>显示Map</h2>

         <table>

                   <s:iterator value="#{'key1':'第一个元素','key2':'第二个元素'}" status="st">

                          <tr>

                            <td><s:property value="#st.getIndex()" /></td>

                            <td><s:property /></td>

                          </tr>

                   </s:iterator>

         </table>

 

                   <h2>显示Map属性</h2>

         <table>

                   <s:iterator value="myMap" status="st">

                         <tr>

                            <td><s:property value="#st.getIndex()" /></td>

                            <td><s:property /></td>

                        </tr>

                   </s:iterator>

         </table>

 

 

 

select标签

select标签输出一个HTML列表框，等价于HTML代码：

 

select标签示例

示例一：

<s:form>

                   <s:select label=“最高学历” name=“education”  list=“{‘高中’，‘大学’，‘硕士’}”  />

</s:form>

在select标签的list属性中直接使用OGNL表达式创建了一个列表，列表中的每一项都将作为HTML列表框的一个选项。

 

示例二：

<s:form>

                   <s:select label=“最高学历” name=“education”  list=“#{1:‘高中’，2:‘大学’，3:‘硕士’}”  />

</s:form>

在select标签的list属性中直接使用OGNL表达式创建了一个Map。在这里要注意的是，Map的key是作为列表框选项的值，而Map中的value是作为列表框选项的内容。

 

示例三：

<s:form>

                   <s:select label=“最高学历” name=“education” list=“{‘高中’，‘大学’，‘硕士’}”  headerKey=“-1”   headerValue=“请选择你的学历”  />

Header选项主要用来越提示作用，因此应该将header选项的值(通过headerKey属性设置)设为无意义的值，例如此处的-1.

 

示例四：

<s:form>

                   <s:select label=“最高学历” name=“education” list=“{‘高中’，‘大学’，‘硕士’}”  headerKey=“-1”   headerValue=“请选择你的学历”   emptyOption=“true”  multiple=“true” / >

         使用emptyOption属性在header选项后添加一个空的选项。

         multiple属性设为false，则只能从下拉列表中选择一个选项，如果设为true，则可以多选。