共同的一点是,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:
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,我以为就是这个了,想当然认为会有这种写法:
- <action name="plainText" class="bookAction" method="plainText">
- <result type="plainText" />
- </action>
我以为会有这样一种用法,来简单地提供对ajax的支持,结果发现plainText和我想的根本就不是一个东西,这是不是struts2一个设计不足的地方呢?
注意:jsonplugin的插件,可以自动转换把服务器端的数据封装成json格式返回给客户端.但不能把客户端的数据自动转换成json格式。