概念
Restful就是一个资源定位及资源操作的风格。不是标准也不是协议,只是一种风格。基于这个风格设 计的软件可以更简洁,更有层次,更易于实现缓存等机制。
功能
- 资源:互联网所有的事物都可以被抽象为资源
- 资源操作:使用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
学习测试
其余配置看之前的博客,这里只说Controller的写法。
- 在新建一个类 RestFulController
- 在Spring MVC中可以使用 @PathVariable 注解,让方法参数的值对应绑定到一个URI模板变量 上
@Controller
public class RestFulController {
//映射访问路径
@RequestMapping("/commit/{a}/{b}")
public String myRestFul(@PathVariable int a, @PathVariable int b, Model model){
int res = a + b;
//Spring MVC会自动实例化一个Model对象用于向视图中传值
model.addAttribute("msg","结果为:" + res);
//返回视图位置
return "rest";
}
}
测试:
思考:使用路径变量的好处?
-
使路径变得更加简洁;
-
获得参数更加方便,框架会自动进行类型转换。
-
通过路径变量的类型可以约束访问参数,如果类型不一样,则访问不到对应的请求方法,如这 里访问是的路径是/commit/1/a,则路径与方法不匹配,而不会是参数转换失败。
4. 我们来修改下对应的参数类型,再次测试public String myRestFul(@PathVariable int a, @PathVariable String b, Model model){
使用method属性指定请求类型
用于约束请求的类型,可以收窄请求范围。指定请求谓词的类型如GET, POST, HEAD, OPTIONS, PUT, PATCH, DELETE, TRACE等
我们来测试一下:
编写index.jsp:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<form action="/05_RestFul/commit/1/4" method="post">
<input type="submit"/>
</form>
</body>
</html>
在RestFulController增加一个方法
@RequestMapping(value = "/commit/{a}/{b}",method = {RequestMethod.POST})
public String RestFul2(@PathVariable int a, @PathVariable String b,Model model){
String res = a + b;
model.addAttribute("msg","post结果为:" + res);
return "rest";
}
结果:
Spring boot 开发 RESTFul 主要是几个注解实现
(1) @PathVariable
获取 url 中的数据
该注解是实现 RESTFul 最主要的一个注解
(2) @PostMapping 它所扮演的是 @RequestMapping(method =RequestMethod.POST) 的一个快捷方式
接收和处理 Post 方式的请求
(3) @DeleteMapping
接收 delete 方式的请求,可以使用 GetMapping 代替
(4) @PutMapping
接收 put 方式的请求,可以用 PostMapping 代替
(5) @GetMapping
接收 get 方式的请求
RESTful 原则
- ➢ 增 post 请求、删 delete 请求、改 put 请求、查 get 请求
- ➢ 请求路径不要出现动词
例如:查询订单接口
/boot/order/1021/1(推荐)
/boot/queryOrder/1021/1(不推荐) - ➢ 分页、排序等操作,不需要使用斜杠传参数
例如:订单列表接口
/boot/orders?page=1&sort=desc - 一般传的参数不是数据库表的字段,可以不采用斜杠
小黄鸭调试法
场景一:我们都有过向别人(甚至可能向完全不会编程的人)提问及解释编程问题的经历,但是很多时 候就在我们解释的过程中自己却想到了问题的解决方案,然后对方却一脸茫然。
场景二:你的同行跑来问你一个问题,但是当他自己把问题说完,或说到一半的时候就想出答案走了, 留下一脸茫然的你。
其实上面两种场景现象就是所谓的小黄鸭调试法(Rubber Duck Debuging),又称橡皮鸭调试法,它 是我们软件工程中最常使用调试方法之一
此概念据说来自《程序员修炼之道》书中的一个故事,传说程序大师随身携带一只小黄鸭,在调试代码 的时候会在桌上放上这只小黄鸭,然后详细地向鸭子解释每行代码,然后很快就将问题定位修复了。