SpringMVC【四】RestFul 风格

8、RestFul 风格

8.1 概念

Restful 就是一个资源定位及资源操作的风格。不是标准也不是协议，只是一种风格。基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存等机制。

8.2 功能

资源：互联网所有的事物都可以被抽象为资源

资源操作：使用 POST、DELETE、PUT、GET 不同方法对资源进行操作，分别对应添加、 删除、修改、查询。

传统方式操作资源 ：通过不同的参数来实现不同的效果，方法单一，post 和 get

​ http:// 127.0.0.1/item/queryItem.action?id=1 查询，GET

​ http:// 127.0.0.1/item/saveItem.action 新增，POST

​ http:// 127.0.0.1/item/updateItem.action 更新，POST

​ http:// 127.0.0.1/item/deleteItem.action?id=1 删除，GET或POST

使用RESTful操作资源 ：可以通过不同的请求方式来实现不同的效果，如下：请求地址一样，但是功能可以不同

​ http:// 127.0.0.1/item/1 查询，GET

​ http:// 127.0.0.1/item 新增，POST

​ http:// 127.0.0.1/item 更新，PUT

​ http:// 127.0.0.1/item/1 删除，DELETE

访问路径的变化如下：

原来的：http://localhost:8080/add?a=1&b=2
Restful：http://localhost:8080/add/a/b

8.3 结合 SpringMVC 的使用

@PathVariable 及 @RequestMapping

1. 新建一个 Controller 类

2. 在 Spring MVC 中可以使用 @PathVariable 注解，让方法参数的值对应绑定到一个 URI 模板变量上。

   如下所示，@RequestMapping("/add") 需要写为 @RequestMapping("/add/{a}/{b}")

   @Controller
   public class RestfulController {
     
       // Restful：http://localhost:8080/add/a/b
       @RequestMapping("/add/{a}/{b}")
       public String test1(@PathVariable int a, @PathVariable int b, Model model){
           int res = a + b;
           model.addAttribute("msg","结果为：" + res);
           return "test";
       }
   
        // 原来的：http://localhost:8080/add?a=1&b=2
   //    @RequestMapping("/add")
   //    public String test1(int a, int b, Model model){
   //        int res = a + b;
   //        model.addAttribute("msg","结果为：" + res);
   //        return "test";
   //    }
   }
   

3. 测试及结果

   • 地址栏输入： localhost:8080/add/1/2
   • test.jsp 页面显示： 结果为：3

   使用路径变量的好处：

   • 使路径变得更加简洁；
   • 获得参数更加方便，框架会自动进行类型转换；
   • 通过路径变量的类型可以约束访问参数，如果类型不一样，则访问不到对应的请求方法，如果这里访问是的路径是 /add/1/a，则路径与方法不匹配，而不会是参数转换失败。

4. 修改对应的参数类型，将参数 b 的类型 int 修改为 String

   @Controller
   public class RestfulController {
   
       @RequestMapping("/add/{a}/{b}")
       public String test1(@PathVariable int a, @PathVariable String b, Model model){
           String res = a + b;
           model.addAttribute("msg","结果为：" + res);
           return "test";
       }
   }
   

5. 测试及结果

   • 地址栏输入： localhost:8080/add/1/a
   • test.jsp 页面显示： 结果为：1a

@RequestMapping 的 method 属性

Spring MVC 的 @RequestMapping 注解能够处理 HTTP 请求的方法，比如 GET、PUT、POST、DELETE、 PATCH。

可以使用 method 属性指定请求类型：用于约束请求的类型，可以收窄请求范围，指定请求的类型如 GET、POST、HEAD、OPTIONS、PUT、PATCH、DELETE、TRACE 等。

1. @RequestMapping 中添加一个 method 属性

   //映射访问路径,必须是POST请求
   @RequestMapping(value = "/add/{a}/{b}", method = RequestMethod.POST)
   //@PostMapping("/add/{a}/{b}") //组合注解，和上面的注解作用相同
   public String test1(@PathVariable int a, @PathVariable int b, Model model){
    int res = a + b;
    model.addAttribute("msg","结果1为：" + res);
    return "test";
   }
   

2. 使用浏览器地址栏进行访问默认是 Get 请求，所以会报错 405，如果将 POST 修改为 GET 则正常。

   //映射访问路径,必须是 get 请求
   @RequestMapping(value = "/add/{a}/{b}", method = RequestMethod.GET)
   //@GetMapping("/add/{a}/{b}")  //组合注解，和上面的注解作用相同
   public String test1(@PathVariable int a, @PathVariable int b, Model model){
    int res = a + b;
    model.addAttribute("msg","结果1为：" + res);
    return "test";
   }
   

注意：所有的地址栏请求默认都是 HTTP GET 类型的。

组合注解（方法级别的注解变体）：

它所扮演的是 @RequestMapping(method =RequestMethod.XXX) 的一个快捷方式，有以下几种：

@GetMapping			等价于 @RequestMapping(method =RequestMethod.GET)
@PostMapping
@PutMapping
@DeleteMapping
@PatchMapping