日期:2014-05-16  浏览次数:20776 次

基于struts2实现ajax的2种标准方法
基于struts2,有2种标准方法实现ajax

共同的一点是,Action都需要将一个方法暴露出来,给前端javascript调用

javascript的代码都是一样的:
function testAjax() {

	var $userNameInput = $("#ajax_username");
	var userName = $userNameInput.val();

	$.ajax({
		url : "originAjax.action",
		type : "GET",
		data : "ajaxField=" + userName,
		success : function(data, textStatus) {
			alert(data);
		}
	});
}

这里originAjax.action,就是暴露出来供调用的地址

下面分别介绍服务端的两种写法

第一种是原生的写法,不需要依赖插件,也没有自行解析和拼装json串的功能

Action:
public void originAjax() throws IOException {
		HttpServletResponse response = ServletActionContext.getResponse();
		PrintWriter writer = response.getWriter();
		writer.print("hello " + ajaxField);
		writer.flush();
		writer.close();
	}

struts.xml:
<action name="originAjax" class="bookAction" method="originAjax" />

以上可以看到,写法是比较麻烦的。需要在Action里通过ServletActionContext的静态方法,获取到PrintWriter,然后直接写入响应

这里的originAjax()方法的返回值类型是void,然后在struts.xml里,不需要配置<result>元素

这种写法主要有2个缺陷,首先是与Servlet组件耦合,这在struts2应用里是不推荐的做法。其次是这个Action没有办法自动从请求中将json串解析为java的域,同样,如果需要将json串写入响应的话,也需要自行编码

另一个办法,是使用struts2-json-plugin,将jar包拷贝入WEB-INF/lib就可以了
Action:
public String pluginAjax() {
		ajaxField = "hello " + ajaxField;
		return SUCCESS;
	}

struts.xml:
<package name="bookManage" extends="json-default" namespace="/book">
	
		<action name="pluginAjax" class="bookAction" method="pluginAjax">
			<result type="json">
				<param name="excludeNullProperties">true</param>
			</result>
		</action>
		
	</package>

以上可以看到,Action里的写法变得非常简单,不过要注意的是,这个方法的返回值必须是String,而不是void

在struts.xml中的配置,包要继承自json-default,然后resultType是json。这里还附加了一个参数excludeNullProperties,目的是不序列化Action里为null的字段。<result>元素没有name属性,也没有跳转值

这里面其实还有一些规则,比如说没有getter方法的字段不会被序列化,注解为@Transient的字段不会被序列化等,另外param也不止excludeNullProperties一种。本文就不详细介绍了,可以看另外一篇博客:http://unmi.cc/struts2-json-plugin-guide,或者直接看官方的文档

此外,因为这种响应ajax请求的方法,是需要放在json-default包里的,而一般的方法,只需要放在struts-default包里。但是由于业务组织的原因,很可能一个Action里,有些方法是响应ajax请求的方法,另一些方法是响应普通请求的方法。

那么这种情况下,有一种方式,是将一个Action里的不同方法,放到不同的package里,不过这样好不好我还没有结论。另外一种方式,我感觉可以把所有的package都声明成extends json-default,经过试验,对普通的方法倒是没有造成影响,不过就是不知道会不会有什么隐藏的问题

最后补充一点,json和ajax不是一回事。ajax只是一种异步请求的机制,刚才的pluginAjax.action和originAjax.action,同样是可以响应普通的请求的



这样访问也没什么不可以,只是不太实用,相当于把Action当做加强版的Servlet来用了

json只是一种数据格式,在同步请求中用json来交换数据,也是一种很常见的做法,并不一定用在ajax里

所以struts2-json-plugin作为一个插件,是补充了struts2不能原生支持json的不足,将json格式作为数据交换的格式,这个设计是很合理的。

但是struts2自身对ajax的支持就太不好了,比如我想在Action的一个方法里,直接输出一段普通文本来响应ajax请求,居然还要通过HttpServletResponse来做。我开始还不相信,在struts-default.xml里找到一个resultType,叫plainText,我以为就是这个了,想当然认为会有这种写法:
public String plainText() {
		return "my reponse for ajax";
	}

<action name="plainText" class="bookAction" method="plainText">
	<result type="plainText" />
</action>

我以为会有这样一种用法,来简单地提供对ajax的支持,结果发现plainText和我想的根本就不是一个东西,这是不是struts2一个设计不足的地方呢?