01 RESTful概念规范
1、概念
URI
在web中的唯一标识就是URI。
URI统一资源标识符
URL统一资源定位符
其实可以说URL是URI的子集,通过定位的方式实现URI。URI是给我们的资源进行标识的
统一资源接口
根据http请求的方式不同,对资源进行不同的操作,这个就是统一资源接口。使用时一定要遵循http请求语义。
资源表述
资源的表述就是资源的展示形式,前后端传输的是资源的表示,而非资源本身。
例如文本可以采用html,json,xml等,图片可以使用png或jpeg等。
前端通过Accept请求头告知服务器资源的表示形式,服务器端则通过Content-Type字段告知客户端资源的表示形式。
当前端拿到资源的表示并呈现在页面上,就是我们所说的资源状态。
即传输的是资源的表示,呈现的是资源的状态
总结REST风格特点
(1)、在web中,只要有被引用的必要都叫资源
(2)、每个URI代表一个资源,独一无二
(3)、客户端通过http的方法,对服务器端的资源进行操作
(4)、客户端和服务器之间,传递这种资源的某种表现层
(5)、通过超链接的指引,实现“表现层状态转移”
2、RESTful规范
1、面向资源编程,每个URL代表一种资源,URL中尽量用名词不要用动词
2、根据method的不同,进行不同的操作,包括get、post、put、delete、patch
3、在url中体现版本,如http://www.bootcss.com/v1/mycss
4、在url中体现是否是API,如http://www.bootcss.com/api/mycss
5、在url中的过滤条件,如http://www.bootcss.com/v1/mycss?page=1
6、尽量使用https
7、响应时设置状态吗
1**信息,服务器收到请求,需要请求者继续执行操作
2**成功,操作被成功接收并处理
3**重定向,需要进一步的操作以完成请求
4**客户端错误,请求包含语法错误或无法完成请求
5**服务器错误,服务器在处理请求的过程中发生了错误
8、返回值
GET:返回查到所有或单条数据
POST:返回新增的数据
PUT:返回更新的数据
PATCH:局部更新,返回更新整条数据
DELETE:返回值为空
9、返回错误信息,返回值携带错误信息
10、Hypermedia API,如果遇到需要跳转的情况,携带跳转接口的URL