首页 > 代码库 > 关于Strut2内置Json插件的使用

关于Strut2内置Json插件的使用

配置注意点:

  • 在原有Struts2框架jar包的引入下,需要额外多加一个Json的插件包(struts2-json-plugin-2.3.7.jar
  • 在struts.xml配置文件中,包需要继承json-default,然后把result的类型改为json
  •  <package name="xxx" extends="json-default">
    <result name="success" type="json"></result>

 

一、先来个简单示例,利用Struts2+jQuery+JSON实现异步交互,返回一个字符串

1、index.jsp

很简单的一个页面,利用Ajax异步向test1.action发送一个post请求,传递了一个参数name,然后把回调函数返回的值显示在页面。

 1 <%@ page language="java" import="java.util.*" pageEncoding="utf-8"%> 2 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 3 <html> 4     <head> 5         <script type="text/javascript" src="${pageContext.request.contextPath}/js/jquery-1.4.4.min.js"></script> 6         <script type="text/javascript"> 7             $("document").ready(function(){ 8                 $.post("test1.action",{"name":"Balla_兔子"},function(data){ 9                     console.info(data);10                     $("#info").html(data.info);11                 });12             13             });14         </script>15     </head>16 17     <body>18         Hello,Struts2!<div id="info"></div>19     </body>20 </html>

2、TestAction.java

因为页面发送了一个参数名为name的参数,在这边我们用属性注入的方式,给成员变量一个setter方法赋值,返回提供了一个getter方法作为回调函数的返回值。

Struts2的Json插件,默认将值栈(root)的顶端对象返回(所有getter方法),在没有实现模型驱动类ModelDriven的前提下,值栈的顶端对象为Action(也就是返回Action里所有的getter方法,若有各别方法不想返回,只需要在该方法的上面添加一个@JSON(serialize=false)注解即可)

如:

@JSON(serialize=false)public String getAge() {    return "我今年10岁了";}

 

 1 package com.lcw.struts.json; 2  3 import com.opensymphony.xwork2.ActionSupport; 4  5 public class TestAction extends ActionSupport { 6  7     private String name;     8     private String info; 9     10     public String getInfo() {11         return "我是:"+name;12     }13 14     public void setName(String name) {15         this.name = name;16     }17 18     public String test1() {19         return "success";20 21     }22 }

struts.xml

 1 <?xml version="1.0" encoding="UTF-8" ?> 2 <!DOCTYPE struts PUBLIC 3     "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN" 4     "http://struts.apache.org/dtds/struts-2.3.dtd"> 5  6 <struts>     7         <constant name="struts.i18n.encoding" value="UTF-8"/> 8         <constant name="struts.devMode" value="true" /> 9         <package name="strutsjson" extends="json-default" namespace="/">10             <action name="test1" class="com.lcw.struts.json.TestAction">11                 <result name="success" type="json">/index.jsp</result>12             </action>13         </package>14 </struts>

 

下面是页面效果:(这里只是简单举例,也可以实现一些业务逻辑功能,比如验证用户的账号,可以在Action调用持久层的数据查询,返回布尔值,在回调函数里进行进一步操作)

二、下面来说下关于更为实用的实例,比如如何返回一个List集合,对象等复杂数据,在前台接受数据中,只能识别字符类型的信息,比如Xml,Json,Html字符等,是无法识别List集合的,那我们应该怎么做呢?

TestAction.java

这次在Action加入了模型驱动类,然后定义了一个User类并提供了setter和getter方法,把该对象添加到一个List集合里去,并提供getter方法以便返回数据。

 1 package com.lcw.struts.json; 2  3 import java.util.ArrayList; 4 import java.util.List; 5  6 import com.opensymphony.xwork2.ActionSupport; 7 import com.opensymphony.xwork2.ModelDriven; 8  9 public class TestAction extends ActionSupport implements ModelDriven<User> {10 11     private User user = new User();12 13     public User getModel() {14         return user;15     }16 17     private List<User> list;18 19     public List<User> getList() {20         return list;21     }22 23     public String test1(){24         list = new ArrayList<User>();25         User user = new User();26         list.add(new User("1", "张三"));27         list.add(new User("2", "李四"));28         return "success";29     }30 31 }

User.java

package com.lcw.struts.json;public class User {    private String id;    private String name;    public User() {    }    public User(String id, String name) {        super();        this.id = id;        this.name = name;    }    public String getId() {        return id;    }    public void setId(String id) {        this.id = id;    }    public String getName() {        return name;    }    public void setName(String name) {        this.name = name;    }}

保持配置文件不变,我们来看页面看看结果:

打开firebug调试查看,会发现

 为何传递过来的数据会为空呢?不知道大家是否留意上文提到的一句话

Struts2的Json插件,默认将值栈(root)的顶端对象返回(所有getter方法),在没有实现模型驱动类ModelDriven的前提下,值栈的顶端对象为Action(也就是返回Action里所有的getter方法

我们上面实现了模型驱动类,也就意味着值栈的栈顶对象此时也不再是Action了,而是Model,所以返回的数据为空。那要怎么办呢?其实很简单,只需要我们改变默认返回的战队对象就可以了,把它设置成Action。

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE struts PUBLIC    "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN"    "http://struts.apache.org/dtds/struts-2.3.dtd"><struts>            <constant name="struts.i18n.encoding" value="UTF-8"/>        <constant name="struts.devMode" value="true" />        <package name="strutsjson" extends="json-default" namespace="/">            <action name="test" class="com.lcw.struts.json.TestAction" method="test1">                <result name="success" type="json">                    <param name="root">action</param>                </result>            </action>        </package></struts>

只要在result里添加一个参数root并设置成action就可以了,我们来看下此时的效果:

这是我们就可以利用(data.list[x].name等)取出其中的数据了。

那我们可不可以不要一起把所有的数据都返回回来,只返回部分数据呢?除了之前说的那个Json注解(只要@JSON注解,属性将永远不能参与 json返回),其实Struts2为我们也提供一个更灵活的方法,在struts.xml的配置文件里,我们也是可以根据所需设置的,例如:

1 <param name="includeproperties">list\[\d+\]\.name</param>

includeProperties代表要包含的参数,值为正则表达式,因为返回的数据是一个list集合,名为list则 list[\d+].name(代表list下所有数组索引下的name属性) 上文的反斜杠是转义符号。(如果要返回模型驱动对象则是model[\d+])

下面是完整配置文件:

struts.xml

 1 <?xml version="1.0" encoding="UTF-8" ?> 2 <!DOCTYPE struts PUBLIC 3     "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN" 4     "http://struts.apache.org/dtds/struts-2.3.dtd"> 5  6 <struts>     7         <constant name="struts.i18n.encoding" value="UTF-8"/> 8         <constant name="struts.devMode" value="true" /> 9         <package name="strutsjson" extends="json-default" namespace="/">10             <action name="test" class="com.lcw.struts.json.TestAction" method="test1">11                 <result name="success" type="json">12                     <param name="root">action</param>13                     <param name="includeproperties">14                         list\[\d+\]\.name15                     </param>16                 </result>17             </action>18         </package>19 </struts>

 

再看下此时的页面数据返回:

这样,我们想要的数据就可以筛选出来了。