struts2标签库----数据标签详解

2018-01-04 17:35:09 浏览数 (1)

     上篇文章我们介绍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页面

下面通过几个示例了解下具体的使用情况:

代码语言:javascript复制
//定义一个将要被转向的action
public class MyAction implements Action {
    public String execute() throws Exception{
        return ERROR;
    }
}
代码语言:javascript复制
  <body>
    <h1>this is the index page</h1>
    <s:action name="my" executeResult="true"/>
    <br/>

    <s:debug/>
  </body>

上面的action标签向名称为my的action转发请求并指定需要将该action加载的视图资源返回,运行截图如下:

下面我们修改MyAction:

代码语言:javascript复制
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;
    }
}
代码语言:javascript复制
  <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中

我们看一个例子:

代码语言:javascript复制
//定义一个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;
    }
}
代码语言:javascript复制
<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属性,该属性的值将会无效。下面我们看几个例子:

代码语言:javascript复制
    <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,该属性指定了需要包含的资源位置。我们看几个例子:

代码语言:javascript复制
  <body>
    <h1>this is the index page</h1>

    <s:include value="error.jsp"/>

    <br/>
    <s:debug/>
  </body>

结果如下:

我们查看源码:

该标签很是类似于jsp的编译指令include。当然我们也可以通过param标签传入参数到被包含的页面中。例如:

代码语言:javascript复制
    <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表示即将被放入栈顶的元素。下面看个例子:

代码语言:javascript复制
  <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中的元素名称

下面通过几个实例了解下基本的使用情况:

代码语言:javascript复制
  <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窗口状态

上面简单介绍各个属性的作用,单总结的很是粗暴。下面通过具体的实例来深刻理解下它们各自的作用。

代码语言:javascript复制
  <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>
代码语言:javascript复制
生成URL:my?id=1&age=22 

如上所示,我们指定escapeAmp为false表示用于连接多个参数的&符号不会被编码,我们通过param子标签传入参数作为URL的参数,最后生成完整URL。至于一些其他的属性值,只有在具体项目使用中才能有更加深刻的体会,此处没有比较好的例子,就不赘述了。

有关于struts2标签库的数据标签已经简单介绍完了,由于没有结合具体的项目,所以介绍的很浅显,不当之处,望指出!

0 人点赞