REST风格开发

REST风格

REST风格简介

• REST(Representaional State Transfer)，表现形式状态转换。

  • 传统风格描述形式
    • http://localhost/user/getById?id=1
    • http://localhost/user/saveUser
  • REST风格描述形式
    • http://localhost/user/1
    • http://localhost/user

• 优点：

  • 隐藏资源的访问行为，无法通过地址得知对资源是何种操作。
  • 书写简化。

• 按照REST风格访问资源时使用行为动作区分对资源进行了何种操作。

  路径	请求方式	操作
  http://localhost/users	GET（查询）	查询全部用户信息
  http://localhost/users/1	GET（查询）	查询指定用户信息
  http://localhost/users	POST（新增/保存）	添加用户信息
  http://localhost/users	PUT（修改/更新）	修改用户信息
  http://localhost/users/1	DELETE（删除）	删除用户信息

• 根据REST风格对资源进行访问称为RESTful。
  注意：

• 上述行为是约定方式，约定不是规范，可以打破，所以称REST风格，而不是REST规范。

• 描述模块的名称通常使用复数，也就是加s的格式描述，表示此类资源，而非单个资源。

REST快速开发

• @RestController
  • 类型：类注解。
  • 位置：基于SpringMVC的RESTful开发控制器类定义上方。
  • 作用：设置当前控制器类为RESTful风格，等同于@Controller与@ReponseBody两个注解组合功能。
• @GetMapping、@PostMapping、@PutMapping、@DeleteMapping
  • 类型：方法注解。
  • 位置：基于SpringMVC的RESTful开发控制器类定义上方。
  • 作用：设置当前控制器方法请求访问路径与请求动作，每种对应一个请求动作。
  • 属性：
    • value（默认）：请求访问路径。