HTTP狀態代碼大全

標籤：格式   track   prot   方法   更新   set   定向   程式員   常量   

完整的 HTTP 1.1規範說明書來自於RFC 2616，你可以在http://www.talentdigger.cn/home/link.php?url=d3d3LnJmYy1lZGl0b3Iub3JnLw%3D%3D線上查閱。HTTP 1.1的狀態代碼被標記為新特性，因為許多瀏覽器只支援 HTTP 1.0。你應只把狀態代碼發送給支援 HTTP 1.1的用戶端，支援協議版本可以通過調用request.getRequestProtocol來檢查。

本部分餘下的內容會詳細地介紹 HTTP 1.1中的狀態代碼。這些狀態代碼被分為五大類：

100-199 用於指定用戶端應相應的某些動作。
200-299 用於表示請求成功。
300-399 用於已經移動的檔案並且常被包含在定位頭資訊中指定新的地址資訊。
400-499 用於指出用戶端的錯誤。
500-599 用於支援伺服器錯誤。

HttpServletResponse中的常量代表關聯不同標準訊息的狀態代碼。在servlet程式中，你會更多地用到這些常量的標識來使用狀態代碼。例如：你一般會使用response.setStatus(response.SC_NO_CONTENT)而不是 response.setStatus(204)，因為後者不易理解而且容易導致錯誤。但是，你應當注意到伺服器允許對訊息輕微的改變，而用戶端只注意狀態代碼的數字值。所以伺服器可能只返回 HTTP/1.1 200 而不是 HTTP/1.1 200 OK。

100 (Continue/繼續)
如果伺服器收到頭資訊中帶有100-continue的請求，這是指用戶端詢問是否可以在後續的請求中發送附件。在這種情況下，伺服器用100(SC_CONTINUE)允許用戶端繼續或用417 (Expectation Failed)告訴用戶端不同意接受附件。這個狀態代碼是 HTTP 1.1中新加入的。

101 (Switching Protocols/轉換協議)
101 (SC_SWITCHING_PROTOCOLS)狀態代碼是指伺服器將按照其上的頭資訊變為一個不同的協議。這是 HTTP 1.1中新加入的。

200 (OK/正常)
200 (SC_OK)的意思是一切正常。一般用於相應GET和POST請求。這個狀態代碼對servlet是預設的；如果沒有調用setStatus方法的話，就會得到200。

201 (Created/已建立)
201 (SC_CREATED)表示伺服器在請求的響應中建立了新文檔；應在定位頭資訊中給出它的URL。

202 (Accepted/接受)
202 (SC_ACCEPTED)告訴用戶端請求正在被執行，但還沒有處理完。

203 (Non-Authoritative Information/非官方資訊)
狀態代碼203 (SC_NON_AUTHORITATIVE_INFORMATION)是表示文檔被正常的返回，但是由於正在使用的是文檔副本所以某些回應標頭資訊可能不正確。這是 HTTP 1.1中新加入的。

204 (No Content/無內容)
在並沒有新文檔的情況下，204 (SC_NO_CONTENT)確保瀏覽器繼續顯示先前的文檔。這各狀態代碼對於使用者周期性的重載某一頁非常有用，並且你可以確定先前的頁面是否已經更新。例如，某個servlet可能作如下操作：
int pageVersion =Integer.parseInt(request.getParameter("pageVersion"));
if (pageVersion >;= currentVersion) {
   response.setStatus(response.SC_NO_CONTENT);
} else {
       // Create regular page
}
但是，這種方法對通過重新整理回應標頭資訊或等價的HTML標記自動重載的頁面起作用，因為它會返回一個204狀態代碼停止以後的重載。但基於JavaScript指令碼的自動重載在這種情況下仍然需要能夠起作用。可以閱讀本書7.2 ( HTTP 1.1 Response Headers and Their Meaning/HTTP 1.1回應標頭資訊以及他們的意義)部分的詳細討論。

205 (Reset Content/重設內容)
重設內容205 (SC_RESET_CONTENT)的意思是雖然沒有新文檔但瀏覽器要重設文檔顯示。這個狀態代碼用於強迫瀏覽器清除表單域。這是 HTTP 1.1中新加入的。

206 (Partial Content/局部內容)
206 (SC_PARTIAL_CONTENT)是在伺服器完成了一個包含Range頭資訊的局部請求時被發送的。這是 HTTP 1.1中新加入的。

300 (Multiple Choices/多重選取)
300 (SC_MULTIPLE_CHOICES)表示被請求的文檔可以在多個地方找到，並將在返回的文檔中列出來。如果伺服器有首選設定，喜好設定將會被列於定位回應標頭資訊中。

301 (Moved Permanently)
301 (SC_MOVED_PERMANENTLY)狀態是指所請求的文檔在別的地方；文檔新的URL會在定位回應標頭資訊中給出。瀏覽器會自動連接到新的URL。

302 (Found/找到)
與301有些類似，只是定位頭資訊中所給的URL應被理解為臨時交換地址而不是永久的。注意：在 HTTP 1.0中，訊息是臨時移動(Moved Temporarily)的而不是被找到，因此HttpServletResponse中的常量是SC_MOVED_TEMPORARILY不是我們以為的SC_FOUND。

注意
代表狀態代碼302的常量是SC_MOVED_TEMPORARILY而不是SC_FOUND。

狀態代碼302是非常有用的因為瀏覽器自動連接在定為回應標頭資訊中給出的新URL。這非常有用，而且為此有一個專門的方法——sendRedirect。使用response.sendRedirect(url)比調用response.setStatus(response.SC_MOVED_TEMPORARILY)和response.setHeader("Location", url)多幾個好處。首先，response.sendRedirect(url)方法明顯要簡單和容易。第二，servlet自動建立一頁儲存這一串連以提供給那些不能自動轉向的瀏覽器顯示。最後，在servlet 2.2版本（J2EE中的版本）中，sendRedirect能夠處理相對路徑，自動轉換為絕對路徑。但是你只能在2.1版本中使用絕對路徑。

如果你將使用者轉向到網站的另一頁中，你要用 HttpServletResponse 中的 encodeURL 方法傳送URL。這麼做可預防不斷使用基於URL重寫的會話跟蹤的情況。URL重寫是一種在你的網站跟蹤不使用 cookies 的使用者的方法。這是通過在每一個URL尾部附加路徑資訊實現的，但是 servlet 會話跟蹤API會自動的注意這些細節。會話跟蹤在第九章討論，並且養成使用 encodeURL 的習慣會使以後添加會話跟蹤的功能更容易很多。

核心技巧
如果你將使用者轉向到你的網站的其他頁面，用 response.sendRedirect(response.encodeURL(url)) 的方式事先計劃好會話跟蹤(session tracking)要比只是調用 response.sendRedirect(url) 好的多。

這個狀態代碼有時可以與301交換使用。例如，如果你錯誤的訪問了http://www.talentdigger.cn/home/link.php?url=aG9zdC9%2BdXNlcg%3D%3D（路徑資訊不完整），有些伺服器就會回複301狀態代碼而有些則回複302。從技術上說，如果最初的請求是GET瀏覽器只是被假定自動轉向。如果想瞭解更多細節，請看狀態代碼307的討論。

303 (See Other/參見其他資訊)
這個狀態代碼和 301、302 相似，只是如果最初的請求是 POST，那麼新文檔（在定位頭資訊中給出）藥用 GET 找回。這個狀態代碼是新加入 HTTP 1.1中的。

304 (Not Modified/為修正)
當用戶端有一個緩衝的文檔，通過提供一個 If-Modified-Since 頭資訊可指出用戶端只希望文檔在指定日期之後有所修改時才會重載此文檔，用這種方式可以進行有條件的請求。304 (SC_NOT_MODIFIED)是指緩衝的版本已經被更新並且用戶端應重新整理文檔。另外，伺服器將返回請求的文檔及狀態代碼 200。servlet一般情況下不會直接設定這個狀態代碼。它們會實現getLastModified方法並根據修正日期讓預設服務方法處理有條件的請求。這個方法的常式已在2.8部分(An Example Using Servlet Initialization and Page Modification Dates/一個使用servlet初始化和頁面修正日期的例子)給出。

305 (Use Proxy/使用代理)
305 (SC_USE_PROXY)表示所請求的文檔要通過定位頭資訊中的Proxy 伺服器獲得。這個狀態代碼是新加入 HTTP 1.1中的。

307 (Temporary Redirect/臨時重新導向)
瀏覽器處理307狀態的規則與302相同。307狀態被加入到 HTTP 1.1中是由於許多瀏覽器在收到302響應時即使是原始訊息為POST的情況下仍然執行了錯誤的轉向。只有在收到303響應時才假定瀏覽器會在POST請求時重新導向。添加這個新的狀態代碼的目的很明確：在響應為303時按照GET和POST請求轉向；而在307響應時則按照GET請求轉向而不是POST請求。注意：由於某些原因在HttpServletResponse中還沒有與這個狀態對應的常量。該狀態代碼是新加入HTTP 1.1中的。

注意
在 HttpServletResponse 中沒有 SC_TEMPORARY_REDIRECT 常量，所以你只能顯示的使用307狀態代碼。

400 (Bad Request/錯誤請求)
400 (SC_BAD_REQUEST)指出用戶端請求中的語法錯誤。

401 (Unauthorized/未授權)
401 (SC_UNAUTHORIZED)表示用戶端在授權頭資訊中沒有有效身份資訊時訪問受到密碼保護的頁面。這個響應必須包含一個WWW-Authenticate的授權資訊頭。例如，在本書4.5部分中的“Restricting Access to Web Pages./限制訪問Web頁。”

403 (Forbidden/禁止)
403 (SC_FORBIDDEN)的意思是除非擁有授權否則伺服器拒絕提供所請求的資源。這個狀態經常會由於伺服器上的損壞檔案或目錄許可而引起。

404 (Not Found/未找到)
404 (SC_NOT_FOUND)狀態每個網路程式員可能都遇到過，他告訴用戶端所給的地址無法找到任何資源。它是表示“沒有所訪問頁面”的標準方式。這個狀態代碼是常用的響應並且在HttpServletResponse類中有專門的方法實現它：sendError("message")。相對於setStatus使用sendError得好處是：伺服器會自動產生一個錯誤頁來顯示錯誤資訊。但是，Internet Explorer 5瀏覽器卻預設忽略你發揮的錯誤頁面並顯示其自訂的錯誤提示頁面，雖然微軟這麼做違反了 HTTP 規範。要關閉此功能，在工具菜單裡，選擇Internet選項，進入進階標籤頁，並確認“顯示友好的 HTTP 錯誤資訊”選項（在我的瀏覽器中是倒數第8各選項）沒有被選。但是很少有使用者知道此選項，因此這個特性被IE5隱藏了起來使使用者無法看到你所返回給使用者的資訊。而其他主流瀏覽器及IE4都完全的顯示伺服器產生的錯誤提示頁面。可以參考圖6-3及6-4中的例子。

核心警告
預設情況下，IE5忽略服務端產生的錯誤提示頁面。

405 (Method Not Allowed/方法未允許)
405 (SC_METHOD_NOT_ALLOWED)指出要求方法(GET, POST, HEAD, PUT, DELETE, 等)對某些特定的資源不允許使用。該狀態代碼是新加入 HTTP 1.1中的。

406 (Not Acceptable/無法訪問)
406 (SC_NOT_ACCEPTABLE)表示請求資源的MIME類型與用戶端中Accept頭資訊中指定的類型不一致。見本書7.2部分中的表7.1(HTTP 1.1 Response Headers and Their Meaning/HTTP 1.1回應標頭資訊以及他們的意義)中對MIME類型的介紹。406是新加入 HTTP 1.1中的。

407 (Proxy Authentication Required/Proxy 伺服器認證要求)
407 (SC_PROXY_AUTHENTICATION_REQUIRED)與401狀態有些相似，只是這個狀態用於Proxy 伺服器。該狀態指出用戶端必須通過Proxy 伺服器的認證。Proxy 伺服器返回一個Proxy-Authenticate回應標頭資訊給用戶端，這會引起用戶端使用帶有Proxy-Authorization請求的頭資訊重新串連。該狀態代碼是新加入 HTTP 1.1中的。

408 (Request Timeout/請求逾時)
408 (SC_REQUEST_TIMEOUT)是指服務端等待用戶端發送請求的時間過長。該狀態代碼是新加入 HTTP 1.1中的。

409 (Conflict/衝突)
該狀態通常與PUT請求一同使用，409 (SC_CONFLICT)狀態常被用於試圖上傳版本不正確的檔案時。該狀態代碼是新加入 HTTP 1.1中的。

410 (Gone/已經不存在)
410 (SC_GONE)告訴用戶端所請求的文檔已經不存在並且沒有更新的地址。410狀態不同於404，410是在指導文檔已被移走的情況下使用，而404則用於未知原因的無法訪問。該狀態代碼是新加入 HTTP 1.1中的。

411 (Length Required/需要資料長度)
411 (SC_LENGTH_REQUIRED)表示伺服器不能處理請求（假設為帶有附件的POST請求），除非用戶端發送Content-Length頭資訊指出發送給伺服器的資料的大小。該狀態是新加入 HTTP 1.1的。

412 (Precondition Failed/先決條件錯誤)
412 (SC_PRECONDITION_FAILED)狀態指出要求標頭資訊中的某些先決條件是錯誤的。該狀態是新加入 HTTP 1.1的。

413 (Request Entity Too Large/請求實體過大)
413 (SC_REQUEST_ENTITY_TOO_LARGE)告訴用戶端現在所請求的文檔比伺服器現在想要處理的要大。如果伺服器認為能夠過一段時間處理，則會包含一個Retry-After的回應標頭資訊。該狀態是新加入 HTTP 1.1的。

414 (Request URI Too Long/請求URI過長)
414 (SC_REQUEST_URI_TOO_LONG)狀態用於在URI過長的情況時。這裡所指的“URI”是指URL中主機、網域名稱及連接埠號碼之後的內容。例如：在URL--http://www.y2k-disaster.com:8080/we/look/silly/now/中URI是指/we/look/silly/now/。該狀態是新加入 HTTP 1.1的。

415 (Unsupported Media Type/不支援的媒體格式)
415 (SC_UNSUPPORTED_MEDIA_TYPE)意味著請求所帶的附件的格式類型伺服器不知道如何處理。該狀態是新加入 HTTP 1.1的。

416 (Requested Range Not Satisfiable/請求範圍無法滿足)
416表示用戶端包含了一個伺服器無法滿足的Range頭資訊的請求。該狀態是新加入 HTTP 1.1的。奇怪的是，在servlet 2.1版本API的HttpServletResponse中並沒有相應的常量代表該狀態。

注意
在servlet 2.1的規範中，類HttpServletResponse並沒有SC_REQUESTED_RANGE_NOT_SATISFIABLE 這樣的常量，所以你只能直接使用416。在servlet 2.2版本之後都包含了此常量。

417 (Expectation Failed/期望失敗)
如果伺服器得到一個帶有100-continue值的Expect要求標頭資訊，這是指用戶端正在詢問是否可以在後面的請求中發送附件。在這種情況下，伺服器也會用該狀態(417)告訴瀏覽器伺服器不接收該附件或用100 (SC_CONTINUE)狀態告訴用戶端可以繼續發送附件。該狀態是新加入 HTTP 1.1的。

500 (Internal Server Error/內部伺服器錯誤)
500 (SC_INTERNAL_SERVER_ERROR) 是常用的“伺服器錯誤”狀態。該狀態經常由CGI程式引起也可能（但願不會如此！）由無法正常啟動並執行或返回頭資訊格式不正確的servlet引起。

501 (Not Implemented/未實現)
501 (SC_NOT_IMPLEMENTED)狀態告訴用戶端伺服器不支援要求中要求的功能。例如，用戶端執行了如PUT這樣的伺服器並不支援的命令。

502 (Bad Gateway/錯誤的網關)
502 (SC_BAD_GATEWAY)被用於充當代理或網關的伺服器；該狀態指出接收伺服器接收到遠端伺服器的錯誤響應。

503 (Service Unavailable/服務無法獲得)
狀態代碼503 (SC_SERVICE_UNAVAILABLE)表示伺服器由於在維護或已經超載而無法響應。例如，如果某些線程或資料庫連接池已經沒有空閑則servlet會返回這個頭資訊。伺服器可提供一個Retry-After頭資訊告訴用戶端什麼時候可以在試一次。

504 (Gateway Timeout/網關逾時)
該狀態也用於充當代理或網關的伺服器；它指出接收伺服器沒有從遠端伺服器得到及時的響應。該狀態是新加入 HTTP 1.1的。

505 (HTTP Version Not Supported/不支援的 HTTP 版本)
505 (SC_HTTP_VERSION_NOT_SUPPORTED)狀態代碼是說伺服器並不支援在請求中所標明 HTTP 版本。該狀態是新加入 HTTP 1.1的。

HTTP狀態代碼大全