javaee论坛

普通会员

225648

帖子

355

回复

369

积分

楼主
发表于 2017-09-25 14:16:32 | 查看: 112 | 回复: 3
REST,即Representational State Transfer的缩写,有人翻译为“表现层状态转化”。如果一个架构符合REST原则,就称它为RESTful架构。简答来说:URL定位资源,用HTTP动词(GET,POST,DELETE,PUT)描述操作。

二、资源(Resources)

所谓”资源”,就是网络上的一个实体,或者说是网络上的一个具体信息。它可以是一段文本、一张图片、一首歌曲、一种服务,总之就是一个具体的实在。你可以用一个URI(统一资源定位符)指向它,每种资源对应一个特定的URI。要获取这个资源,访问它的URI就可以,因此URI就成了每一个资源的地址或独一无二的识别符。
所谓”上网”,就是与互联网上一系列的”资源”互动,调用它的URI。

三、表现层(Representation)

“资源”是一种信息实体,它可以有多种外在表现形式。我们把”资源”具体呈现出来的形式,叫做它的”表现层”(Representation)。
比如,文本可以用txt格式表现,也可以用HTML格式、XML格式、JSON格式表现,甚至可以采用二进制格式;图片可以用JPG格式表现,也可以用PNG格式表现。
URI只代表资源的实体,不代表它的形式。严格地说,有些网址最后的”.html”后缀名是不必要的,因为这个后缀名表示格式,属于”表现层”范畴,而URI应该只代表”资源”的位置。它的具体表现形式,应该在HTTP请求的头信息中用Accept和Content-Type字段指定,这两个字段才是对”表现层”的描述。

四、状态转化(State Transfer)

访问一个网站,就代表了客户端和服务器的一个互动过程。在这个过程中,势必涉及到数据和状态的变化。
互联网通信协议HTTP协议,是一个无状态协议。这意味着,所有的状态都保存在服务器端。因此,如果客户端想要操作服务器,必须通过某种手段,让服务器端发生”状态转化”(State Transfer)。而这种转化是建立在表现层之上的,所以就是”表现层状态转化”。
客户端用到的手段,只能是HTTP协议。具体来说,就是HTTP协议里面,四个表示操作方式的动词:GET、POST、PUT、DELETE。它们分别对应四种基本操作:GET用来获取资源,POST用来新建资源(也可以用于更新资源),PUT用来更新资源,DELETE用来删除资源。

五、总结

1、API 的版本信息推荐放到HTTP的header中。
2、3. URI使用名词而不是动词,且推荐用复数。
BAD:
- /getProducts
- /listOrders
- /retrieveClientByOrder?orderId=1
GOOD:
- GET /products : will return the list of all products
- POST /products: will add a product to the collection
- GET /products/4 : will retrieve product #4
- PUT /products/4 : will update product #4
3、保证 HEAD 和 GET 方法是安全的,不会对资源状态有所改变(污染)。
4、使用正确的HTTP Status Code表示访问状态。

更详细的补充:
GET(SELECT):从服务器取出资源(一项或多项)。
POST(CREATE):在服务器新建一个资源。
PUT(UPDATE):在服务器更新资源(客户端提供完整资源数据)。
PATCH(UPDATE):在服务器更新资源(客户端提供需要修改的资源数据)。
DELETE(DELETE):从服务器删除资源。

一句话总结:看Url就知道要什么,看http method就知道干什么,看http status code就知道结果如何。

参考:http://www.ruanyifeng.com/blog/2011/09/restful.html


普通会员

0

帖子

337

回复

344

积分
沙发
发表于 2019-10-25 06:58:40

还是很厉害的

普通会员

13

帖子

315

回复

395

积分
板凳
发表于 2019-11-03 23:37:33

信春哥,得永生!

普通会员

0

帖子

316

回复

321

积分
地板
发表于 2024-04-19 06:38:55

看看

您需要登录后才可以回帖 登录 | 立即注册

触屏版| 电脑版

技术支持 历史网 V2.0 © 2016-2017