struts2标签库----数据标签详解
struts2标签库----数据标签详解
上篇文章我们介绍struts2标签库中的控制标签的基本使用和部分原理，本篇文章接着了解下标签库中有关数据标签的使用和原理。主要涉及以下数据标签：
- action标签：用于在视图页面跳转到一个Action
- bean标签：用于创建一个Javabean实例，按需保存到context中
- date标签：用于格式化输出一个日期
- debug标签：用于调试查看ognl上下文中内容
- include标签：用于包含其他的jsp或者servlet页面资源
- param标签：主要配合别的标签作为子标签使用
- push标签：用于将某个值放入到root栈顶
- set标签：设置一个新变量，放入指定范围
- url标签：用于生成一个URL地址
数据标签主要是用于提供各种数据访问相关的功能，生成输出国际化信息等。上述所列举的主要是一些常用的，给我们提供较大方便的标签，具体的每个标签的使用和简单的原理会在下文介绍。
一、action标签 该标签用于向指定的action发出请求，拉取该action对应的视图页面资源。它主要有以下几个属性：
- var：该属性指定放入当前action到context中的名称，如果没有指定该属性则不会保存该action到context中
- name：该属性指定了需要调用的action的名称
- namespace：该属性指定该action的命名空间
- executeResult：该属性指定了该action最后的视图页面是否要被包含到本页面
- ignoreContextParams：它指定了本页面的请求参数是否要转发到该action页面
下面通过几个示例了解下具体的使用情况：
//定义一个将要被转向的action
public class MyAction implements Action {
public String execute() throws Exception{
return ERROR;
}
} <body>
<h1>this is the index page</h1>
<s:action name="my" executeResult="true"/>
<br/>
<s:debug/>
</body>上面的action标签向名称为my的action转发请求并指定需要将该action加载的视图资源返回，运行截图如下：
下面我们修改MyAction：
public class MyAction implements Action {
private String username;
public void setUsername(String name){
this.username = name;
}
public String getUsername(){
return this.username;
}
public String execute() throws Exception{
ActionContext.getContext().put("hello",username);
return ERROR;
}
} <body>
<h1>this is the index page</h1>
<s:action name="my" executeResult="true" ignoreContextParams="false"/>
<br/>
<s:debug/>
</body>如上述代码所示，我们在myAction中定义了一个username属性，然后直接将它put到context中，最后在error页面获取该值并打印。结果如下：
首先我们是在login.jsp页面（该页面未给出，只有简单的一个文本框）提交了一个请求参数到我们的index页面，在index页面中，我们使用action标签转发请求，其中指定该action标签中ignoreContextParams为false表示在被请求的action中会传入当前index页面的请求参数。最后我们在MyAction中自动获取到了该参数然后交给error页面输出。该例主要演示ignoreContextParams属性可以控制是否转发请求参数的作用。
二、bean标签 bean标签主要用来创建一个Javabean的实例，其中又可以使用param标签为该Javabean实例传递属性值。该标签主要有以下两个属性：
- name：该属性指定了将要被创建实例的Javabean的类名
- var：指定了该属性将会把该实例保存到context中和pageScope中
我们看一个例子：
//定义一个Javabean
public class Walker {
private String username;
private int age;
public void setUsername(String name){
this.username =name;
}
public String getUsername(){
return this.username;
}
public void setAge(int age){
this.age = age;
}
public int getAge(){
return this.age;
}
}<body>
<h1>this is the index page</h1>
<s:bean name="MyPackage.Walker" var="walker">
<s:param name="username" value="'walker'"/>
<s:param name="age" value="22"/>
</s:bean>
<s:property value="#walker.username"/>
<br/>
<s:property value="#walker.age"/>
<s:debug/>
</body>输出结果如下：
上述代码实例化了一个Javabean实例，并将它保存到context中，接着我们输出该内容，需要注意的是param元素中value属性依然是ognl表达式，想要赋值字符串需要单引号。
三、date标签 date标签用于格式化输出一个日期，或者输出当前时刻与指定时间之间的时间差。该标签主要有以下几个属性：
- format：该属性的值为一个格式字符串，它用于为指定日期提供输出格式
- nice：该属性用于指定是否需要输出当前时刻与指定时刻之间的时间差
- name：该属性接受的是一个具体的时间
- var：指定了该属性会将该日期保存到context和pageScope中
需要注意的是，该标签要么输出的是指定了格式的日期，要么输出的是具体的时间差。也就是如果指定nice属性为true，则不应该指定format属性，因为nice属性已经指定了该标签将输出一个时间差格式，如果强行指定format属性，该属性的值将会无效。下面我们看几个例子：
<body>
<h1>this is the index page</h1>
<s:bean name="java.util.Date" var="date"/><br/>
<s:date name="#date"/><br/>
<s:date name="#date" format="dd/MM/yyyy"/><br/>
<%
Date date = new Date(123123);
request.setAttribute("date",date);
%>
<s:date name="#request.date" nice="true"/>
<br/>
<s:debug/>
</body>运行结果如下：
第一种情况，如果既没有指定format属性，也没有指定nice值，那么会使用默认的format格式输出。第二种情况按照指定的格式输出。第三种情况输出为指定时间距离当前时间的时间差。
四、debug标签 该标签主要用于调试，查看ValueStack中的各个参数的实际值的情况。
五、include标签 include标签主要用于将一个jsp页面或者servlet页面包含到本页面来。该标签只有一个属性value，该属性指定了需要包含的资源位置。我们看几个例子：
<body>
<h1>this is the index page</h1>
<s:include value="error.jsp"/>
<br/>
<s:debug/>
</body>结果如下：
我们查看源码：
该标签很是类似于jsp的编译指令include。当然我们也可以通过param标签传入参数到被包含的页面中。例如：
<s:include value="error.jsp">
<s:param name="a" value="'walker'"/>
<s:param name="b" value="'yam'"/>
<s:param name="c" value="'cyy'"/>
</s:include>
六、push标签 push用于将某个值放到root栈顶，其中有个属性value表示即将被放入栈顶的元素。下面看个例子：
<body>
<h1>this is the index page</h1>
<s:bean name="MyPackage.Walker" var="w">
<s:param name="username" value="'walker'"/>
<s:param name="age" value="23"/>
</s:bean>
<s:push value="#w">
<s:property value="username"/><br/>
<s:property value="age"/>
</s:push>
<p>离开push标签之后</p>
<s:property value="username"/>
<br/>
<s:debug/>
</body>首先我们实例化一个walker类实例并保存到context中，接着我们在push标签中直接访问栈顶元素获取该实例的属性值。但是我们离开push标签之后就不能获取该实例的属性值了，因为push标签结束之后会将刚刚放入root栈中的元素移除。也就是说我们如果想要把一个元素送入root栈来方便访问，那么就必须在push标签内部完成访问操作。下面是上述代码的结果截图：
七、set标签 set标签用于将某个值放入到指定的范围内，可以理解为定义一个新变量并将它放入到指定范围内。该标签主要有以下几个属性：
- scope：指定该变量将会被存放到的范围，可以是application，session，request，page，action这5个值。
- name：该属性指定了该元素保存的指定范围内的key值
- value：该属性指定了将要被存放的实例的值
- var：该属性指定了将要存放到context中的元素名称
下面通过几个实例了解下基本的使用情况：
<body>
<h1>this is the index page</h1>
<s:bean name="MyPackage.Walker" var="w">
<s:param name="username" value="'walker'"/>
<s:param name="age" value="23"/>
</s:bean>
<s:set value="#w" name="a" scope="request"/>
<s:property value="#request.a.username"/>
<br/>
<s:debug/>
</body>首先我们实例化了一个walker对象，然后我们将该实例保存到request范围内，最后通过property标签取出该数据内容。运行截图如下：
上述代码演示的是通过set标签将元素保存到request范围内，至于其他范围内的数据保存情况类似，此处不再赘述。需要注意一点的是：如果指定将元素保存到action范围的话，那么该元素不仅会被保存到request中，还会保存到context中。
八、url标签 url标签用于生成一个URL地址，该标签主要有以下几个属性值：
- action：指定生成的URL地址为某个action
- anchor：指定了URL的锚点
- encode：指定了是否需要对参数进行编码
- includeContext：指定是否需要将当前上下文包含到该URL中
- includeParams：该属性用于指定是否包含请求参数在URL中，该属性的值有以下几个，none，all，get。
- method：该属性指定了调用目的action的某个方法
- namespace：指定了action的命名空间
- portletMode：指定结果页面的portlet模式
- scheme：用于设置scheme属性
- value：用于指定生成的URL的值，和action是差不多的，只是action指定的是action的URL
- var：指定该属性会将该URL保存到context中
- windowState：指定结果页面的portlet窗口状态
上面简单介绍各个属性的作用，单总结的很是粗暴。下面通过具体的实例来深刻理解下它们各自的作用。
<body>
<h1>this is the index page</h1>
<s:url value="my" var="u" escapeAmp="false">
<s:param name="id" value="01"/>
<s:param name="age" value="22"/>
</s:url>
<s:property value="#u"/>
<br/>
<s:debug/>
</body>生成URL：my?id=1&age=22 如上所示，我们指定escapeAmp为false表示用于连接多个参数的&符号不会被编码，我们通过param子标签传入参数作为URL的参数，最后生成完整URL。至于一些其他的属性值，只有在具体项目使用中才能有更加深刻的体会，此处没有比较好的例子，就不赘述了。
有关于struts2标签库的数据标签已经简单介绍完了，由于没有结合具体的项目，所以介绍的很浅显，不当之处，望指出！