HTTP动词包括我们的“统一接口”约束的主要部分,并且向基于名词的资源提供动作对应物。主要或最常用的HTTP动词或方法被称作,post,get,put,delete。这对应create、read、update、delete(或CRUD)操作。在那些不太频繁的方法中,options 和 head 使用得比其他方法多。
1.什么是RESTful
一种软件架构风格,设计风格而不是标准,只是提供了一组设计原则和约束条件。它主要用于客户端和服务器交互类的软件。基于这个风格设计的软件可以更简洁,更有层次,更易于实现缓存等机制。
摘录于知乎上相关的解释 怎样用通俗的语言解释什么叫 REST,以及什么是 RESTful?
REST 不是 “rest”这个单词,而是几个单词缩写。
REST 描述的是在网络中 client 和 server 的一种交互形式;REST本身不实用,实用的是如何设计 RESTful API(REST风格的网络接口);
Server提供的RESTful API中,URL中只使用名词来指定资源,原则上不使用动词。“资源”是REST架构或者说整个网络处理的核心。比如:
http://api.qc.com/v1/newsfeed: 获取某人的新鲜;
http://api.qc.com/v1/friends: 获取某人的好友列表;
http://api.qc.com/v1/profile: 获取某人的详细信息;用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: 更新个人资料Server和Client之间传递某资源的一个表现形式,比如用JSON,XML传输文本,或者用JPG,WebP传输图片等。当然还可以压缩HTTP传输时的数据(on-wire data compression)。
用 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:
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.参考文章以及原文:
2.怎样用通俗的语言解释什么叫 REST,以及什么是 RESTful?
3.原文链接