restfulWebService1

###REST(表述性状态转移）

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

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

HTTP的交互是无状态的，任何HTTP中介都可以推断出给定请求和响应的意义，而无须关联过去或将来的请求和响应。

HTTP使用一个统一接口，包括有OPTIONS，GET，HEAD,POST,DELETE和TRACE方法。接口中的每一个方法操作一个且仅有一个资源。每个方法的语法和含义不会因应用程序或资源的不同而发生改变。
HTTP使用一种与MIME类似的信封格式进行表述编码。这个格式明确区分标头和内容。

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

1
2
3
4
5
6
7


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版本状态码状态消息响应的表述形式标头：响应的表述内容

1
2
3
4
5
6
7


HTTP/1.1 200 OK
connection: keep-alive
server: Cowboy
date: Fri,T08+00:00
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请求时，确保服务器提供同样的表述形式：

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

#####幂等方法幂等性保证客户端重复发起某个请求的效果与一次请求的效果一致。除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，其包含新资源的表述，这个新资源目的是让客户端可以跟踪异步任务的状态。

文章目录