Spring 注解学习手札（七） 补遗——@ResponseBody，@RequestBody，@PathVariable(转)

最近需要做些接口服务，服务协议定为JSON，为了整合在Spring中，一开始确实费了很大的劲，经朋友提醒才发现，SpringMVC已经强悍到如此地步，佩服！ 

相关参考： 
Spring 注解学习手札（一）
构建简单Web应用 
Spring
注解学习手札（二） 控制层梳理 
Spring 注解学习手札（三） 表单页面处理 
Spring 注解学习手札（四） 持久层浅析 
Spring 注解学习手札（五） 业务层事务处理 
Spring 注解学习手札（六） 测试 
Spring 注解学习手札（七）
补遗——@ResponseBody，@RequestBody，@PathVariable 
Spring 注解学习手札（八）
补遗——@ExceptionHandler 


SpringMVC层跟JSon结合，几乎不需要做什么配置，代码实现也相当简洁。再也不用为了组装协议而劳烦辛苦了！ 

一、Spring注解@ResponseBody，@RequestBody和HttpMessageConverter 

Spring
3.X系列增加了新注解@ResponseBody，@RequestBody 

• @RequestBody 将HTTP请求正文转换为适合的HttpMessageConverter对象。


• @ResponseBody 将内容或对象作为 HTTP
  响应正文返回，并调用适合HttpMessageConverter的Adapter转换对象，写入输出流。

引用

ByteArrayHttpMessageConverter 
StringHttpMessageConverter 
ResourceHttpMessageConverter 
SourceHttpMessageConverter 
XmlAwareFormHttpMessageConverter 
Jaxb2RootElementHttpMessageConverter 
MappingJacksonHttpMessageConverter

可以理解为，只要有对应协议的解析器，你就可以通过几行配置，几个注解完成协议——对象的转换工作！ 

PS:Spring默认的json协议解析由Jackson完成。 

二、servlet.xml配置 

Spring的配置文件，简洁到了极致，对于当前这个需求只需要三行核心配置：

Xml代码  

1. <context:component-scan base-package="org.zlex.json.controller" />


2. <context:annotation-config />


3. <mvc:annotation-driven />

Xml代码  

1. <dependency>


2. <groupId>org.springframework</groupId>


3. <artifactId>spring-webmvc</artifactId>


4. <version>3.1.2.RELEASE</version>


5. <type>jar</type>


6. <scope>compile</scope>


7. </dependency>


8. <dependency>


9. <groupId>org.codehaus.jackson</groupId>


10. <artifactId>jackson-mapper-asl</artifactId>


11. <version>1.9.8</version>


12. <type>jar</type>


13. <scope>compile</scope>


14. </dependency>


15. <dependency>


16. <groupId>log4j</groupId>


17. <artifactId>log4j</artifactId>


18. <version>1.2.17</version>


19. <scope>compile</scope>


20. </dependency>

Java代码  

1. public class Person implements Serializable {
2. private int id;


3. private String name;


4. private boolean status;
5. public Person() {


6. // do nothing


7. }


8. }

Java代码  

1. @Controller


2. public class PersonController {
3. /**


4. * 查询个人信息


5. *


6. * @param id


7. * @return


8. */


9. @RequestMapping(value = "/person/profile/{id}/{name}/{status}", method = RequestMethod.GET)


10. public @ResponseBody


11. Person porfile(@PathVariable int id, @PathVariable String name,


12. @PathVariable boolean status) {


13. return new Person(id, name, status);


14. }
15. /**


16. * 登录


17. *


18. * @param person


19. * @return


20. */


21. @RequestMapping(value = "/person/login", method = RequestMethod.POST)


22. public @ResponseBody


23. Person login(@RequestBody Person person) {


24. return person;


25. }


26. }

Java代码  

1. @RequestMapping(value = "/person/profile/{id}", method = RequestMethod.GET)


2. public @ResponseBody


3. Person porfile(@PathVariable("id") int uid) {


4. return new Person(uid, name, status);


5. }

• GET模式下，这里使用了@PathVariable绑定输入参数，非常适合Restful风格。因为隐藏了参数与路径的关系，可以提升网站的安全性，静态化页面，降低恶意攻击风险。


• POST模式下，使用@RequestBody绑定请求对象，Spring会帮你进行协议转换，将Json、Xml协议转换成你需要的对象。


• @ResponseBody可以标注任何对象，由Srping完成对象——协议的转换。

Js代码  

1. $(document).ready(function() {


2. $("#profile").click(function() {


3. profile();


4. });


5. $("#login").click(function() {


6. login();


7. });


8. });


9. function profile() {


10. var url = ‘http://localhost:8080/spring-json/json/person/profile/‘;


11. var query = $(‘#id‘).val() + ‘/‘ + $(‘#name‘).val() + ‘/‘


12. + $(‘#status‘).val();


13. url += query;


14. alert(url);


15. $.get(url, function(data) {


16. alert("id: " + data.id + "\nname: " + data.name + "\nstatus: "


17. + data.status);


18. });


19. }


20. function login() {


21. var mydata = ‘{"name":"‘ + $(‘#name‘).val() + ‘","id":"‘


22. + $(‘#id‘).val() + ‘","status":"‘ + $(‘#status‘).val() + ‘"}‘;


23. alert(mydata);


24. $.ajax({


25. type : ‘POST‘,


26. contentType : ‘application/json‘,


27. url : ‘http://localhost:8080/spring-json/json/person/login‘,


28. processData : false,


29. dataType : ‘json‘,


30. data : mydata,


31. success : function(data) {


32. alert("id: " + data.id + "\nname: " + data.name + "\nstatus: "


33. + data.status);


34. },


35. error : function() {


36. alert(‘Err...‘);


37. }


38. });

Html代码  

1. <table>


2. <tr>


3. <td>id</td>


4. <td><input id="id" value="100" /></td>


5. </tr>


6. <tr>


7. <td>name</td>


8. <td><input id="name" value="snowolf" /></td>


9. </tr>


10. <tr>


11. <td>status</td>


12. <td><input id="status" value="true" /></td>


13. </tr>


14. <tr>


15. <td><input type="button" id="profile" value="Profile——GET" /></td>


16. <td><input type="button" id="login" value="Login——POST" /></td>


17. </tr>


18. </table>

引用

org.springframework.web.HttpMediaTypeNotSupportedException:
Content type ‘application/x-www-form-urlencoded;charset=UTF-8‘ not
supported 
org.springframework.web.HttpMediaTypeNotSupportedException:
Content type ‘application/x-www-form-urlencoded;charset=UTF-8‘ not
supported 
org.springframework.web.HttpMediaTypeNotSupportedException:
Content type ‘application/x-www-form-urlencoded;charset=UTF-8‘ not
supported

直接用$.post()直接请求会有点小问题，尽管我标识为json协议，但实际上提交的ContentType还是application/x-www-form-urlencoded。需要使用$.ajaxSetup()标示下ContentType。

Js代码  

1. function login() {


2. var mydata = ‘{"name":"‘ + $(‘#name‘).val() + ‘","id":"‘


3. + $(‘#id‘).val() + ‘","status":"‘ + $(‘#status‘).val() + ‘"}‘;


4. alert(mydata);


5. $.ajaxSetup({


6. contentType : ‘application/json‘


7. });


8. $.post(‘http://localhost:8080/spring-json/json/person/login‘, mydata,


9. function(data) {


10. alert("id: " + data.id + "\nname: " + data.name


11. + "\nstatus: " + data.status);


12. }, ‘json‘);


13. };

• spring-json.zip (65.1
  KB)


• 下载次数: 910

• 查看图片附件

Spring 注解学习手札（七）
补遗——@ResponseBody，@RequestBody，@PathVariable(转),布布扣,bubuko.com

Spring 注解学习手札（七）
补遗——@ResponseBody，@RequestBody，@PathVariable(转)