1. 必需的库
struts2-json-plugin-2.1.8.1.jar
json-lib-2.1.jar
版本号可能会有所不同,而且这两个包也是MyEclipse在创建Struts2项目时自带并且已经包含的。
2. setter与getter
Action类中私有成员变量的setter和getter方法在Struts2框架下会被自动转化成HttpServletRequest对象的getParameter方法和setAttribute方法,也就是说setter方法的实质就是从request中取出名字与变量名相同的数据,并将其赋值给该变量;而getter方法就是将变量名与值分别作为key和value存入request对象的attribute中。
理解了这一点,显而易见,不需要反馈到View层的Action私有变量是没有必要设置它的getter方法的。这在JSON生成之中尤为重要,因为多余的getter方法会把私有变量的值传递到JSON之中。
3. Action类中JSON的生成机制
需要生成JSON的Action最好不要实现ModelDriven接口,其原因正如上所述,实现了ModelDriven接口的Action类必须实现getModel方法,其导致的结果就是生成的JSON数据中有一串名为“model”的数据。它可能会暴露一些并不需要客户端知道的数据,同时也会增加JSON数据的大小。
JSON数据在Action类中是根据getter方法的返回值自动装配的,也就是说完全可以不需要重写execute方法。JSON的生成机制(上述两个必需的包中提供的方法)会直接从setter方法获取到request中提供的值,并且自动装配getter方法提供的返回值。期间如果有其它的功能操作,如计算、查询数据库、重组数据等,可以写到getter方法中,也可以写到execute方法中统一执行。
这里需要注意的是execute方法的返回值字符串是无效的,可以随意设置,因为在后面的配置文件中并不会用到。
getter方法返回值的类型可以采用基本数据类型、String类、集合类(List、Map等)以及诸如Double、Integer等打包类。这些都不会影响JSON的生成,因为对于结果而言都是字符串类型的;而集合类在生成时会被自动迭代,因此生成的结果中其本身的集合类型(列表、映射表等)也不会改变。
因此在Action类可以将所有的结果数据保存到一个List或Map中在通过getter方法输出,也可以设置多个getter方法返回不同类型、不同变量的数据。这些数据在JSON中的名称与getter方法名中一致。
4. 配置文件的设定
与基本的Action相比,生成JSON的Action在配置文件struts.xml中主要有两点不同:
1. 不能与基本的Action配置在同一个package中,新的package必须扩展自(extends)json-default命名空间;
2. result标签中可以不包含name属性(因为没用),但是必须包含type属性,且值必须为“json”,即<result type=”json” ></result>,表明这是一个JSON数据,不需要跳转页面。
5. 示例
JsonAction类:
package com; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; import com.opensymphony.xwork2.ActionSupport; public class JsonAction extends ActionSupport { private static final long serialVersionUID = 4905130009784850861L; private String username; private String password; // private List<String> result; private Map<String, String> map; public void setUsername(String username) { this.username = username; } public void setPassword(String password) { this.password = password; } // public List<String> getResult() { // return this.result; // } public Map<String, String> getResult() { return map; } public String execute() { // result = new ArrayList<String>(); // result.add(username); // result.add(password); map = new HashMap<String, String>(); map.put("usr", username); map.put("pwd", password); map.put("logon", "true"); return SUCCESS; } }
struts.xml:
<?xml version="1.0"encoding="UTF-8" ?> <!DOCTYPE struts PUBLIC "-//ApacheSoftware Foundation//DTD Struts Configuration 2.1//EN" "http://struts.apache.org/dtds/struts-2.1.dtd"> <struts> <constant name="struts.devMode" value="true"></constant> <package name="json" extends="json-default"> <action name="loginJson"class="com.JsonAction"> <result type="json"></result> </action> </package> </struts>
结果: