RESTful服务使用HTTP方法相关概念学习理解

HTTP动词包括我们的“统一接口”约束的主要部分,并且向基于名词的资源提供动作对应物。主要或最常用的HTTP动词或方法被称作,post,get,put,delete。这对应create、read、update、delete(或CRUD)操作。在那些不太频繁的方法中,options 和 head 使用得比其他方法多。


1.什么是RESTful

一种软件架构风格,设计风格而不是标准,只是提供了一组设计原则和约束条件。它主要用于客户端和服务器交互类的软件。基于这个风格设计的软件可以更简洁,更有层次,更易于实现缓存等机制。

摘录于知乎上相关的解释 怎样用通俗的语言解释什么叫 REST,以及什么是 RESTful?

  1. REST 不是 “rest”这个单词,而是几个单词缩写。

  2. REST 描述的是在网络中 client 和 server 的一种交互形式;REST本身不实用,实用的是如何设计 RESTful API(REST风格的网络接口);

  3. Server提供的RESTful API中,URL中只使用名词来指定资源,原则上不使用动词。“资源”是REST架构或者说整个网络处理的核心。比如:
    http://api.qc.com/v1/newsfeed: 获取某人的新鲜;
    http://api.qc.com/v1/friends: 获取某人的好友列表;
    http://api.qc.com/v1/profile: 获取某人的详细信息;

  4. 用HTTP协议里的动词来实现资源的添加,修改,删除等操作。即通过HTTP动词来实现资源的状态扭转:
    GET 用来获取资源,
    POST 用来新建资源(也可以用于更新资源),
    PUT 用来更新资源,
    DELETE 用来删除资源。
    比如:
    DELETE http://api.qc.com/v1/friends: 删除某人的好友 (在http parameter指定好友id)
    POST http://api.qc.com/v1/friends: 添加好友
    UPDATE http://api.qc.com/v1/profile: 更新个人资料

  5. Server和Client之间传递某资源的一个表现形式,比如用JSON,XML传输文本,或者用JPG,WebP传输图片等。当然还可以压缩HTTP传输时的数据(on-wire data compression)。

  6. 用 HTTP Status Code传递Server的状态信息。比如最常用的 200 表示成功,500 表示Server内部错误等。

主要信息就这么点。最后是要解放思想,Web端不再用之前典型的PHP或JSP架构,而是改为前段渲染和附带处理简单的商务逻辑(比如AngularJS或者BackBone的一些样例)。Web端和Server只使用上述定义的API来传递数据和改变数据状态。格式一般是JSON。iOS和Android同理可得。由此可见,Web,iOS,Android和第三方开发者变为平等的角色通过一套API来共同消费Server提供的服务。


2.http 相关的方法

HTTP Verb CRUD Entire Collection (e.g. /customers) Specific Item (e.g. /customers/{id})
POST Create 201 (Created), ‘Location’ header with link to /customers/{id} containing new ID. 404 (Not Found), 409 (Conflict) if resource already exists..
GET Read 200 (OK), list of customers. Use pagination, sorting and filtering to navigate big lists. 200 (OK), single customer. 404 (Not Found), if ID not found or invalid.
PUT Update/Replace 404 (Not Found), unless you want to update/replace every resource in the entire collection. 200 (OK) or 204 (No Content). 404 (Not Found), if ID not found or invalid.
DELETE Delete 404 (Not Found), unless you want to delete the whole collection—not often desirable. 200 (OK). 404 (Not Found), if ID not found or invalid.

2.1 post:

扫描二维码关注公众号,回复: 3862279 查看本文章

POST动词通常用于创建新资源。特别是,它用于创建从属资源。也就是说,从属于某些其他(例如父)资源。换句话说,当创建一个新的资源时,POST到父和服务负责将新的资源与父关联,分配一个ID(新的资源URI)等。

成功创建后,返回HTTP状态201,返回一个Location头,其中包含具有201 HTTP状态的新创建资源的链接。

POST既不安全也不幂等。因此,建议对非幂等资源请求。进行两个相同的POST请求将很可能导致包含相同信息的两个资源。

例子:
POST http://www.example.com/customers
POST http://www.example.com/customers/12345/orders


2.2 get:

HTTP GET方法用于读取(或检索)资源的表示。在“happy”(或非错误)路径中,GET返回一个XML或JSON表示形式,以及一个200(OK)的HTTP响应代码。在错误的情况下,它通常返回404(NOT FOUND)或400(BAD REQUEST)。

根据HTTP规范的设计,GET(与HEAD一起)请求仅用于读取数据而不改变它。因此,当使用这种方式时,它们被认为是安全的。也就是说,它们可以被调用而没有数据修改或损坏调用的风险,它一旦具有与调用10次相同的效果,或根本没有。此外,GET(和HEAD)是幂等的,这意味着使多个相同的请求最终具有与单个请求相同的结果。

不要通过GET暴露不安全的操作,它不应该修改服务器上的任何资源

例子:
GET http://www.example.com/customers/12345
GET http://www.example.com/customers/12345/orders
GET http://www.example.com/buckets/sample


2.3 put:

PUT通常用于更新功能,PUT到已知资源URI,请求主体包含原始资源的新更新的表示。

但是,在资源ID由客户端而不是由服务器选择的情况下,PUT也可以用于创建资源。换句话说,如果PUT是到包含不存在的资源ID的值的URI。同样,请求主体包含资源表示。许多人认为这是令人费解和混乱。因此,这种创作方法应谨慎使用,如果有的话。

或者,使用POST创建新资源并在正文表示中提供客户端定义的ID - 可能是不包括资源ID的URI(请参POST)。

成功更新后,从PUT返回200(如果未返回正文中的任何内容,则返回204)。如果使用PUT进行创建,则在成功创建时返回HTTP状态201。响应中的主体是可选的 - 提供一个消耗更多的带宽。由于客户端已经设置了资源ID,因此没有必要通过创建案例中的Location头返回链接。

PUT不是一个安全的操作,因为它修改(或创建)服务器上的状态,但它是幂等的。换句话说,如果您使用PUT创建或更新资源,然后再次进行同样的调用,资源仍然存在,并且仍然具有与第一次调用时相同的状态。

例如,如果对资源调用PUT增加资源内的计数器,则调用不再是幂等的。有时这种情况发生,它可能足以记录呼叫不是幂等的。但是,建议保持PUT请求幂等。强烈建议对非等幂请求使用POST。

例子:
PUT http://www.example.com/customers/12345
PUT http://www.example.com/customers/12345/orders/98765
PUT http://www.example.com/buckets/secret_stuff


2.4 delete:

DELETE很容易理解。它用于删除由URI标识的资源。

成功删除后,返回HTTP状态200(确定)以及响应正文,可能是已删除项的表示(通常需要过多的带宽)或包装响应。或者返回HTTP状态204(NO CONTENT),没有响应正文。换句话说,没有主体的204状态,或JSEND样式响应和HTTP状态200是推荐的响应。

HTTP-spec-wise,DELETE操作是幂等的。如果您删除资源,系统会将其移除。对该资源重复调用DELETE结果相同:资源消失。(If calling DELETE say 这个不知道啥意思)如果调用DELETE说,递减计数器(在资源内),则DELETE调用不再是幂等的。如前所述,只要没有资源数据改变,就可以更新使用统计和测量,同时仍然考虑服务等价。建议对非等幂资源请求使用POST。

但是,有一个关于DELETE idempotence的警告。第二次调用资源上的DELETE时,通常会返回404(NOT FOUND),因为它已被删除,因此不再可查找。这通过一些意见使得DELETE操作不再是幂等的,然而,资源的结束状态是相同的。返回404是可接受的,并且准确地传达呼叫的状态。

例子:
DELETE http://www.example.com/customers/12345
DELETE http://www.example.com/customers/12345/orders
DELETE http://www.example.com/bucket/sample


3.参考文章以及原文:

1.RESTful百度百科

2.怎样用通俗的语言解释什么叫 REST,以及什么是 RESTful?

3.原文链接

猜你喜欢

转载自blog.csdn.net/android_freshman/article/details/54585409