SpringMVC(四)REST风格

一、REST简介

REST(Representational State Transfer),表现形式状态转换

(1)传统风格资源描述形式     

        http://localhost/user/getById?id=1     

        http://localhost/user/saveUser

(2)REST风格描述形式     

        http://localhost/user/1     

        http://localhost/user

优点:

(1)隐藏资源的访问行为,无法通过地址得知对资源是何种操作

(2)书写简化

按照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的格式描述,表示此类资源,而非单个资源,例如:users、books、accounts……

二、RESTful 入门案例

1. 新增

@Controller
public class UserController {

    //设置当前请求方法为POST,表示REST风格中的添加操作
    @RequestMapping(value = "/users",method = RequestMethod.POST)
    @ResponseBody
    public String save(){
        System.out.println("user save...");
        return "{'module':'user save'}";
    }
  
}

2. 删除

@Controller
public class UserController {

    //设置当前请求方法为DELETE,表示REST风格中的删除操作
    //@PathVariable注解用于设置路径变量(路径参数),要求路径上设置对应的占位符,并且占位符名称与方法形参名称相同
    @RequestMapping(value = "/users/{id}",method = RequestMethod.DELETE)
    @ResponseBody
    public String delete(@PathVariable Integer id){
        System.out.println("user delete..." + id);
        return "{'module':'user delete'}";
    }
    
}

3. 修改

@Controller
public class UserController {

    //设置当前请求方法为PUT,表示REST风格中的修改操作
    @RequestMapping(value = "/users",method = RequestMethod.PUT)
    @ResponseBody
    public String update(@RequestBody User user){
        System.out.println("user update..."+user);
        return "{'module':'user update'}";
    }

}

4. 根据ID查询

@Controller
public class UserController {

    //设置当前请求方法为GET,表示REST风格中的查询操作
    //@PathVariable注解用于设置路径变量(路径参数),要求路径上设置对应的占位符,并且占位符名称与方法形参名称相同
    @RequestMapping(value = "/users/{id}" ,method = RequestMethod.GET)
    @ResponseBody
    public String getById(@PathVariable Integer id){
        System.out.println("user getById..."+id);
        return "{'module':'user getById'}";
    }

}

5. 查询所有

@Controller
public class UserController {

    //设置当前请求方法为GET,表示REST风格中的查询操作
    @RequestMapping(value = "/users",method = RequestMethod.GET)
    @ResponseBody
    public String getAll(){
        System.out.println("user getAll...");
        return "{'module':'user getAll'}";
    }

}

SpringMVC(四)REST风格_第1张图片

三、@RequestBody@RequestParam、@PathVariable 的区别

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

四、RESTful快速开发

问题 1 :每个方法的  @RequestMapping  注解中都定义了访问路径 /books ,重复性太高。
@RequestMapping  提到类上面,用来定义所有方法共同的访问路径。

问题2:每个方法的 @RequestMapping 注解中都要使用 method 属性定义请求方式,重复性太高。

使用@GetMapping @PostMapping @PutMapping @DeleteMapping代替

问题3:每个方法响应json都需要加上@ResponseBody注解,重复性太高。

(1) 将  ResponseBody  提到类上面,让所有的方法都有  @ResponseBody  的功能
(2) 使用  @RestController   注解替换  @Controller  与  @ResponseBody  注解,简化书写
//@Controller
//@ResponseBody配置在类上可以简化配置,表示设置当前每个方法的返回值都作为响应体
//@ResponseBody
@RestController     //使用@RestController注解替换@Controller与@ResponseBody注解,简化书写
@RequestMapping("/books")
public class BookController {

//    @RequestMapping( method = RequestMethod.POST)
    @PostMapping        //使用@PostMapping简化Post请求方法对应的映射配置
    public String save(@RequestBody Book book){
        System.out.println("book save..." + book);
        return "{'module':'book save'}";
    }

//    @RequestMapping(value = "/{id}" ,method = RequestMethod.DELETE)
    @DeleteMapping("/{id}")     //使用@DeleteMapping简化DELETE请求方法对应的映射配置
    public String delete(@PathVariable Integer id){
        System.out.println("book delete..." + id);
        return "{'module':'book delete'}";
    }

//    @RequestMapping(method = RequestMethod.PUT)
    @PutMapping         //使用@PutMapping简化Put请求方法对应的映射配置
    public String update(@RequestBody Book book){
        System.out.println("book update..."+book);
        return "{'module':'book update'}";
    }

//    @RequestMapping(value = "/{id}" ,method = RequestMethod.GET)
    @GetMapping("/{id}")    //使用@GetMapping简化GET请求方法对应的映射配置
    public String getById(@PathVariable Integer id){
        System.out.println("book getById..."+id);
        return "{'module':'book getById'}";
    }

//    @RequestMapping(method = RequestMethod.GET)
    @GetMapping             //使用@GetMapping简化GET请求方法对应的映射配置
    public String getAll(){
        System.out.println("book getAll...");
        return "{'module':'book getAll'}";
    }
}
SpringMVC(四)REST风格_第2张图片

SpringMVC(四)REST风格_第3张图片 五、案例:基于RESTful页面数据交互

1. SpringMVC需要将静态资源进行放行。

SpringMVC(四)REST风格_第4张图片

 

你可能感兴趣的:(黑马【SSM等】,java,spring,mvc,restful)