struts2数据标签

Data标签用来提供各种数据相关的功能.范围从显示一个action的直接结果,到获取本地化的数值等.

1. action
   通过指定命名空间和action名称,该标签允许你在jsp页面直接调用Action. 标签体用来渲染Action执行结果. 除非你设定了executeResult参数为true,否则你在xwork.xml中为该Action指定的Result Processor不会执行.
   名称必填缺省类型描述

   id	false		String	如果设定,将作为该Action在栈中的标识
   name	true		String	action名字(不包括后缀,如.action)
   namespace	false		String	action所在命名空间
   executeResult	false	false	Boolean	Action的result是否需要被执行
   ignoreContextParams	false	false	Boolean	request中的参数是否需要传入该Action

2. bean
   

   实例化一个符合JavaBeans规范的class,标签体内可以包含几个Param元素,用于调用setter方法给此class的属性赋值.如果是定了id属性,则该实例将会放到stack的context中.
   

   名称必填缺省类型描述

   name	true		String	要被实例化的class名字(必须符合JavaBeans规范)
   id	false		String/Object	标识该元素

3. debug
   
4. i18n
   将某个特定resource bundle放入value stack. 然后通过text标签拿到相应message, 而不是仅限于绑定到当前action的bundle.
   名称必填缺省类型描述

   name	true		String	要使用的resource bundle.(如 foo/bar/customBundle)
   id	false		String/Object	标识该元素

5. include
   包含servlet的输出(servlet或JSP页面)
   名称必填缺省类型描述

   value	true		String	包含的jsp或servlet
   id	false		Object/String	元素标识

   例子:
   <ww:include value="myJsp.jsp">
      <ww:param name="param1" value="value2" />
      <ww:param name="param2" value="value2" />
   </ww:include>
   
   
   
6. param
   

   为其他标签提供参数,比如include标签和bean标签.
   参数的name属性是可选的,如果提供,会调用Component的方法addParameter(String, Object),如果不提供,则外层嵌套标签必须实现UnnamedParametric接口(如TextTag).

   该标签的两个属性

   • name (String) - 参数名
   • value (Object) - 参数值
     

     注意 : value的提供有两种方式,通过value属性或者标签中间的text,不同之处我们看一下例子:

     <param name="color">blue</param> <-- (A) -->        <param name="color" value="blue"/> <-- (B) -->

     (A)中,参数值会以String的格式放入statck. (B)中该值会以java.lang.Object的格式放入statck.

7. push
   push值到堆栈中,方便应用.
   名称必填缺省类型描述

   value	true		Object/String	要push到堆栈中的值
   id	false		Object/String	该元素标识

   <ww:push value="user">
       <ww:propery value="firstName" />
       <ww:propery value="lastName" />
   </ww:push>
   
   将user的值push到栈中,从而使property标签的能够获取user的属性(firstName, lastName etc)
   
8. set
   set标签赋予变量一个特定范围内的值. 当希望给一个变量赋一个复杂的表达式,每次访问该变量而不是复杂的表达式时用到.其在两种情况下非常有用: 复杂的表达式很耗时 (性能提升) 或者很难理解 (代码可读性提高).
   名称必填缺省类型描述

   name	true		String	变量的名字
   scope	false	action	String	变量作用域,可以为application, session, request, page, 或action.
   value	false		Object/String	将会赋给变量的值
   id	false		Object/String	元素标识

9. <ww:set name="personName" value="person.name"/>
   Hello, <ww:property value="#personName"/>. How are you?
10. text
    

    支持国际化信息的标签

    国际化信息必须放在一个和当前action同名的resource bundle中,如果没有找到相应message,tag body将被当作默认message,如果没有tag body,message的name会被作为默认message
    

    名称必填缺省类型描述

    name	true		Object/String	资源属性的名字
    name	false		Object/String	该元素标识

11. url
    

    该标签用于创建url,可以通过"param"标签提供request参数.

    注意:
    当includeParams的值时'all'或者'get', param标签中定义的参数将有优先权,也就是说其会覆盖其他同名参数的值.
    

    名称必填缺省类型描述

    includeParams	false	get	Object/String	值为'none', 'get' 或'all'.
    scheme	false		Object/String	scheme属性
    value	false		Object/String	value如果不提供就用当前action
    action	false		Object/String	用来生成url的action,如果没有则使用value
    namespace	false		Object/String	命名空间
    method	false		Object/String	使用的action的方法
    encode	false	true	Boolean	是否encode参数
    includeContext	false	true	Boolean	是否实际的上下文环境应该包含在url中
    portletMode	false		Object/String	结果portlet 的模式(mode)
    windowState	false		Object/String	结果portlet窗口的状态
    portletUrlType	false		Object/String	指定这时一个 portlet 输出还是一个 action url
    anchor	false		Object/String	URL的锚点( anchor)
    id	false		Object/String	该元素标识

12. <ww:url value="editGadget.action">
        <ww:param name="id" value="%{selected}" />
    </ww:url>

13. property
    得到'value'的属性,如果value没提供,默认为堆栈顶端的元素.
    名称必填缺省类型描述

    default	false		String	如果属性是null则显示的default值
    escape	false	true	Boolean	是否escape HTML
    value	false	<top of stack>	Object	value to be displayed
    id	false		Object/String	该元素标识

    
    

    <ww:push value="myBean">    <!-- Example 1: -->    <ww:property value="myBeanProperty" />    <!-- Example 2: -->    <ww:property value="myBeanProperty" default="a default value" />    </ww:push>