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>