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标签库的数据标签已经简单介绍完了,由于没有结合具体的项目,所以介绍的很浅显,不当之处,望指出!