三分钟彻底了解restful

         REST是英文representational state transfer(表象性状态转变)或者表述性状态转移;Rest是web服务的一种架构风格;使用HTTP,URI,XML,JSON,HTML等广泛流行的标准和协议;轻量级,跨平台,跨语言的架构设计;它是一种设计风格,不是一种标准,是一种思想

Rest架构的主要原则

     网络上的所有事物都被抽象为资源

    每个资源都有一个唯一的资源标识符

    同一个资源具有多种表现形式(xml,json等)

    对资源的各种操作不会改变资源标识符

    所有的操作都是无状态的

    符合REST原则的架构方式即可称为RESTful

什么是Restful:

        对应的中文是rest式的;Restful web service是一种常见的rest的应用,是遵守了rest风格的web服务;rest式的web服务是一种ROA(The Resource-Oriented Architecture)(面向资源的架构).

为什么会出现Restful


在Restful之前的操作:
http://127.0.0.1/user/query/1 GET  根据用户id查询用户数据
http://127.0.0.1/user/save POST 新增用户
http://127.0.0.1/user/update POST 修改用户信息
http://127.0.0.1/user/delete GET/POST 删除用户信息

RESTful用法:
http://127.0.0.1/user/1 GET  根据用户id查询用户数据
http://127.0.0.1/user  POST 新增用户
http://127.0.0.1/user  PUT 修改用户信息
http://127.0.0.1/user  DELETE 删除用户信息

之前的操作是没有问题的,大神认为是有问题的,有什么问题呢?你每次请求的接口或者地址,都在做描述,例如查询的时候用了query,新增的时候用了save,其实完全没有这个必要,我使用了get请求,就是查询.使用post请求,就是新增的请求,我的意图很明显,完全没有必要做描述,这就是为什么有了restful.

如何使用:



SpringMVC实现restful服务:

SpringMVC原生态的支持了REST风格的架构设计

所涉及到的注解:

–@RequestMapping

—@PathVariable

—@ResponseBody


   
   
  1. package cn.itcast.mybatis.controller;
  2. import org.springframework.beans.factory.annotation.Autowired;
  3. import org.springframework.http.HttpStatus;
  4. import org.springframework.http.ResponseEntity;
  5. import org.springframework.stereotype.Controller;
  6. import org.springframework.web.bind.annotation.PathVariable;
  7. import org.springframework.web.bind.annotation.RequestMapping;
  8. import org.springframework.web.bind.annotation.RequestMethod;
  9. import org.springframework.web.bind.annotation.RequestParam;
  10. import org.springframework.web.bind.annotation.ResponseBody;
  11. import cn.itcast.mybatis.pojo.User;
  12. import cn.itcast.mybatis.service.NewUserService;
  13. @RequestMapping( "restful/user")
  14. @Controller
  15. public class RestUserController {
  16. @Autowired
  17. private NewUserService newUserService;
  18. /**
  19. * 根据用户id查询用户数据
  20. *
  21. * @param id
  22. * @return
  23. */
  24. @RequestMapping(value = "{id}", method = RequestMethod.GET)
  25. @ResponseBody
  26. public ResponseEntity<User> queryUserById(@PathVariable("id") Long id) {
  27. try {
  28. User user = this.newUserService.queryUserById(id);
  29. if ( null == user) {
  30. // 资源不存在,响应404
  31. return ResponseEntity.status(HttpStatus.NOT_FOUND).body( null);
  32. }
  33. // 200
  34. // return ResponseEntity.status(HttpStatus.OK).body(user);
  35. return ResponseEntity.ok(user);
  36. } catch (Exception e) {
  37. e.printStackTrace();
  38. }
  39. // 500
  40. return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body( null);
  41. }
  42. /**
  43. * 新增用户
  44. *
  45. * @param user
  46. * @return
  47. */
  48. @RequestMapping(method = RequestMethod.POST)
  49. public ResponseEntity<Void> saveUser(User user) {
  50. try {
  51. this.newUserService.saveUser(user);
  52. return ResponseEntity.status(HttpStatus.CREATED).build();
  53. } catch (Exception e) {
  54. // TODO Auto-generated catch block
  55. e.printStackTrace();
  56. }
  57. // 500
  58. return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body( null);
  59. }
  60. /**
  61. * 更新用户资源
  62. *
  63. * @param user
  64. * @return
  65. */
  66. @RequestMapping(method = RequestMethod.PUT)
  67. public ResponseEntity<Void> updateUser(User user) {
  68. try {
  69. this.newUserService.updateUser(user);
  70. return ResponseEntity.status(HttpStatus.NO_CONTENT).build();
  71. } catch (Exception e) {
  72. e.printStackTrace();
  73. }
  74. // 500
  75. return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body( null);
  76. }
  77. /**
  78. * 删除用户资源
  79. *
  80. * @param user
  81. * @return
  82. */
  83. @RequestMapping(method = RequestMethod.DELETE)
  84. public ResponseEntity<Void> deleteUser(@RequestParam(value = "id", defaultValue = "0") Long id) {
  85. try {
  86. if (id.intValue() == 0) {
  87. // 请求参数有误
  88. return ResponseEntity.status(HttpStatus.BAD_REQUEST).build();
  89. }
  90. this.newUserService.deleteUserById(id);
  91. // 204
  92. return ResponseEntity.status(HttpStatus.NO_CONTENT).build();
  93. } catch (Exception e) {
  94. e.printStackTrace();
  95. }
  96. // 500
  97. return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body( null);
  98. }
  99. }



HTTP相应状态码:



总结:

restful就是旧技术,新风格.之前写过一篇关于restful接口的博客:【Restful接口】restful接口的两种使用方式

        </div>
            </div>
  • 0
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 1
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值