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规范

  《RESTful API 最佳实践》阮一峰

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

 

posted @ 2019-06-22 13:31  丫丫625202  阅读(325)  评论(0编辑  收藏  举报