REST和RESTful软件架构风格

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) 的一个快捷方式【常用】。