struts2.1 Data Tags

1.a

创建 HTML 的 <a> 标签

 

2.action

action 标签 , 可以允 许 在 jsp 页 面中直接 调 用 Action, 在 调 用 Action 时 候 , 可以指定需要被 调 用的 Action 的 name 和 namespace. 如果指定了 executeResult 参数的属性 值为 true, 该标签 会把 Action 的 处 理 结 果 ( 视图资 源 ) 包含到本 页 面中 .

1. var :  可 选 属性 , 作 为该 Action 的引用
2. name: 必 选 属性 , 指定 调 用 Action   
3. namespace: 可 选 属性 , 指定 该标签调 用 Action 所属 namespace   
4. executeResult: 可 选 属性 , 指定是否将 Action 的 处 理 结 果包含到本 页 面中 . 默 认值为 false, 不包含 .   
5. ignoreContextParam: 可 选 参数 , 指定 该页 面的 请 求参数是否需要 传 入 调 用的 Action 中 , 默 认值 是 false, 即 传 入参数 .  
6. flush

 

3.bean

bean 标签 用于 创 建一个 JavaBean 实 例 . 在 标签 体内使用 <param../> 标签为该 JavaBean 实 例 传 入属性 , 该 javaBean 类 提供 对应 的 setter 方法和 getter 方法 .

 

name: 必 选 属性 , 指定要 实 例化的 JavaBean 实现类

var : 可 选 属性 , 若指定 该 属性 ,JavaBean 实 例会放入 StackContext 中 , 从而允 许 直接通 过 var 属性来 访问 JavaBean 实 例   

 

4.date

date 标签 用于格式化 输 出一个日期 , 除了可以直接格式化 输 出一个日期外 ,date 标签还 可以 计 算指定日期和当前 时 刻直接的 时 差 .

1. format:  可 选 属性 , 指定 该 属性 , 将根据 该 属性指定的各市来格式化日期 .   
2. nice:  可 选 属性 , 只能 为 ture 或者 false. 它用于指定是否 输 出指定日期和当前 时 刻之 间 的 时 差 , 默 认 是 false, 不 输 出 .   
3. name: 必填属性 , 指定格式化的日期 值   
4. var :  可 选 属性 , 指定 该 元素的   

注意 :nice 属性和 format 属性不能同 时 指定 , 即若指定 nice 为 ture, 则 暑促指定日期和当前 时 刻的 时 差 ,    但指定 format 则 用于将指定日期按 format 指定的格式 输 出 .  

若不指定 format, 则 默 认 采用 DateFormat.MEDIUM 格式 输 出 .

  若系 统 的全局国 际 化 资 源文件中指定了 format 格式 :

struts.date.format=yyyy 年 MM 月 dd 日  

 

5.debug

debug 标签 主要用于 辅 助 测试 ，它在 页 面上生成一个超 链 接，通 过该链 接可以 查 看 ValueStack 和 Stack Context 中的所有 值 信息 。

 

6.i18n

加 载资 源包到 值 堆 栈 。它可以允 许 text 标 志 访问 任何 资 源包的信息，而不只当前 action 相 关联 的 资 源包。

Value 必填属性 ， 资 源包的 类 路径

 

7.include

include 标签 用于将一个 JSP 页 面，或者一个 Servlet 包含到本 页 面

value  必填属性，指定要包含的 JSP 页 面，或者 Servlet   

 

8.param

param 标签 主要用于 为 其他 标签 提供参数，例如 bean 和 include 标签 。

1. name: 可 选 属性，指定 设 置参数名称   
2. value ：可 选 属性，指定参数的 值   

 

9.property

property 标签 作用就是 输 出指定 值 ， property 标签输 出 value 属性指定的 值 ，如果没有指定 value ， 则 默 认输 出 ValueStack 栈顶 的 值 。

1. default ：可 选 属性，如果需要 输 出的属性 值为 null ， 则显 示 default 属性指定的 值 。   
2. escape ：可 选 属性，指定是否 escape HTML 代 码   
3. value ：可 选 属性，指定需要 输 出的 值   

 

10.push

push 标签 用于将某个 值 放到 ValueStack 的 栈顶 ，从而可以更 简单 的 访问该值 。

value ：必填属性， 该 属性指定需要放到 ValueStack 栈顶 的 值   

 

11.set

set 标签 用于将某个 值 放入指定范 围 ，例如 application 范 围 、 session 范 围 。

   当某个 值 所在 对 象 图 深度非常深 时 候， 每 次 访问该值 不 仅 性能低下，而且代 码 可 读 性也差， 为 了避免 该问题 ，可以将 该值设 置成一个新 值 ，放入特定范 围 内。

1. name ：必填属性，重新生成 变 量的名字  
2. scope ：可 选 属性，指定新 变 量被放置的范 围 ，可接收 application 、 session 、 request 、 page 、或 aciton5 个 值 ，默 认 放置在 Stack Context 中。   
3. value ：   可 选 属性，指定将 赋给变 量的 值 ，如没指定 该 属性， 则 将 ValueStack 栈顶 的 值赋给变 量。
4. var ：可 选 属性， 该 元素的引用

 

12.text

支持国 际 化信息的 标签 。

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

name   必填属性， 资 源属性的名字

var   变量名

 

13.url

url 标签 用于生成一个 url 地址，可以通 过为 url 标签 指定 param 子元素，从而向指定 URL 发 送 请 求参数 。

1. includeParams ：可 选 属性，指定是否包含 请 求参数，属性 值 只能 为 ： none 、 get 、 all   
2. scheme ：可 选 属性，用于 设 置 scheme 属性   
3. action ：可 选 属性，指定生成 url 的地址 为 那个 Action ，如果 action 不提供，就用 value 作 为 url 的 值
4. value ：可 选 属性，指定生成 url 的地址 值 ，如果 value 不提供就用 action 属性指定的 action 作 为 url 地址。   
5. namespace ：可 选 属性，指定命名空 间  
6. method ：可 选 属性，指定使用 aciton 的方法
7. encode ：可 选 属性，指定是否需要 encode 请 求参数
8. includeContext ：可 选 属性，指定是否需要将当前上下文包含在 url 地址中   
9. anchor ：可 选 属性，指定 url 的 锚 点
10. var : 可 选 属性，指定 该 url 元素的引用