最近研究了java的HttpURLConnection的用法, 這裏簡單的作一下記錄:html
Java中可使用HttpURLConnection來請求WEB資源。java
一、 URL請求的類別web
分爲二類,GET與POST請求。兩者的區別在於:
a:) get請求能夠獲取靜態頁面,也能夠把參數放在URL字串後面,傳遞給servlet,
b:) post與get的不一樣之處在於post的參數不是放在URL字串裏面,而是放在http請求的正文內。數據庫
二、URLConnection的對象問題瀏覽器
URL url = new URL("http://localhost:8080/TestHttpURLConnectionPro.do"); 緩存
URLConnection rulConnection = url.openConnection();// 此處的urlConnection對象其實是根據URL的 安全
// 請求協議(此處是http)生成的URLConnection類 服務器
// 的子類HttpURLConnection,故此處最好將其轉化 網絡
// 爲HttpURLConnection類型的對象,以便用到 併發
// HttpURLConnection更多的API.以下:
HttpURLConnection httpUrlConnection = (HttpURLConnection) rulConnection;
三、HttpURLConnection對象參數問題
httpUrlConnection.setDoOutput(true);
// 設置是否從httpUrlConnection讀入,默認狀況下是true;
httpUrlConnection.setDoInput(true);
// Post 請求不能使用緩存
httpUrlConnection.setUseCaches(false);
// 設定傳送的內容類型是可序列化的java對象
// (若是不設此項,在傳送序列化對象時,當WEB服務默認的不是這種類型時可能拋java.io.EOFException)
httpUrlConnection.setRequestProperty("Content-type", "application/x-java-serialized-object");
// 設定請求的方法爲"POST",默認是GET
httpUrlConnection.setRequestMethod("POST");
// 鏈接,從上述第2條中url.openConnection()至此的配置必需要在connect以前完成,
httpUrlConnection.connect();
四、HttpURLConnection鏈接問題
OutputStream outStrm = httpUrlConnection.getOutputStream();
五、HttpURLConnection寫數據與發送數據問題
ObjectOutputStream objOutputStrm = new ObjectOutputStream(outStrm);
// 向對象輸出流寫出數據,這些數據將存到內存緩衝區中
objOutputStrm.writeObject(new String("我是測試數據"));
// 刷新對象輸出流,將任何字節都寫入潛在的流中(些處爲ObjectOutputStream)
objOutputStm.flush();
// 關閉流對象。此時,不能再向對象輸出流寫入任何數據,先前寫入的數據存在於內存緩衝區中,
// 在調用下邊的getInputStream()函數時才把準備好的http請求正式發送到服務器
objOutputStm.close();
// 調用HttpURLConnection鏈接對象的getInputStream()函數,
// 將內存緩衝區中封裝好的完整的HTTP請求電文發送到服務端。
InputStream inStrm = httpConn.getInputStream(); // <===注意,實際發送請求的代碼段就在這裏
// 上邊的httpConn.getInputStream()方法已調用,本次HTTP請求已結束,下邊向對象輸出流的輸出已無心義,
// 既使對象輸出流沒有調用close()方法,下邊的操做也不會向對象輸出流寫入任何數據.
// 所以,要從新發送數據時須要從新建立鏈接、從新設參數、從新建立流對象、從新寫數據、
// 從新發送數據(至因而否不用從新這些操做須要再研究)
objOutputStm.writeObject(new String(""));
httpConn.getInputStream();
六、post參數的方法
OutputStream os = httpConn.getOutputStream();
String param = new String();
param = "CorpID=" + CorpID + "&LoginName=" + LoginName+ "&send_no=" + phoneNumber + "&msg=" + java.net.URLEncoder.encode(msg,"GBK"); ; os.write(param.getBytes());
七、超時設置,防止 網絡異常的狀況下,可能會致使程序僵死而不繼續往下執行
System.setProperty("sun.net.client.defaultConnectTimeout", "30000");
System.setProperty("sun.net.client.defaultReadTimeout", "30000");
其中: sun.net.client.defaultConnectTimeout:鏈接主機的超時時間(單位:毫秒)
sun.net.client.defaultReadTimeout:從主機讀取數據的超時時間(單位:毫秒)
JDK 1.5之前的版本,只能經過設置這兩個系統屬性來控制網絡超時。在1.5中,還可使用HttpURLConnection的父類URLConnection的如下兩個方法:
setConnectTimeout:設置鏈接主機超時(單位:毫秒)
setReadTimeout:設置從主機讀取數據超時(單位:毫秒)
例如:
HttpURLConnection urlCon = (HttpURLConnection)url.openConnection();
urlCon.setConnectTimeout(30000);
urlCon.setReadTimeout(30000);
狀態代碼與狀態描述
狀態代碼由 3 位數字組成, 表示請求是否被理解或被知足,狀態描述給出了關於狀態碼的簡短的文字描述。狀態碼的第一個數字定義了響應類別,後面兩位數字沒有具體分類。第一個數字有 5 種取值,以下所示。
- 1xx:指示信息——表示請求已經接受,繼續處理
- 2xx:成功——表示請求已經被成功接收、理解、接受。
- 3xx:重定向——要完成請求必須進行更進一步的操做
- 4xx:客戶端錯誤——請求有語法錯誤或請求沒法實現
- 5xx:服務器端錯誤——服務器未能實現合法的請求。
狀態代碼 | 狀態信息 | 含義 |
100 | Continue | 初始的請求已經接受,客戶應當繼續發送請求的其他部分。(HTTP 1.1新) |
101 | Switching Protocols | 服務器將聽從客戶的請求轉換到另一種協議(HTTP 1.1新) |
200 | OK | 一切正常,對GET和POST請求的應答文檔跟在後面。 |
201 | Created | 服務器已經建立了文檔,Location頭給出了它的URL。 |
202 | Accepted | 已經接受請求,但處理還沒有完成。 |
203 | Non-Authoritative Information | 文檔已經正常地返回,但一些應答頭可能不正確,由於使用的是文檔的拷貝(HTTP 1.1新)。 |
204 | No Content | 沒有新文檔,瀏覽器應該繼續顯示原來的文檔。若是用戶按期地刷新頁面,而Servlet能夠肯定用戶文檔足夠新,這個狀態代碼是頗有用的。 |
205 | Reset Content | 沒有新的內容,但瀏覽器應該重置它所顯示的內容。用來強制瀏覽器清除表單輸入內容(HTTP 1.1新)。 |
206 | Partial Content | 客戶發送了一個帶有Range頭的GET請求,服務器完成了它(HTTP 1.1新)。 |
300 | Multiple Choices | 客戶請求的文檔能夠在多個位置找到,這些位置已經在返回的文檔內列出。若是服務器要提出優先選擇,則應該在Location應答頭指明。 |
301 | Moved Permanently | 客戶請求的文檔在其餘地方,新的URL在Location頭中給出,瀏覽器應該自動地訪問新的URL。 |
302 | Found | 相似於301,但新的URL應該被視爲臨時性的替代,而不是永久性的。注意,在HTTP1.0中對應的狀態信息是「Moved Temporatily」。 出現該狀態代碼時,瀏覽器可以自動訪問新的URL,所以它是一個頗有用的狀態代碼。 注意這個狀態代碼有時候能夠和301替換使用。例如,若是瀏覽器錯誤地請求http://host/~user(缺乏了後面的斜槓),有的服務器返回301,有的則返回302。 嚴格地說,咱們只能假定只有當原來的請求是GET時瀏覽器纔會自動重定向。請參見307。 |
303 | See Other | 相似於301/302,不一樣之處在於,若是原來的請求是POST,Location頭指定的重定向目標文檔應該經過GET提取(HTTP 1.1新)。 |
304 | Not Modified | 客戶端有緩衝的文檔併發出了一個條件性的請求(通常是提供If-Modified-Since頭表示客戶只想比指定日期更新的文檔)。服務器告訴客戶,原來緩衝的文檔還能夠繼續使用。 |
305 | Use Proxy | 客戶請求的文檔應該經過Location頭所指明的代理服務器提取(HTTP 1.1新)。 |
307 | Temporary Redirect | 和 302(Found)相同。許多瀏覽器會錯誤地響應302應答進行重定向,即便原來的請求是POST,即便它實際上只能在POST請求的應答是303時才 能重定向。因爲這個緣由,HTTP 1.1新增了307,以便更加清除地區分幾個狀態代碼:當出現303應答時,瀏覽器能夠跟隨重定向的GET和POST請求;若是是307應答,則瀏覽器只 能跟隨對GET請求的重定向。(HTTP 1.1新) |
400 | Bad Request | 請求出現語法錯誤。 |
401 | Unauthorized | 客戶試圖未經受權訪問受密碼保護的頁面。應答中會包含一個WWW-Authenticate頭,瀏覽器據此顯示用戶名字/密碼對話框,而後在填寫合適的Authorization頭後再次發出請求。 |
403 | Forbidden | 資源不可用。服務器理解客戶的請求,但拒絕處理它。一般因爲服務器上文件或目錄的權限設置致使。 |
404 | Not Found | 沒法找到指定位置的資源。這也是一個經常使用的應答。 |
405 | Method Not Allowed | 請求方法(GET、POST、HEAD、DELETE、PUT、TRACE等)對指定的資源不適用。(HTTP 1.1新) |
406 | Not Acceptable | 指定的資源已經找到,但它的MIME類型和客戶在Accpet頭中所指定的不兼容(HTTP 1.1新)。 |
407 | Proxy Authentication Required | 相似於401,表示客戶必須先通過代理服務器的受權。(HTTP 1.1新) |
408 | Request Timeout | 在服務器許可的等待時間內,客戶一直沒有發出任何請求。客戶能夠在之後重複同一請求。(HTTP 1.1新) |
409 | Conflict | 一般和PUT請求有關。因爲請求和資源的當前狀態相沖突,所以請求不能成功。(HTTP 1.1新) |
410 | Gone | 所請求的文檔已經再也不可用,並且服務器不知道應該重定向到哪個地址。它和404的不一樣在於,返回407表示文檔永久地離開了指定的位置,而404表示因爲未知的緣由文檔不可用。(HTTP 1.1新) |
411 | Length Required | 服務器不能處理請求,除非客戶發送一個Content-Length頭。(HTTP 1.1新) |
412 | Precondition Failed | 請求頭中指定的一些前提條件失敗(HTTP 1.1新)。 |
413 | Request Entity Too Large | 目標文檔的大小超過服務器當前願意處理的大小。若是服務器認爲本身可以稍後再處理該請求,則應該提供一個Retry-After頭(HTTP 1.1新)。 |
414 | Request URI Too Long | URI太長(HTTP 1.1新)。 |
416 | Requested Range Not Satisfiable | 服務器不能知足客戶在請求中指定的Range頭。(HTTP 1.1新) |
500 | Internal Server Error | 服務器遇到了意料不到的狀況,不能完成客戶的請求。 |
501 | Not Implemented | 服務器不支持實現請求所須要的功能。例如,客戶發出了一個服務器不支持的PUT請求。 |
502 | Bad Gateway | 服務器做爲網關或者代理時,爲了完成請求訪問下一個服務器,但該服務器返回了非法的應答。 |
503 | Service Unavailable | 服務器因爲維護或者負載太重未能應答。例如,Servlet可能在數據庫鏈接池已滿的狀況下返回503。服務器返回503時能夠提供一個Retry-After頭。 |
504 | Gateway Timeout | 由做爲代理或網關的服務器使用,表示不能及時地從遠程服務器得到應答。(HTTP 1.1新) |
505 | HTTP 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)