HTTP方法

1. OPTIONS

使用該方法來獲取資源支援的HTTP方法列表，或者ping伺服器。

• 請求：只有header沒有body。
• 響應：預設只有header，但是也可以在body中新增內容，比如描述性文字

示例：

# 測試對應資源所支援的方法
OPTIONS /test-options HTTP/1.1
Host: localhost
# 響應
HTTP/1.1 204 No Content
Allow: GET, POST, OPTIONS

# ping伺服器
OPTIONS * HTTP/1.1
Host: localhost
# 響應
HTTP/1.1 204 No Content

• 安全：是
• 冪等：是

顯然，它就是一個純粹的資訊讀取的操作，不改變資源的狀態，同時保證冪等性。

2. GET

該方法用以獲取資源的表述。

• 請求：只有header，沒有body。
• 響應：對應請求URI的資源表述，通常帶有body。響應header中的Content-Type，Content-Length，Content-Language，Last-Modified，ETag等應該和響應body的表述一致。

# 請求
GET /hello HTTP/1.1
Host: localhost
# 響應
HTTP/1.1 200 OK
Content-Type: application/xml; charset=UTF-8
Content-Length
 
: 21

<hello>tester</hello>

• 安全：是
• 冪等：是

簡單的資源資訊讀取，不對資源狀態造成影響，保證冪等性。

3. HEAD

使用該方法可以獲取與GET響應相同的header，但是響應中沒有任何body。

• 請求：只有header，沒有body。
• 響應：只有header，沒有body。伺服器不能新增body。

# 請求
GET /hello HTTP/1.1
Host: localhost
# 響應
HTTP/1.1 200 OK
Content-Type: application/xml; charset=UTF-8
Content-Length: 21

• 安全：是
• 冪等：是

簡單的資源資訊讀取，不對資源狀態造成影響，保證冪等性。

4. POST

讓資源在伺服器上執行一系列操作，如建立新資源、更新資源、變更資源等。

• 請求：一個資源的表述。
• 響應：一個資源的表述，或是一個重定向指令。如果body中存在表述，則其URI和請求URI不一致，包含一個帶有改資源URI的Content-Location頭。

# 執行動作的請求
POST /prompt/delete HTTP/1.1
Host: localhost
# 響應
HTTP/1.1 204 No Content

# 建立資源的請求
POST /stu/bob HTTP/1.1
Host: localhost
Content-Type: application/xml

<student>
    <name>Bob</name>
    <age>22</age>
</student>

# 響應
HTTP/1.1 201 Created
Location: http://localhost/stu/bob
Content-Location: http://localhost/stu/bob
Content-Type: application/xml

<student>
    <name>Bob</name>
    <age>22</age>
</student>

# 修改資源的請求
POST /stu/bob/modify HTTP/1.1
Host: localhost
Content-Type: application/json

{
    "Name": "Bob",
    "Age": 24
}

# 響應
HTTP/1.1 303 See Other
Location: http://localhost/stu/bob
Content-Type: application/xml

<student>
    <name>Bob</name>
    <age>24</age>
</student>

• 安全：否
• 冪等：否

是一個資源寫的操作，改變了資源的狀態，同事HTTP標準設定POST方法為非冪等，也就是說不需要在實現服務端響應方法的時候，我們不需要保證冪等，這也就避免了很多冗餘資訊(我們會在DELETE中看到)。

5. PUT

完整地更新或替換一個現有資源，也可以用客戶端制定的URI來建立一個新資源。

• 請求：一個資源的表述。請求的body可以與客戶端後續收到的GET請求一樣,當然，也可以不一樣。在某些情況下，伺服器也可要求客戶端只提供資源的可變部分。
• 響應：更新的狀態。可在響應中包含被更新資源的完整表述，但是客戶端不能假設響應中包含完整狀態，除非響應有一個Content-Location頭。如果伺服器沒有包含這個頭，客戶端必須提交一個無條件GET請求來獲取更新後的表述，帶有Last-Modified和/或ETag頭。

# 更新資源的請求
PUT /stu/bob HTTP/1.1
Host: localhost
# 響應
HTTP/1.1 204 No Content

# 建立資源的請求
PUT /stu/alice HTTP/1.1
Host: localhost
# 響應
HTTP/1.1 201 Created
Location: http://localhost/stu/alice
Content-Length: 0

• 安全：否
• 冪等：是

和POST方法一樣，PUT方法也改變了資源的狀態，所以是非安全的。但是有一點和POST不同，它是冪等的，這是為什麼呢？想想setter函式吧，重複呼叫，只要引數是一樣的，表述就是不變的。

6. DELETE

使用該方法來刪除資源。對於客戶端而言，資源在成功響應後，就不復存在了。

• 請求：只有header，沒有body。
• 響應：成功或失敗。body中可以包含操作的狀態。

# 請求
DELETE /doc/old.txt HTTP/1.1
Host: localhost
# 響應
HTTP/1.1 204 No Content

• 安全：否
• 冪等：是

和POST方法一樣，DELETE方法也改變了資源的狀態，所以是非安全的。但是有一點和POST不同，它是冪等的，也就是說，就算是伺服器在前一個請求中已經刪除了資源，它也必須返回200.這就意味著，我們在實現服務端的該方法是，需要跟蹤已經刪除的資源，否則就會返回404的。

7. TRACE

回顯伺服器接收到的header。支援該方法的伺服器可能存在XST安全隱患。

• 安全：
• 冪等：
• 請求：header與body。
• 響應：body中包含整個請求訊息。

# 請求
TRACE /trace HTTP/1.1
Host: localhost
Accept: text/html
# 響應
HTTP/1.1 200 OK
Content-Type: message/http
# 空行
TRACE /trace HTTP/1.1
Host: localhost
Accept: text/html