Restful风格的API

1.REST定义

REST是定义系统API的一种方法,可以理解为面向资源的API设计模式,也是系统之间传递数据状态的方法。

 

2.REST的原则

(1)Resources:使用易于理解的目录结构URL

Restful风格的API

(2)Representation:传输对象和属性常用XML和JSON表示,甚至可以使用HTML、YAML

(3)Message:用HTTP方法直接对资源操作( GET, POST, PUT, and DELETE

Restful风格的API

①当API不能用单纯的CRUD解决的时候,也就是所谓的存在一定的业务逻辑的方法,那我们需要将方法映射成为某个资源的属性。

②当一个方法需要访问多个资源的时候将方法抽象成一个资源

(4)State:更关注数据的值(状态)以及方法所改变数据的状态

 

3.REST例子——Spring boot中的Actuator

Restful风格的API

可以通过访问这些Endpoints直接查看工程下各项指标的值,这就是面向资源的API

 

4.Spring4.0后框架对REST的支持

(1)在Controller类前增加注释@RestController表明这是个REST风格的接口,从而返回的是数据对象(以JSON的形式直接返回给客户端)而不再是视图界面

(2)每个方法前也可以对应具体的HTTP操作方法增加如**释

Restful风格的API

(3)在每个参数中使用注释@PathVariable来解析前端传输到后端的URL,将里面的参数对应赋值到每个方法的参数中