SpringMVC与前/后台的json数据交互

SpringMVC与前/后台的json数据交互：

json数据格式在接口调用中、html页面中比较常用，json格式比较简单，解析也比较方便，所以使用很普遍。在SpringMVC中，也支持对json数据的解析和转换，这篇文章主要总结一下在SpringMVC中如何和前台交互json数据。

两种交互形式

SpringMVC和前台交互主要有两种形式，如下图所示： 

可以看出，前台传过来的方式有两种，一种是传json格式的数据过来，另一种就是在url的末尾传普通的key/value串过来，针对这两种方式，在Controller类中会有不同的解析，但是在Controller类中返回的json格式的数据都是一样的。下面来具体分析一下SpringMVC是如何与前台进行json数据的交互的。在讲之前先认识两个注解。

@RequestBody注解

@RequestBody注解用于读取http请求的内容(字符串)，通过SpringMVC提供的HttpMessageConverter接口将读到的内容转换为json、xml等格式的数据并绑定到Controller类方法的参数上。 
本例子应用：@RequestBody注解实现接收http请求的json数据，将json数据转换为java对象。如下： 

@ResponseBody注解

@ResponseBody注解用于将Controller类的方法返回的对象，通过HttpMessageConverter接口转换为指定格式的数据如：json、xml等，通过Response响应给客户端。 
本例子应用：@ResponseBody注解实现将Controller类方法返回对象转换为json响应给客户端，如下： 

经过我如此细致地讲解，想必大家已认识到这两个注解的意思了。好了，下面来具体分析一下SpringMVC是如何与前台进行json数据的交互的。

环境的准备

加载json的jar包

SpringMVC默认用MappingJacksonHttpMessageConverter对json数据进行转换，需要加入jackson的包，又因为SpringMVC3和SpringMVC4针对json交互的jar包有区别，我用的是SpringMVC4，需要导入如下三个jar包： 
 
读者千万不要忘了导入jQuery的类库，因为我是使用jQuery的ajax提交json串的，就像下图这样： 

配置json转换器

配置json转换器有两种方式，如果是配置了注解适配器org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter的话，需要在该适配器中配置json转换器，如下：

1. <!-- 用于将对象转换为 JSON -->

2. <bean id="stringConverter" class="org.springframework.http.converter.StringHttpMessageConverter">

3. <property name="supportedMediaTypes">

4. <list>

5. <value>text/plain;charset=UTF-8</value>

6. </list>

7. </property>

8. </bean>

9. <bean id="jsonConverter" class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"></bean>

10.  

11. <bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter">

12. <property name="messageConverters">

13. <list>

14. <ref bean="stringConverter" />

15. <ref bean="jsonConverter" />

16. </list>

17. </property>

18. </bean>

但是如果使用<mvc:annotation-driven />注解驱动的话就不用以上的配置了，默认已经配好了。建议使用这种，比较方便。

json交互的测试

这里，我使用jQuery的ajax提交json串，对输出的json结果进行解析。前台的程序如下：

1. <button onclick="sendJson()">json数据交互测试</button>

2. <script type="text/javascript">

3. function sendJson() {

4. $.ajax({

5. type:"post",

6. url:"${pageContext.request.contextPath }/item/json_test.action",

7. data:'{"id":"1","name":"电冰箱","price":"1999"}',

8. contentType:"application/json;charset=utf-8",

9. success:function(data) {

10. alert(data.id + ":" + data.name);

11. }

12. });

13. }

14. </script>

那么前台itemList.jsp页面的内容就应改造为： 

接着编辑ItemController类，并在该类中编写如下方法：

1. // JSON数据交互

2. // @RequestBody：接收json数据并转换成pojo对象

3. // @ResponseBody：响应json数据，把pojo对象转换成json数据并响应

4. @RequestMapping("/json_test")

5. @ResponseBody

6. public Items jsonTest(@RequestBody Items items) {

7. return items;

8. }

由于前台传的是id、name和price三个属性，所以在后台就用Items类来接收了，这个类中也有这三个属性。重点是@RequestBody注解，它是将前台传过来的json串转换成items对象，然后再将该对象return回去，通过@ResponseBody注解将items对象转成json格式返回给前台。这样前台接收到了后就可以解析了。我们看一下测试的结果： 

 

 

响应的结果，null表示空值而已，这里就返回了原对象，也就只有id、name和price属性。 

springmvc与json数据的交互就总结到此。