RESTful快速学习

REST简介

• REST (Representational State Transfer),表现形式转换，即访问网络资源格式

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

• 优点：

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

REST风格简介

* 按照REST风格访问资源时行为动作动作

  * http://localhost/users          查询全部用户信息    GET（查询）
  * http://localhost/users/1        查询指定用户信息    GET（查询）
  * http://localhost/users          添加用户信息        POST（新增/保存）
  * http://localhost/users          修改用户信息        PUT（修改/更新）
  * http://localhost/users/1        删除用户信息        DELETE（删除）

* 入门
  
  1.设定http请求动作（动词），例如：method = RequestMethod.POST

  2.设定请求参数（路径变量）：

   @RequestMapping(value = "/users/{id}",method = RequestMethod.DELETE)
   @ResponseBody
   public String delete(@PathVariable Integer id){
     System.out.println("user delete..." + id);
     return "{'moudle':'user delete'}";
   }

* 案例总结
  
  * 名称：@RequestMapper
  * 类型：方法注解
  * 位置：SpringMVC控制器方法定义上方
  * 作用：设置当前控制器方法请求访问路径
  * 范例：

      @RequestMapper(value = "/users", method = RequestMethod.POST)
      @ResponseBody
      public String save(@RequestBody User user){
        System.out.println("user save..." + user);
        return "{'module':'user save'}";
}

  * 属性
      * value（默认）：请求访问路径
      * method：http请求动作，标准动作（GET/POST/PUT/DELETE）


  * 名称：@PathVariable
  * 类型：形参注解
  * 位置：SpringMVC控制器方法形参定义前面
  * 作用：绑定路径参数与处理器方法形参间的关系，要求路径参数名与形参名一一对应
  * 范例：

      @RequestMapping(value = "/users/{id}",method = RequestMethod.DELETE)
      @ResponseBody
      public String delete(@PathVariable Integer id){
        System.out.println("user delete..." + id);
        return "{'moudle':'user delete'}";
      }

  * 接收参数方式：@RequestBody、@RequestParam、@PathVariable
      
    * 区别：
        * @RequestParam用于接收url地址传参或者表单传参
        * @RequestBody用于接收json数据
        * @PathVariable用于接收路径参数，使用{参数名称}描述路径参数
    * 应用：
        * 后期开发中，发送请求参数超过1个时，以json为主，@RequestBody应用较广
        * 如果发送非json格式数据，选用@RequestParam接收请求参数
        * 采用RESTful进行开发，当参数较少时，例如1个，可以采用@PathVariable接收请求路径变量，通常用于传递id值

* 简化开发
    
    * 名称：@GetMapping、@PostMapping、@PutMapping、@DeleteMapping
    * 类型：方法注解
    * 位置：基于SpringMVC的RESTful开发控制器方法定义上方
    * 作用：设置当前控制器方法请求访问路径与请求动作，每种对应一个请求动作，例如@GetMapping对应GET请求
    * 范例：

        @GetMapping("/{id}")
        public String getById(@PathVariable Integer id){
            System.out.println("book getById..." + id);
            return "{'module':'book getByid'}";
        }

    * 属性：
        * value（默认）：请求访问路径
    * @RestController：简化@Controller和@ResponseBody