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