HTTP協議解析之HTTP 響應(轉)

HTTP 響應

在接收和解釋請求消息後,服務器會返回一個 HTTP 響應消息。與 HTTP 請求類似,HTTP 響應也是由三個部分組成,分別是:狀態行、消息報頭和響應正文。

4.1、狀態行

狀態行由協議版本、數字形式的狀態代碼,及相應的狀態描述組成,各元素之間以空格分隔,除了結尾的 CRLF(回車換行)字符序列外,不允許出現 CR 或 LF 字符。格式如下:

HTTP-Version Status-Code Reason-Phrase CRLF

HTTP-Version 表示服務器 HTTP 協議的版本,Status-Code 表示服務器發回的響應代碼,Reason-Phrase 表示狀態代碼的文本描述,CRLF 表示回車換行。例如:

HTTP/1.1 200 OK (CRLF)

狀態代碼與狀態描述

狀態代碼由 3 位數字組成, 表示請求是否被理解或被滿足,狀態描述給出了關於狀態碼的簡短的文字描述。狀態碼的第一個數字定義了響應類別,後面兩位數字沒有具體分類。第一個數字有 5 種取值,如下所示。

  • 1xx:指示信息——表示請求已經接受,繼續處理
  • 2xx:成功——表示請求已經被成功接收、理解、接受。
  • 3xx:重定向——要完成請求必須進行更進一步的操作
  • 4xx:客戶端錯誤——請求有語法錯誤或請求無法實現
  • 5xx:服務器端錯誤——服務器未能實現合法的請求。
HTTP1.1 中的狀態碼與狀態描述

狀態代碼狀態信息含義100Continue初始的請求已經接受,客戶應當繼續發送請求的其餘部分。(HTTP 1.1新)101Switching Protocols服務器將遵從客戶的請求轉換到另外一種協議(HTTP 1.1新)200OK一切正常,對GET和POST請求的應答文檔跟在後面。201Created服務器已經創建了文檔,Location頭給出了它的URL。202Accepted已經接受請求,但處理尚未完成。203Non-Authoritative Information文檔已經正常地返回,但一些應答頭可能不正確,因爲使用的是文檔的拷貝(HTTP 1.1新)。204No Content沒有新文檔,瀏覽器應該繼續顯示原來的文檔。如果用戶定期地刷新頁面,而Servlet可以確定用戶文檔足夠新,這個狀態代碼是很有用的。205Reset Content沒有新的內容,但瀏覽器應該重置它所顯示的內容。用來強制瀏覽器清除表單輸入內容(HTTP 1.1新)。206Partial Content客戶發送了一個帶有Range頭的GET請求,服務器完成了它(HTTP 1.1新)。300Multiple Choices客戶請求的文檔可以在多個位置找到,這些位置已經在返回的文檔內列出。如果服務器要提出優先選擇,則應該在Location應答頭指明。301Moved Permanently客戶請求的文檔在其他地方,新的URL在Location頭中給出,瀏覽器應該自動地訪問新的URL。302Found類似於301,但新的URL應該被視爲臨時性的替代,而不是永久性的。注意,在HTTP1.0中對應的狀態信息是“Moved Temporatily”。

出現該狀態代碼時,瀏覽器能夠自動訪問新的URL,因此它是一個很有用的狀態代碼。

注意這個狀態代碼有時候可以和301替換使用。例如,如果瀏覽器錯誤地請求http://host/~user(缺少了後面的斜槓),有的服務器返回301,有的則返回302。

嚴格地說,我們只能假定只有當原來的請求是GET時瀏覽器纔會自動重定向。請參見307。

303See Other類似於301/302,不同之處在於,如果原來的請求是POST,Location頭指定的重定向目標文檔應該通過GET提取(HTTP 1.1新)。304Not Modified客戶端有緩衝的文檔併發出了一個條件性的請求(一般是提供If-Modified-Since頭表示客戶只想比指定日期更新的文檔)。服務器告訴客戶,原來緩衝的文檔還可以繼續使用。305Use Proxy客戶請求的文檔應該通過Location頭所指明的代理服務器提取(HTTP 1.1新)。307Temporary Redirect和 302(Found)相同。許多瀏覽器會錯誤地響應302應答進行重定向,即使原來的請求是POST,即使它實際上只能在POST請求的應答是303時才 能重定向。由於這個原因,HTTP 1.1新增了307,以便更加清除地區分幾個狀態代碼:當出現303應答時,瀏覽器可以跟隨重定向的GET和POST請求;如果是307應答,則瀏覽器只 能跟隨對GET請求的重定向。(HTTP 1.1新)400Bad Request請求出現語法錯誤。401Unauthorized客戶試圖未經授權訪問受密碼保護的頁面。應答中會包含一個WWW-Authenticate頭,瀏覽器據此顯示用戶名字/密碼對話框,然後在填寫合適的Authorization頭後再次發出請求。403Forbidden資源不可用。服務器理解客戶的請求,但拒絕處理它。通常由於服務器上文件或目錄的權限設置導致。404Not Found無法找到指定位置的資源。這也是一個常用的應答。405Method Not Allowed請求方法(GET、POST、HEAD、DELETE、PUT、TRACE等)對指定的資源不適用。(HTTP 1.1新)406Not Acceptable指定的資源已經找到,但它的MIME類型和客戶在Accpet頭中所指定的不兼容(HTTP 1.1新)。407Proxy Authentication Required類似於401,表示客戶必須先經過代理服務器的授權。(HTTP 1.1新)408Request Timeout在服務器許可的等待時間內,客戶一直沒有發出任何請求。客戶可以在以後重複同一請求。(HTTP 1.1新)409Conflict通常和PUT請求有關。由於請求和資源的當前狀態相沖突,因此請求不能成功。(HTTP 1.1新)410Gone所請求的文檔已經不再可用,而且服務器不知道應該重定向到哪一個地址。它和404的不同在於,返回407表示文檔永久地離開了指定的位置,而404表示由於未知的原因文檔不可用。(HTTP 1.1新)411Length Required服務器不能處理請求,除非客戶發送一個Content-Length頭。(HTTP 1.1新)412Precondition Failed請求頭中指定的一些前提條件失敗(HTTP 1.1新)。413Request Entity Too Large目標文檔的大小超過服務器當前願意處理的大小。如果服務器認爲自己能夠稍後再處理該請求,則應該提供一個Retry-After頭(HTTP 1.1新)。414Request URI Too LongURI太長(HTTP 1.1新)。416Requested Range Not Satisfiable服務器不能滿足客戶在請求中指定的Range頭。(HTTP 1.1新)500Internal Server Error服務器遇到了意料不到的情況,不能完成客戶的請求。501Not Implemented服務器不支持實現請求所需要的功能。例如,客戶發出了一個服務器不支持的PUT請求。502Bad Gateway服務器作爲網關或者代理時,爲了完成請求訪問下一個服務器,但該服務器返回了非法的應答。503Service Unavailable服務器由於維護或者負載過重未能應答。例如,Servlet可能在數據庫連接池已滿的情況下返回503。服務器返回503時可以提供一個Retry-After頭。504Gateway Timeout由作爲代理或網關的服務器使用,表示不能及時地從遠程服務器獲得應答。(HTTP 1.1新)505HTTP Version Not Supported服務器不支持請求中所指明的HTTP版本。(HTTP 1.1新)

1xx 消息

這一類型的狀態碼,代表請求已被接受,需要繼續處理。這類響應是臨時響應,只包含狀態行和某些可選的響應頭信息,並以空行結束。由於 HTTP/1.0 協議中沒有定義任何 1xx 狀態碼,所以除非在某些試驗條件下,服務器禁止向 HTTP/1.0 客戶端發送 1xx 響應。

100 Continue

客戶端應當繼續發送請求。這個臨時響應是用來通知客戶端它的部分請求已經被服務器接收,且仍未被拒絕。客戶端應當繼續發送請求的剩餘部分,或者如果 請求已經完成,忽略這個響應。服務器必須在請求完成後向客戶端發送一個最終響應。

101 Switching Protocols

服務器已經理解了客戶端的請求,並將通過 Upgrade 消息頭通知客戶端採用不同的協議來完成這個請求。在發送完這個響應最後的空行後,服務器將會切換到在 Upgrade 消息頭中定義的那些協議。
只有在切換新的協議更有好處的時候才應該採取類似措施。例如,切換到新的 HTTP 版本比舊版本更有優勢,或者切換到一個實時且同步的協議以傳送利用此類特性的資源。

102 Processing

由WebDAV(RFC 2518)擴展的狀態碼,代表處理將被繼續執行。

2xx 成功

這一類型的狀態碼,代表請求已成功被服務器接收、理解、並接受。

200 OK

請求已成功,請求所希望的響應頭或數據體將隨此響應返回。

201 Created

請求已經被實現,而且有一個新的資源已經依據請求的需要而建立,且其 URI 已經隨 Location 頭信息返回。假如需要的資源無法及時建立的話,應當返回 ‘202 Accepted’。

202 Accepted

服務器已接受請求,但尚未處理。正如它可能被拒絕一樣,最終該請求可能會也可能不會被執行。在異步操作的場合下,沒有比發送這個狀態碼更方便的做法 了。
返 回202狀態碼的響應的目的是允許服務器接受其他過程的請求(例如某個每天只執行一次的基於批處理的操作),而不必讓客戶端一直保持與服務器的連接直到 批處理操作全部完成。在接受請求處理並返回202狀態碼的響應應當在返回的實體中包含一些指示處理當前狀態的信息,以及指向處理狀態監視器或狀態預測的指 針,以便用戶能夠估計操作是否已經完成。

203 Non-Authoritative Information

服務器已成功處理了請求,但返回的實體頭部元信息不是在原始服務器上有效的確定集合,而是來自本地或者第三方的拷貝。當前的信息可能是原始版本的子 集或者超集。例如,包含資源的元數據可能導致原始服務器知道元信息的超級。使用此狀態碼不是必須的,而且只有在響應不使用此狀態碼便會返回200 OK的情況下才是合適的。

204 No Content

服務器成功處理了請求,但不需要返回任何實體內容,並且希望返回更新了的元信息。響應可能通過實體頭部的形式,返回新的或更新後的元信息。如果存在 這些頭部信息,則應當與所請求的變量相呼應。
如果客戶端是瀏覽器的話,那麼用戶瀏覽器應保留髮送了該請求的頁面,而不產生任何文檔視圖上的變化,即使按照規範新的或更新後的元信息應當被應用到用戶瀏 覽器活動視圖中的文檔。
由於204響應被禁止包含任何消息體,因此它始終以消息頭後的第一個空行結尾。

205 Reset Content

服務器成功處理了請求,且沒有返回任何內容。但是與204響應不同,返回此狀態碼的響應要求請求者重置文檔視圖。該響應主要是被用於接受用戶輸入 後,立即重置表單,以便用戶能夠輕鬆地開始另一次輸入。
與204響應一樣,該響應也被禁止包含任何消息體,且以消息頭後的第一個空行結束。

206 Partial Content

服務器已經成功處理了部分 GET 請求。類似於 FlashGet 或者迅雷這類的 HTTP 下載工具都是使用此類響應實現斷點續傳或者將一個大文檔分解爲多個下載段同時下載。
該請求必須包含 Range 頭信息來指示客戶端希望得到的內容範圍,並且可能包含 If-Range 來作爲請求條件。
響應必須包含如下的頭部域:
* Content-Range 用以指示本次響應中返回的內容的範圍;如果是 Content-Type 爲 multipart/byteranges 的多段下載,則每一 multipart 段中都應包含 Content-Range 域用以指示本段的內容範圍。假如響應中包含 Content-Length,那麼它的數值必須匹配它返回的內容範圍的真實字節數。
* Date
* ETag 和/或 Content-Location,假如同樣的請求本應該返回200響應。
* Expires, Cache-Control,和/或 Vary,假如其值可能與之前相同變量的其他響應對應的值不同的話。
假 如本響應請求使用了 If-Range 強緩存驗證,那麼本次響應不應該包含其他實體頭;假如本響應的請求使用了 If-Range 弱緩存驗證,那麼本次響應禁止包含其他實體頭;這避免了緩存的實體內容和更新了的實體頭信息之間的不一致。否則,本響應就應當包含所有本應該返回200響 應中應當返回的所有實體頭部域。
假如 ETag 或 Last-Modified 頭部不能精確匹配的話,則客戶端緩存應禁止將206響應返回的內容與之前任何緩存過的內容組合在一起。
任何不支持 Range 以及 Content-Range 頭的緩存都禁止緩存206響應返回的內容。

207 Multi-Status

由WebDAV(RFC 2518)擴展的狀態碼,代表之後的消息體將是一個XML消息,並且可能依照之前子請求數量的不同,包含一系列獨立的響應代碼。

3xx 重定向

這類狀態碼代表需要客戶端採取進一步的操作才能完成請求。通常,這些狀態碼用來重定向,後續的請求地址(重定向目標)在本次響應的 Location 域中指明。
當 且僅當後續的請求所使用的方法是 GET 或者 HEAD 時,用戶瀏覽器纔可以在沒有用戶介入的情況下自動提交所需要的後續請求。客戶端應當自動監測無限循環重定向(例如:A->A,或者 A->B->C->A),因爲這會導致服務器和客戶端大量不必要的資源消耗。按照 HTTP/1.0 版規範的建議,瀏覽器不應自動訪問超過5次的重定向。

300 Multiple Choices

被請求的資源有一系列可供選擇的回饋信息,每個都有自己特定的地址和瀏覽器驅動的商議信息。用戶或瀏覽器能夠自行選擇一個首選的地址進行重定向。
除 非這是一個 HEAD 請求,否則該響應應當包括一個資源特性及地址的列表的實體,以便用戶或瀏覽器從中選擇最合適的重定向地址。這個實體的格式由 Content-Type 定義的格式所決定。瀏覽器可能根據響應的格式以及瀏覽器自身能力,自動作出最合適的選擇。當然,RFC 2616規範並沒有規定這樣的自動選擇該如何進行。
如果服務器本身已經有了首選的回饋選擇,那麼在 Location 中應當指明這個回饋的 URI;瀏覽器可能會將這個 Location 值作爲自動重定向的地址。此外,除非額外指定,否則這個響應也是可緩存的。

301 Moved Permanently

被請求的資源已永久移動到新位置,並且將來任何對此資源的引用都應該使用本響應返回的若干個 URI 之一。如果可能,擁有鏈接編輯功能的客戶端應當自動把請求的地址修改爲從服務器反饋回來的地址。除非額外指定,否則這個響應也是可緩存的。
新的永久性的 URI 應當在響應的 Location 域中返回。除非這是一個 HEAD 請求,否則響應的實體中應當包含指向新的 URI 的超鏈接及簡短說明。
如果這不是一個 GET 或者 HEAD 請求,因此瀏覽器禁止自動進行重定向,除非得到用戶的確認,因爲請求的條件可能因此發生變化。
注意:對於某些使用 HTTP/1.0 協議的瀏覽器,當它們發送的 POST 請求得到了一個301響應的話,接下來的重定向請求將會變成 GET 方式。

302 Found

請求的資源現在臨時從不同的 URI 響應請求。由於這樣的重定向是臨時的,客戶端應當繼續向原有地址發送以後的請求。只有在Cache-Control或Expires中進行了指定的情況 下,這個響應纔是可緩存的。
新的臨時性的 URI 應當在響應的 Location 域中返回。除非這是一個 HEAD 請求,否則響應的實體中應當包含指向新的 URI 的超鏈接及簡短說明。
如果這不是一個 GET 或者 HEAD 請求,那麼瀏覽器禁止自動進行重定向,除非得到用戶的確認,因爲請求的條件可能因此發生變化。
注 意:雖然RFC 1945和RFC 2068規範不允許客戶端在重定向時改變請求的方法,但是很多現存的瀏覽器將302響應視作爲303響應,並且使用 GET 方式訪問在 Location 中規定的 URI,而無視原先請求的方法。狀態碼303和307被添加了進來,用以明確服務器期待客戶端進行何種反應。

303 See Other

對應當前請求的響應可以在另一個 URI 上被找到,而且客戶端應當採用 GET 的方式訪問那個資源。這個方法的存在主要是爲了允許由腳本激活的POST請求輸出重定向到一個新的資源。這個新的 URI 不是原始資源的替代引用。同時,303響應禁止被緩存。當然,第二個請求(重定向)可能被緩存。
新的 URI 應當在響應的 Location 域中返回。除非這是一個 HEAD 請求,否則響應的實體中應當包含指向新的 URI 的超鏈接及簡短說明。
注意:許多 HTTP/1.1 版以前的 瀏覽器不能正確理解303狀態。如果需要考慮與這些瀏覽器之間的互動,302狀態碼應該可以勝任,因爲大多數的瀏覽器處理302響應時的方式恰恰就是上述 規範要求客戶端處理303響應時應當做的。

304 Not Modified

如果客戶端發送了一個帶條件的 GET 請求且該請求已被允許,而文檔的內容(自上次訪問以來或者根據請求的條件)並沒有改變,則服務器應當返回這個狀態碼。304響應禁止包含消息體,因此始終 以消息頭後的第一個空行結尾。
該響應必須包含以下的頭信息:
* Date,除非這個服務器沒有時鐘。假如沒有時鐘的服務器也遵守這些規則,那麼代理服務器以及客戶端可以自行將 Date 字段添加到接收到的響應頭中去(正如RFC 2068中規定的一樣),緩存機制將會正常工作。
* ETag 和/或 Content-Location,假如同樣的請求本應返回200響應。
* Expires, Cache-Control,和/或 Vary,假如其值可能與之前相同變量的其他響應對應的值不同的話。
假如本響應請求使用了強緩存驗證,那麼本次響應不應該包含其他實體頭;否則(例如,某個帶條件的 GET 請求使用了弱緩存驗證),本次響應禁止包含其他實體頭;這避免了緩存了的實體內容和更新了的實體頭信息之間的不一致。
假如某個304響應指明瞭當前某個實體沒有緩存,那麼緩存系統必須忽視這個響應,並且重複發送不包含限制條件的請求。
假如接收到一個要求更新某個緩存條目的304響應,那麼緩存系統必須更新整個條目以反映所有在響應中被更新的字段的值。

305 Use Proxy

被請求的資源必須通過指定的代理才能被訪問。 Location 域中將給出指定的代理所在的 URI 信息,接收者需要重複發送一個單獨的請求,通過這個代理才能訪問相應資源。只有原始服務器才能建立305響應。
注意:RFC 2068中沒有明確305響應是爲了重定向一個單獨的請求,而且只能被原始服務器建立。忽視這些限制可能導致嚴重的安全後果。

306 Switch Proxy

在最新版的規範中,306狀態碼已經不再被使用。

307 Temporary Redirect

請求的資源現在臨時從不同的 URI 響應請求。由於這樣的重定向是臨時的,客戶端應當繼續向原有地址發送以後的請求。只有在Cache-Control或Expires中進行了指定的情況 下,這個響應纔是可緩存的。
新 的臨時性的 URI 應當在響應的 Location 域中返回。除非這是一個 HEAD 請求,否則響應的實體中應當包含指向新的 URI 的超鏈接及簡短說明。因爲部分瀏覽器不能識別307響應,因此需要添加上述必要信息以便用戶能夠理解並向新的 URI 發出訪問請求。
如果這不是一個 GET 或者 HEAD 請求,那麼瀏覽器禁止自動進行重定向,除非得到用戶的確認,因爲請求的條件可能因此發生變化。

4xx 請求錯誤

這類的狀態碼代表了客戶端看起來可能發生了錯誤,妨礙了服務器的處理。除非響應的是一個 HEAD 請求,否則服務器就應該返回一個解釋當前錯誤狀況的實體,以及這是臨時的還是永久性的狀況。這些狀態碼適用於任何請求方法。瀏覽器應當向用戶顯示任何包含 在此類錯誤響應中的實體內容。
如果錯誤發生時客戶端正在傳送數據,那麼使用TCP的服務器實現應當仔細確保在關閉客戶端與服務器之間的連接之 前,客戶端已經收到了包含錯誤信息的數據 包。如果客戶端在收到錯誤信息後繼續向服務器發送數據,服務器的TCP棧將向客戶端發送一個重置數據包,以清除該客戶端所有還未識別的輸入緩衝,以免這些 數據被服務器上的應用程序讀取並干擾後者。

400 Bad Request

由於包含語法錯誤,當前請求無法被服務器理解。除非進行修改,否則客戶端不應該重複提交這個請求。

401 Unauthorized

當前請求需要用戶驗證。該響應必須包含一個適用於被請求資源的 WWW-Authenticate 信息頭用以詢問用戶信息。客戶端可以重複提交一個包含恰當的 Authorization 頭信息的請求。如果當前請求已經包含了 Authorization 證書,那麼401響應代表着服務器驗證已經拒絕了那些證書。如果401響應包含了與前一個響應相同的身份驗證詢問,且瀏覽器已經至少嘗試了一次驗證,那麼 瀏覽器應當向用戶展示響應中包含的實體信息,因爲這個實體信息中可能包含了相關診斷信息。參見RFC 2617。

402 Payment Required

該狀態碼是爲了將來可能的需求而預留的。

403 Forbidden

服務器已經理解請求,但是拒絕執行它。與401響應不同的是,身份驗證並不能提供任何幫助,而且這個請求也不應該被重複提交。如果這不是一個 HEAD 請求,而且服務器希望能夠講清楚爲何請求不能被執行,那麼就應該在實體內描述拒絕的原因。當然服務器也可以返回一個404響應,假如它不希望讓客戶端獲得 任何信息。

404 Not Found

請求失敗,請求所希望得到的資源未被在服務器上發現。沒有信息能夠告訴用戶這個狀況到底是暫時的還是永久的。假如服務器知道情況的話,應當使用 410狀態碼來告知舊資源因爲某些內部的配置機制問題,已經永久的不可用,而且沒有任何可以跳轉的地址。404這個狀態碼被廣泛應用於當服務器不想揭示到 底爲何請求被拒絕或者沒有其他適合的響應可用的情況下。

405 Method Not Allowed

請求行中指定的請求方法不能被用於請求相應的資源。該響應必須返回一個Allow 頭信息用以表示出當前資源能夠接受的請求方法的列表。
鑑於 PUT,DELETE 方法會對服務器上的資源進行寫操作,因而絕大部分的網頁服務器都不支持或者在默認配置下不允許上述請求方法,對於此類請求均會返回405錯誤。

406 Not Acceptable

請求的資源的內容特性無法滿足請求頭中的條件,因而無法生成響應實體。
除非這是一個 HEAD 請求,否則該響應就應當返回一個包含可以讓用戶或者瀏覽器從中選擇最合適的實體特性以及地址列表的實體。實體的格式由 Content-Type 頭中定義的媒體類型決定。瀏覽器可以根據格式及自身能力自行作出最佳選擇。但是,規範中並沒有定義任何作出此類自動選擇的標準。

407 Proxy Authentication Required

與401響應類似,只不過客戶端必須在代理服務器上進行身份驗證。代理服務器必須返回一個 Proxy-Authenticate 用以進行身份詢問。客戶端可以返回一個 Proxy-Authorization 信息頭用以驗證。參見RFC 2617。

408 Request Timeout

請求超時。客戶端沒有在服務器預備等待的時間內完成一個請求的發送。客戶端可以隨時再次提交這一請求而無需進行任何更改。

409 Conflict

由於和被請求的資源的當前狀態之間存在衝突,請求無法完成。這個代碼只允許用在這樣的情況下才能被使用:用戶被認爲能夠解決衝突,並且會重新提交新 的請求。該響應應當包含足夠的信息以便用戶發現衝突的源頭。
衝 突通常發生於對 PUT 請求的處理中。例如,在採用版本檢查的環境下,某次 PUT 提交的對特定資源的修改請求所附帶的版本信息與之前的某個(第三方)請求向衝突,那麼此時服務器就應該返回一個409錯誤,告知用戶請求無法完成。此時, 響應實體中很可能會包含兩個衝突版本之間的差異比較,以便用戶重新提交歸併以後的新版本。

410 Gone

被請求的資源在服務器上已經不再可用,而且沒有任何已知的轉發地址。這樣的狀況應當被認爲是永久性的。如果可能,擁有鏈接編輯功能的客戶端應當在獲 得用戶許可後刪除所有指向這個地址的引用。如果服務器不知道或者無法確定這個狀況是否是永久的,那麼就應該使用404狀態碼。除非額外說明,否則這個響應 是可緩存的。
410響應的目的主要是幫助網站管理員維護網站,通知用戶該資源已經不再可用,並且服務器擁有者希望所有指向這個資源的遠端連接也 被刪除。這類事件在限 時、增值服務中很普遍。同樣,410響應也被用於通知客戶端在當前服務器站點上,原本屬於某個個人的資源已經不再可用。當然,是否需要把所有永久不可用的 資源標記爲’410 Gone’,以及是否需要保持此標記多長時間,完全取決於服務器擁有者。

411 Length Required

服務器拒絕在沒有定義 Content-Length 頭的情況下接受請求。在添加了表明請求消息體長度的有效 Content-Length 頭之後,客戶端可以再次提交該請求。

412 Precondition Failed

服務器在驗證在請求的頭字段中給出先決條件時,沒能滿足其中的一個或多個。這個狀態碼允許客戶端在獲取資源時在請求的元信息(請求頭字段數據)中設 置先決條件,以此避免該請求方法被應用到其希望的內容以外的資源上。

413 Request Entity Too Large

服務器拒絕處理當前請求,因爲該請求提交的實體數據大小超過了服務器願意或者能夠處理的範圍。此種情況下,服務器可以關閉連接以免客戶端繼續發送此 請求。
如果這個狀況是臨時的,服務器應當返回一個 Retry-After 的響應頭,以告知客戶端可以在多少時間以後重新嘗試。

414 Request-URI Too Long

請求的 URI 長度超過了服務器能夠解釋的長度,因此服務器拒絕對該請求提供服務。這比較少見,通常的情況包括:
* 本應使用 POST 方法的表單提交變成了 GET 方法,導致查詢字符串(Query String)過長。
* 重定向 URI “黑洞”,例如每次重定向把舊的 URI 作爲新的 URI 的一部分,導致在若干次重定向後 URI 超長。
* 客戶端正在嘗試利用某些服務器中存在的安全漏洞攻擊服務器。這類服務器使用固定長度的緩衝讀取或操作請求的 URI,當 GET 後的參數超過某個數值後,可能會產生緩衝區溢出,導致任意代碼被執行{{cite web|title=HTTP Get存在緩衝溢出漏洞|url=http://www.xfocus.net/vuls/200208/2839.html}}。沒有此類 漏洞的服務器,應當返回414狀態碼。

415 Unsupported Media Type

對於當前請求的方法和所請求的資源,請求中提交的實體並不是服務器中所支持的格式,因此請求被拒絕。

416 Requested Range Not Satisfiable

如果請求中包含了 Range 請求頭,並且 Range 中指定的任何數據範圍都與當前資源的可用範圍不重合,同時請求中又沒有定義 If-Range 請求頭,那麼服務器就應當返回416狀態碼。
假 如 Range 使用的是字節範圍,那麼這種情況就是指請求指定的所有數據範圍的首字節位置都超過了當前資源的長度。服務器也應當在返回416狀態碼的同時,包含一個 Content-Range 實體頭,用以指明當前資源的長度。這個響應也被禁止使用 multipart/byteranges 作爲其 Content-Type。

417 Expectation Failed

在請求頭 Expect 中指定的預期內容無法被服務器滿足,或者這個服務器是一個代理服務器,它有明顯的證據證明在當前路由的下一個節點上,Expect 的內容無法被滿足。

421 There are too many connections from your internet address

從當前客戶端所在的IP地址到服務器的連接數超過了服務器許可的最大範圍。通常,這裏的IP地址指的是從服務器上看到的客戶端地址(比如用戶的網關 或者代理服務器地址)。在這種情況下,連接數的計算可能涉及到不止一個終端用戶。

422 Unprocessable Entity

請求格式正確,但是由於含有語義錯誤,無法響應。(RFC 4918 WebDAV)

423 Locked

當前資源被鎖定。(RFC 4918 WebDAV)

424 Failed Dependency

由於之前的某個請求發生的錯誤,導致當前請求失敗,例如 PROPPATCH。(RFC 4918 WebDAV)

425 Unordered Collection

WebDav Advanced Collections 草案中定義,但是未出現在《WebDAV 順序集協議》(RFC 3658)中。

426 Upgrade Required

客戶端應當切換到TLS/1.0。(RFC 2817)

449 Retry With

由微軟擴展,代表請求應當在執行完適當的操作後進行重試。

5xx 服務器錯誤

這類狀態碼代表了服務器在處理請求的過程中有錯誤或者異常狀態發生,也有可能是服務器意識到以當前的軟硬件資源無法完成對請求的處理。除非這是一個 HEAD 請求,否則服務器應當包含一個解釋當前錯誤狀態以及這個狀況是臨時的還是永久的解釋信息實體。瀏覽器應當向用戶展示任何在當前響應中被包含的實體。
這些狀態碼適用於任何響應方法。

500 Internal Server Error

服務器遇到了一個未曾預料的狀況,導致了它無法完成對請求的處理。一般來說,這個問題都會在服務器的程序碼出錯時出現。

501 Not Implemented

服務器不支持當前請求所需要的某個功能。當服務器無法識別請求的方法,並且無法支持其對任何資源的請求。

502 Bad Gateway

作爲網關或者代理工作的服務器嘗試執行請求時,從上游服務器接收到無效的響應。

503 Service Unavailable

由於臨時的服務器維護或者過載,服務器當前無法處理請求。這個狀況是臨時的,並且將在一段時間以後恢復。如果能夠預計延遲時間,那麼響應中可以包含 一個 Retry-After 頭用以標明這個延遲時間。如果沒有給出這個 Retry-After 信息,那麼客戶端應當以處理500響應的方式處理它。
注意:503狀態碼的存在並不意味着服務器在過載的時候必須使用它。某些服務器只不過是希望拒絕客戶端的連接。

504 Gateway Timeout

作爲網關或者代理工作的服務器嘗試執行請求時,未能及時從上游服務器(URI標識出的服務器,例如HTTP、FTP、LDAP)或者輔助服務器(例 如DNS)收到響應。
注意:某些代理服務器在DNS查詢超時時會返回400或者500錯誤

505 HTTP Version Not Supported

服務器不支持,或者拒絕支持在請求中使用的 HTTP 版本。這暗示着服務器不能或不願使用與客戶端相同的版本。響應中應當包含一個描述了爲何版本不被支持以及服務器支持哪些協議的實體。

506 Variant Also Negotiates

由《透明內容協商協議》(RFC 2295)擴展,代表服務器存在內部配置錯誤:被請求的協商變元資源被配置爲在透明內容協商中使用自己,因此在一個協商處理中不是一個合適的重點。

507 Insufficient Storage

服務器無法存儲完成請求所必須的內容。這個狀況被認爲是臨時的。WebDAV (RFC 4918)

509 Bandwidth Limit Exceeded

服務器達到帶寬限制。這不是一個官方的狀態碼,但是仍被廣泛使用。

510 Not Extended

獲取資源所需要的策略並沒有沒滿足。(RFC 2774)

    Tomcat 服務器有一系列可配置的組件構成,這些組件與 %CATALINA_HOME%\conf\server.xml 文件中的各元素相對應,組件的配置也是通過 server.xml 文件中的元素來完成的。這些元素可以分爲以下 4 類。

    (1) 頂層元素

    包括<Server> 和 <Service> 元素. <Server> 元素使整個配置文件的元素, <Service> 元素表示了一個與引擎相關的一組連接器.

    Server 元素

    Server 元素是 server.xml 的根元素, 表示整個的 Catalina Servlet 容器, 它的屬性表示了作爲一個整體的 Servlet 容器的特性.

    Server 元素的屬性描述如下表:

屬性描述className指定實現了 org.apache.catalina.Server 接口的類名. 如果沒有類名, 將使用標準的實現. 標準的實現是 org.apache.catalina.core.StandardServerport指定 Tomcat 服務監聽 shutdown 命令的 TCP/IP 端口號. 關閉 Tomcat 服務時, 必須從當前正在運行 Tomcat 實例的服務器上發出 shutdown 命令. 該屬性是必須的.shutdown指定通過 TCP/IP 連接發送到 Tomcat 服務器監聽 shutdown 命令的端口上的命令字符串, 用於關閉 Tomcat 服務器, 該命令是必須的.

    下面是 Server 元素的一個例子:

    <Server port="8005" shutdown="SHUTDOWN">

在 Server 元素中, 可以嵌套 Service 元素和 GlobalNamingResources 元素.

Service 元素

Service 元素表示了一個或多個連接器 (Connector) 組件的聯合, 這些組件共享一個單獨的引擎 (Engine) 組件來處理到來的請求. 一個或多個 Service 元素可以被嵌套在 Server 元素中.

Service 元素的屬性描述如下表:

屬性 描述 className指定實現了 org.apache.catalina.Service 接口的類名. 如果沒有指定類名, 將使用標準的實現. 標準的實現類是 org.apache.catalina.core.StandardService name指定 Service 的名字. 如果你應用的是標準的 Catalina 組件, 指定的名字將被包含在日誌消息中. 和特定的 Server 元素相關的每一個 Service 元素的名字必須是唯一的. 該屬性是必須的.

    下面是 Service 元素的一個例子:

<Service name="Catalina">

在 Service 元素中, 可以嵌套 Connector 元素和 Engine 元素.

(2) 連接器

   充當外部客戶端發送請求到一個特定的 Service (或者從 Service 接收響應) 之間的接口.

HTTP 連接器

HTTP Connector 元素表示了支持 HTTP/1.1 協議的連接器組件. 它使 Catalina 可以作爲一個獨立的 Web 服務器運行. HTTP 連接器組件的實例在 Tomcat 服務器的指定 TCP 端口上監聽, 等待客戶端連接的到來.

Connector 元素的公共屬性描述如下表:

屬性描述allowTrace這是布爾類型的值, 用於指定是否允許 HTTP 的 TRACE 方法. 該屬性的默認值爲 false.emptySessionPath如果設置爲 true, 用於會話 cookie 的所有路徑都將被設置爲/. 該屬性的默認值爲 false.enableLookups如果你想調用 request.getRemoteHost() 方法來執行 DNS 查詢, 以返回遠程客戶端實際的主機名, 可以將這個屬性設置爲 true. 將該屬性設置爲 false, 將跳過 DNS 查詢, 而直接返回字符串形式的 IP 地址 (也因此改善了性能). 默認情況下, DNS 查詢是允許的.maxPostSize以字節爲單位指定將被容器 FORM URL 參數解析處理的 POST 請求的最大尺寸. 如果沒有指定該屬性, 這個屬性將被設置爲 2097152protocol該屬性的值必須是 HTTTP/1.1, 這也是默認值. 如果使用 AJP 處理器, 則該屬性的值必須是 AJP/1.3proxyName如果這個連接器正在一個代理配置中使用, 那麼配置這個屬性, 指定當調用 request.getServerName() 方法時, 返回的服務器名字, 關於代理支持的更多信息, 請參見 %CATALINA_HOME%/webapps/tomcat-doc/config/http.html#Proxy.SupportproxyPort如果這個連接器正在一個代理配置中使用, 那麼配置這個屬性, 指定當調用 request.getServerPort() 方法時, 返回的服務器端口號.redirectPort如果這個連接器支持非 SSL 的請求, 而此時接收到一個需要 SSL 傳輸的請求, 那麼 Catalina 容器會自動將這個請求重定向到該屬性所指定的端口號scheme設置協議得名字, 這個名字將在調用 request.getScheme() 方法時返回. 例如, 你可以爲一個 SSL 連接器設置這個屬性爲 "https". 該屬性的默認值是 "http"secure如果你希望對接收到的請求調用 request.isSecure() 方法是返回 true, 那麼可以設置這個屬性爲 true (你可能希望在 SSL 連接器上這樣做). 該屬性的默認值是 falseURIEncoding指定用於解碼 URI 字節的字符編碼, 在 %xx 後解碼 URL. 如果沒有指定該屬性, 將使用 ISO-8859-1

(3) 容器

   負責處理客戶端的請求, 並生成響應結果的組件. 容器類元素有 <Engine>, <Host> 和 <Context>, 其中 Engine 組件爲特定的 Service 處理所有請求, Host 組件爲特定虛擬主機處理所有請求, Context 組件爲指定的的 Web 應用程序處理所有請求.

(4) 嵌套元素

    表示可以在容器類元素中嵌套的元素. 一些元素可以在任何容器類中嵌套, 而另一些則只能在 <Context> 元素中嵌套. 嵌套的元素包括 <Loader>, <GlobalNamingResource>, <Resource>, <Manager>, <Realm>, <Resources> 和 <Valve> 等元素.

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章