1. 程式人生 > >HTTP狀態碼大全

HTTP狀態碼大全

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)表示所請求的文件要通過定位頭資訊中的代理伺服器獲得。這個狀態碼是新加入 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/代理伺服器認證要求) 407 (SC_PROXY_AUTHENTICATION_REQUIRED)與401狀態有些相似,只是這個狀態用於代理伺服器。該狀態指出客戶端必須通過代理伺服器的認證。代理伺服器返回一個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的。