Restful风格

---

概念

Restful是一种软件架构风格、设计风格，用于约束客户端和服务器交互，它不是标准也不是协议，只是提供了一组设计原则和约束条件，满足这些约束条件和原则的应用程序或设计就是Restful。基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存等机制。

简单来说，就是用URL定位资源，用HTTP动词（GET,POST,DELETE,PUT）描述操作。

传统方式操作资源

通过不同的参数来实现不同的效果！方法单一，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

Restful API

1. REST描述的是在网络中client和server的一种交互形式；REST本身不实用，实用的是如何设计 RESTful API（REST风格的网络接口）；
2. Server提供的RESTful API中，URL中只使用名词来指定资源，原则上不使用动词。
3. 用HTTP协议里的动词来实现资源的添加，修改，删除等操作。即通过HTTP动词来实现资源的状态扭转：
   GET 用来获取资源，
   POST 用来新建资源（也可以用于更新资源），
   PUT 用来更新资源，
   DELETE 用来删除资源。
4. Server和Client之间传递某资源的一个表现形式，比如用JSON，XML传输文本，或者用JPG，WebP传输图片等。当然还可以压缩HTTP传输时的数据（on-wire data compression）。
5. 用 HTTP Status Code传递Server的状态信息。比如最常用的 200 表示成功，500 表示Server内部错误等。

案例

@Controller
public class RestfulController {

    @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";
    }

    @GetMapping("/add/{a}/{b}")
    public String test2(@PathVariable int a, @PathVariable int b, Model model) {
        int res = a + b;
        model.addAttribute("msg", "结果2为" + res);
        return "test";
    }

}

可以看到虽然这两个方法的请求路径相同，都为 http://localhost:8080/add/参数1/参数2，但采用不同方法进行请求则会得到不同的结果。

上述代码中使用的是路径变量，在SpringMVC中可以使用@PathVariable注解，让方法参数的值对应绑定到一个URI模板变量上。

使用路径变量的好处

1. 使路径变得更加简洁；
2. 获得参数更加方便，框架会自动进行类型转换；
3. 通过路径变量的类型可以约束访问参数，如果类型不一样，则访问不到对应的请求方法；
4. 安全，不会暴露变量名称。

总结

Restful风格是一种软件架构风格，基于这个风格设计的软件更加的简洁，高效，安全。