Restful web Services ----第一章笔记

REST(表述性状态转移)

HTTP 的设计 目标是在客户端和服务器之间对库、服务器、代理、缓存和其他工具的可见性。可见性是:一个组件能够对其他两个组件之间的交互进行监视或仲裁的能力。当协议是可见的时,缓存、代理、防火墙等组件既可以监视甚至参与其中。

HTTP 通过以下途径来实现可见性:

  • HTTP的交互是无状态的,任何HTTP中介都可以推断出给定请求和响应的意义,而无须关联过去或将来的请求和响应。
  • HTTP使用一个统一接口,包括有OPTIONS,GET,HEAD,POST,DELETE和TRACE方法。接口中的每一个方 法操作一个且仅有一个资源。每个方法的语法和含义不会因应用程序或资源的不同而发生改变。
  • HTTP使用一种与MIME类似的信封格式进行表述编码。这个格式明确区分标头和内容。

一个HTTP请求的格式:
请求行:HTTP方法 资源路径 HTTP版本
请求的表述形式表头:Content-Type:...
请求的表述内容

POST /api/bookclubserver/note/comment_text/put HTTP/1.1\r\n
User-Agent: curl/7.35.0\r\n
Host: localhost:8080\r\n
Accept: */*\r\n
content-type: application/json\r\n
Content-Length: 157\r\n\r\n
{ \"note_id\":\"201505080931476889\",\"user_id\":\"201504171121428216\",\"note_comment_content\":\"Is luck to meet you!\",\"p_note_comment_id\":\"-1\",\"p_note_user_id\":\"-1\"}

一个HTTP响应的格式:
响应行:HTTP版本 状态码 状态消息
响应的表述形式标头:
响应的表述内容

HTTP/1.1 200 OK
connection: keep-alive
server: Cowboy
date: Fri, 08 May 2015 01:43:11 GMT
content-length: 61
content-type: text/html
{"return_code":0,"status":[],"comment_id":201505080943113579}

对于RESTful 服务,主要目标必定是尽最大可能保持可见性:使用HTTP方法时,其语义要与HTTP所规定的语义保持一致,并添加适当的标头来描述请求和响应;另一方面是使用适当的状态码和状态消息,以便代理、缓存和客户端可以决定请求的结果,状态码是一个整数,状态消息是文本。

降低可见性原因:
-数据的重叠

为了其他好处放弃可见性:
-方便客户端:为了方便客户端使用,服务器可能需要设计特定目标的粗粒度组件资源
-抽象
-网络效率:当客户端需要在短时间内连续执行几个操作时,可能需要将这些操作组合到一个批处理中,以降低网络延迟。

如何在服务器端实现安全和幂等的方法

实现GET/OPTION/HEAD方法时,不要引起任何副作用。当客户端重新提交一个GET/HEAD/OPTIONS/PUT或DELETE请求时,确保服务器提供同样的表述形式:


http_method.png
实现安全方法

为了保证安全方法不会引起副作用,可以将安全方法实现为只读操作:即客户端发起请求时,不会改变资源的状态。

幂等方法

幂等性保证客户端重复发起某个请求的效果与一次请求的效果一致。除POST以外的所有方法都必须是幂等的。在编程语言的术语中,幂等方法类似于setter

DELETE方法的幂等性

DELETE方法是幂等的。这意味着就算服务器在前一个请求中已经删除了资源,它也必须返回200 (OK)响应码

如何在客户端吹安全和幂等方法

安全方法

把GET/OPTIONS/HEAD看做只读操作,需要时,可以随时发起这些请求。

幂等方法

幂等性保证了客户端可以在不能肯定服务器是否成功处理了请求时,重复发起这一请求。在HTTP中,除了POST以外的所有方法都是幂等的。

何时使用GET方法

使用 GET方法进行安全与幂等的信息获取。不要把GET方法用于不安全或非幂等操作,因为这样做可能会造成永久性的、意想不到的、不符合需要的资源改变。

何时使用POST方法

  • 创建新的资源。
  • 通过一个控制器资源来修改一个或多个资源
  • 执行需要大数据输入的查询
  • 在其他HTTP方法看上去不合适时,执行不安全或非幂等的操作。

何时使用PUT方法创建新资源

只有在客户端可以决定资源的URi时才使用PUT方法创建新资源,否则使用POST.举个例子,一台存储服务器可能为每个客户端分配一个根URL,并让客户端把根URI作为文件系统的根目录,以便创建新资源,如果不能控制URI,请使用POST方法

如何使用POST方法实现异步任务

HTTP是一种同步、无状态的协议。当客户端向服务器提交一个请求时,无论成功与否,客户端都期望得到一个回答。
在接收到POST请求时,创建一个新的资源,并返回状态码202,其包含新资源的表述,这个新资源目的是让客户端可以跟踪异步任务的状态。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 135,107评论 19 139
  • API定义规范 本规范设计基于如下使用场景: 请求频率不是非常高:如果产品的使用周期内请求频率非常高,建议使用双通...
    有涯逐无涯阅读 2,770评论 0 6
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 174,007评论 25 709
  • HTTP概述 超文本传输协议(HTTP,HyperText Transfer Protocol) 是互联网上应用最...
    曹渊说创业阅读 3,884评论 2 61
  • Aim High to the sky, In all that you do. Because you just...
    糖月阳阅读 382评论 0 0