HTTP协议之方法定义

方法定义（Method Definitions）

 

  1 安全和等幂（Idempotent）方法... 1

      1.1    安全方法（Safe Methods）... 1

      1.2    等幂方法（Idempotent Mehtods）... 1

  2  OPTIONS..

  3  GET. 4

  4  HEAD.. 5

  5  POST. 6

  6  PUT. 7

  7  DELETE. 8

  8  TRACE. 9

  9  CONNECT. 10

1 安全和等幂（Idempotent）方法

1.1 安全方法（Safe Methods）

安全方法通常是指不影响服务器端资源的行为，它的操作结果仅仅是读取信息。

GET和HEAD方法只是执行对服务器没有影响的获取资源动作。这些方法应该被考虑是“安全”的。可以让用户代理调用的其它方法，如：POST、PUT、DELETE，这些方法是特殊的，用户代理应该知道这些方法可能会执行不安全的动作。

自然的，保证服务器由于执行GET请求而不能产生副作用是不可能的。实际上，一些动态的资源会考虑这个特性。用户并没有请求这些副作用，因此这些副作用对用户应该是不受影响的。

1.2 等幂方法（Idempotent Mehtods）

等幂就是值不变性，相同的请求得到相同的响应结果，不会出现相同的请求返回不同的响应结果。方法GET、HEAD、PUT、DELETE都有这种性质。同样，方法OPTIONS和TRACE不应该有副作用，因此具有内在的等幂性。

2 OPTIONS（选项）

OPTIONS方法表明请求想得到请求或者响应链上关于此请求里的URI（Request-URI）指定资源的通信选项信息。此方法允许客户端去判定请求资源的选项，或者服务器的能力，而不需要利用一个资源动作（使用POST，PUT，DELETE方法）或一个资源获取方法。

此方法的响应是不能缓存的。

如果OPTIONS请求消息里包括一个实体主体（当请求消息里出现Content-Length或者Transfer-Encoding头域时），那么媒体类型必须通过Content-Type头域指明。虽然此规范没有定义如何使用此实体主体，将来的HTTP扩展可能会利用OPTIONS请求的消息主体去得到服务器得更多信息。一个服务器如果不支持OPTION请求的消息主体，它会遗弃此请求消息主体。

如果请求URI是一个星号（"*"），OPTIONS请求将会应用于服务器的所有资源而不是特定资源。因为服务器的通信选项通常依赖于资源，所以“*”请求只能在“ping”或者“no-op”方法时才有用；它干不了任何事情除了允许客户端测试服务器的能力。例如：它能被用来测试代理是否遵循HTTP/1.1。

如果请求URI不是一个星号（"*"），OPTIONS请求只能应用于请求URI指定资源的选项。

200响应应该包含任何指明选项性质的头域，这些选项性质由服务器实现并且只适合那个请求的资源（例如，Allow头域），但也可能包一些扩展的在此规范里没有定义的头域。如果有响应主体的话也应该包含一些通信选项的信息。这个响应主体的格式并没有在此规范里定义，但是可能会在以后的HTTP里定义。内容协商可能被用于选择合适的响应格式。如果没有响应主体包含，响应就应该包含一个值为“0”的Content-Length头域。

Max-Forwards请求头域可能会被用于针对请求链中特定的代理。当代理接收到一个OPTIONS请求，且此请求的URI为absoluteURI，并且此请求是可以被转发的，那么代理必须要检测Max-Forwards头域。如果Max-Forwards头域的值为“0”，那么此代理不能转发此消息；而是代理应该以它自己的通信选项响应。如果Max-Forwards头域是比0大的整数值，那么代理必须递减此值当它转发此请求时。如果没有Max-Forwards头域出现在请求里，那么代理转发此请求时不能包含Max-Forwards头域。

3 GET

GET方法意思是获取被请求URI（Request-URI）指定的信息（以实体的格式）。如果请求URI涉及到一个数据生成过程，那么这个过程生成的数据应该被作为实体在响应中返回而不是过程的源文本，除非源文本恰好是过程的输出。

如果请求消息包含 If-Modified-Since,，If-Unmodified-Since，If-Match，If-None-Match或者 If-Range头域，GET的语义将变成“条件（conditionall） GET”。一个条件GET方法会请求满足条件头域的实体。条件GET方法的目的是为了减少不必要的网络使用，这通过允许利用缓存里仍然保鲜的实体而不用多次请求或传输客户端已经拥有的实体来实现的。

如果请求方法包含一个Range头域，那么GET方法就变成“部分Get”（partial GET）方法。一个部分GET会请求实体的一部分。 部分GET方法的目的是为了减少不必要的网络使用，可以允许客户端从服务器获取实体的部分数据，而不需要获取客户端本地已经拥有的部分实体数据。

GET请求的响应是可缓存的（cacheable）如果此响应满足HTTP缓存的要求。

4 HEAD

HEAD方法和GET方法一致，除了服务器不能在响应里返回消息主体。HEAD请求响应里HTTP头域里的元信息（元信息就是头域信息）应该和GET请求响应里的元信息一致。此方法被用来获取请求实体的元信息而不需要传输实体主体（entity-body）。此方法经常被用来测试超文本链接的有效性，可访问性，和最近的改变。

HEAD请求的响应是可缓存的，因为响应里的信息可能被缓存用于更新以前那个资源对应缓存的实体.。如果出现一个新的域值指明缓存的实体和当前源服务器上的实体有所不同（可能因为Content-Length，Content-MD5，ETag或Last-Modified值的改变），那么缓存（cache）必须认为缓存项是过时的（stale）。

5 POST

POST 方法被用于请求源服务器接受请求中的实体作为请求资源的一个新的从属物。POST被设计涵盖下面的功能。

已存在的资源的注释。

发布消息给一个布告板，新闻组，邮件列表，或者相似的文章组。

提供一个数据块，如提交一个表单给一个数据处理过程。

通过追加操作来扩展数据库。

POST方法的实际功能是由服务器决定的，并且经常依赖于请求URI（Request-URI）。POST提交的实体是请求URI的从属物，就好像一个文件从属于一个目录，一篇新闻文章从属于一个新闻组，或者一条记录从属于一个数据库。

POST方法执行的动作可能不会对请求URI所指的资源起作用。在这种情况下，200（成功）或者204（没有内容）将是适合的响应状态，这依赖于响应是否包含一个描述结果的实体。

如果资源被源服务器创建，响应应该是201（Created）并且包含一个实体，此实体描述了请求的状态。并且引用了这个新资源和一个Location头域。

POST方法的响应是不可缓存的。除非响应里有合适的Cache-Control或者Expires头域。然而，303（见其他）响应能被用户代理利用去获得可缓存的响应。

6 PUT

PUT方法请求服务器去把请求里的实体存储在请求URI（Request-URI）标识下面。请求URI（Request-URI）指定的的资源已经在源服务器上存在，那么此请求里的实体应该被当作是源服务器关于此URI所指定资源实体的最新修改版本。如果请求URI（Request-URI）指定的资源不存在，并且此URI被用户代理定义为一个新资源，那么源服务器就应该根据请求里的实体创建一个此URI所标识下的资源。如果一个新的资源被创建了，源服务器必须能向用户代理（user agent） 发送201（已创建）响应。如果已存在的资源被改变了，那么源服务器应该发送200（Ok）或者204（无内容）响应。如果资源不能根据请求URI创建或者改变，一个合适的错误响应应该给出以反应问题的性质。实体的接收者不能忽略任何它不理解和不能实现的Content-*（如：Content-Range）头域，并且必须返回501（没有被实现）响应。

如果请求穿过一个缓存（cache），并且此请求URI（Request-URI）指示了一个或多个当前缓存的实体，那么这些实体应该被看作是旧的。PUT方法的响应是不可缓存的。

POST方法和PUT方法请求最根本的区别是请求URI（Request-URI）的含义不同。POST请求里的URI指示一个能处理请求实体的资源（此资源可能是一段程序，如jsp里的servlet）。此资源可能是一个数据接收过程，一个网关（gateway，网关和代理的区别是：网关可以进行协议转换，而代理不能，只是起代理的作用，比如缓存服务器其实就是一个代理），或者一个单独接收注释的实体。对比而言，PUT方法请求里的URI标识请求里封装的实体一一用户代理知道URI意指什么，并且服务器不能把此请求应用于其它资源（resource）。如果服务器期望请求被应用于一个不同的URI，那么它必须发送301（永久移动）响应；用户代理可以自己决定是否重定向请求。

一个单独的资源可能会被许多不同的URI指定。如：一篇文章可能会有一个URI指定当前版本，而这个URI区别于这篇文章其它特殊版本的URI。这种情况下，对一个通用URI的PUT请求可能会导致其资源的其它URI请求被源服务器重定义。

HTTP/1.1没有定义PUT方法对源服务器的状态影响。

PUT请求必须遵循消息传送的要求。

除非特别指出，PUT方法请求里的实体头域应该被用于资源的创建或修改。

7 DELETE

DELETE方法请求源服务器删除请求URI指定的资源。此方法可能会在源服务器上被人为的干涉（或通过其他方法）。客户端不能保证此操作能被执行，即使源服务器返回成功状态码。然而，服务器不应该指明成功除非它打算删除资源或把此资源移到一个不可访问的位置。

如果响应里包含描述成功的实体，响应应该是200（OK）；如果DELETE动作还没有执行，应该以202（已接受）响应；如果DELETE请求方法已经执行但响应不包含实体，那么应该以204（无内容）响应。

如果请求穿过缓存，并且请求URI（Request-URI）指定了一个或多个缓存当前实体，那么这些缓存项应该被认为是旧的。DELETE方法的响应是不能被缓存的。

8 TRACE

TRACE方法被用于激发一个远程的，应用层的请求消息回路（TRACE方法让客户端测试到服务器的网络通路，回路的意思如发送一个请返回一个响应，这就是一个请求响应回路）。最后的接收者也许是源服务器，也许是接收到包含Max-Forwards头域值为0请求的代理或网关。TRACE请求不能包含一个实体。

TRACE方法允许客户端去了解数据被请求链的另一端接收的情况，并且利用那些数据信息去测试或诊断。Via头域值有特殊的用途，因为它可以作为请求链的跟踪信息。利用Max-Forwards头域允许客户端限制请求链的长度，这是非常有用的，因为可以利用此去测试代理链在无限循环里转发消息。

如果请求是有效的，响应应该在实体主体里包含整个请求消息，并且响应应该包含一个Content-Type头域值为”message/http”的头域。此方法的响应不能被缓存。

9 CONNECT

HTTP1.1协议规范保留了CONNECT方法，此方法是为了能用于能动态切换到隧道的代理。