REST和RESTful软件架构风格
一、REST
1.简介
rest (representational state transfer ) ,表述性状态转移,是一种架构风格。
2.六大准则
- 客户-服务器(Client-Server),提供服务的服务器和使用服务的客户需要被隔离对待。
- 无状态(Stateless),来自客户的每一个请求必须包含服务器处理该请求所需的所有信息。
- 可缓存(Cachable),服务器必须让客户知道请求是否可以被缓存。
- 分层系统(Layered System),允许服务器和客户之间的中间层(代理,网关等)可以代替服务器对客户的请求进行回应。
统一接口(Uniform Interface 【可不用】),客户和服务器之间通信的方法必须是统一化的。服务器可以提供一些代码或者脚本,并在客户的运行环境中执行。
3.总结
用URL定位资源,用HTTP描述操作。
二、RESTful
1.简介
Restful就是一个资源定位及资源操作的风格,基于这个风格设计的软件可以更简洁,更有层次,更易于实现缓存。
2.功能
- 资源:互联网所有的事物都可以被抽象为资源。
- 资源操作:使用POST、DELETE、PUT、GET,
使用方法分别对应: 添加、 删除、修改、查询。
传统方式操作资源 :通过不同的参数来实现不同的效果!方法单一,post 和 get
使用RESTful操作资源 :可以通过不同的请求方式来实现不同的效果!
3.代码测试
1.新建一个类 RESTFulController
@Controller
public class RESTFulController {
}
2.在Spring MVC中可以使用 @PathVariable 注解,让方法参数的值对应绑定到一个URI模板变量上。
@Controller
public class RESTFulController {
//映射访问路径
@RequestMapping("/add/{p1}/{p2}")
public String index(@PathVariable int p1, @PathVariable int p2, Model model){
int result = p1+p2;
//Spring MVC会自动实例化一个Model对象用于向视图中传值
model.addAttribute("msg", "结果:"+result);
//返回视图位置
return "test";
}
}
3.修改下对应的参数类型,再次测试
//映射访问路径
@RequestMapping("/commit/{p1}/{p2}")
public String index(@PathVariable int p1, @PathVariable String p2, Model model){
String result = p1+p2;
//Spring MVC会自动实例化一个Model对象用于向视图中传值
model.addAttribute("msg", "结果:"+result);
//返回视图位置
return "test";
}
使用路径变量的好处:
- 使路径变得更加简洁;
- 获得参数更加方便,框架会自动进行类型转换。
- 通过路径变量的类型可以约束访问参数,如果类型不一样,则访问不到对应的请求方法。
5.使用method属性指定请求类型
用于约束请求的类型,如GET, POST, HEAD, PATCH, DELETE等。
增加一个方法
//映射访问路径,必须是POST请求
@RequestMapping(value = "/hello",method = {RequestMethod.POST})
public String index2(Model model){
model.addAttribute("msg", "hello!");
return "test";
}
进行浏览器地址栏访问默认是Get请求,会报错405!
如果将POST修改为GET则正常了;
//映射访问路径,必须是Get请求
@RequestMapping(value = "/hello",method = {RequestMethod.GET})
public String index2(Model model){
model.addAttribute("msg", "hello!");
return "test";
}
4.小结:
Spring MVC 的 @RequestMapping 注解能够处理 HTTP 请求的方法, 比如 GET, PUT, POST, DELETE 以及 PATCH。
所有的地址栏请求默认都会是 HTTP GET 类型的。
方法级别的注解变体有如下几个:组合注解
@GetMapping
@PostMapping
@PutMapping
@DeleteMapping
@PatchMapping
@GetMapping 是一个组合注解是 @RequestMapping(method =RequestMethod.GET) 的一个快捷方式【常用】。