jsp Servlet基礎入門學習：HTTP應答狀態

js|servlet      7.1 狀態碼概述
　　  Web伺服器響應瀏覽器或其他客戶程式的請求時，其應答一般由以下幾個部分組成：一個狀態行，幾個應答頭，一個空行，內容文檔。下面是一個最簡單的應答：
HTTP/1.1 200 OK
Content-Type: text/plain

Hello World

　　 狀態行包含HTTP版本、狀態碼、與狀態碼對應的簡短說明資訊。在大多數情況下，除了Content-Type之外的所有應答頭都是可選的。但Content-Type是必需的，它描述的是後面文檔的MIME類型。雖然大多數應答都包含一個文檔，但也有一些不包含，例如對HEAD請求的應答永遠不會附帶文檔。有許多狀態碼實際上用來標識一次失敗的請求，這些應答也不包含文檔（或只包含一個簡短的錯誤資訊說明）。

　　 Servlet可以利用狀態碼來實現許多功能。例如，可以把使用者重新導向到另一個網站；可以指示出後面的文檔是圖片、PDF檔案或HTML檔案；可以告訴使用者必須提供密碼才能訪問文檔；等等。這一部分我們將具體討論各種狀態碼的含義以及利用這些代碼可以做些什麼。

　　 7.2 設定狀態碼

　　 如前所述，HTTP應答狀態行包含HTTP版本、狀態碼和對應的狀態資訊。由於狀態資訊直接和狀態碼相關，而HTTP版本又由伺服器確定，因此需要Servlet設定的只有一個狀態碼。

　　 Servlet設定狀態碼一般使用HttpServletResponse的setStatus方法。setStatus方法的參數是一個整數（即狀態碼），不過為了使得代碼具有更好的可讀性，可以用HttpServletResponse中定義的常量來避免直接使用整數。這些常量根據HTTP 1.1中的標準狀態資訊命名，所有的名字都加上了SC首碼（Status Code的縮寫）並大寫，同時把空格轉換成了底線。也就是說，與狀態碼404對應的狀態資訊是“Not Found”，則HttpServletResponse中的對應常量名字為SC_NOT_FOUND。但有兩個例外：和狀態碼302對應的常量根據HTTP 1.0命名，而307沒有對應的常量。

　　 設定狀態碼並非總是意味著不要再返迴文檔。例如，雖然大多數伺服器返回404應答時會輸出簡單的“File Not Found”資訊，但Servlet也可以定製這個應答。不過，定製應答時應當在通過PrintWriter發送任何內容之前先調用response.setStatus。

　　 雖然設定狀態碼一般使用的是response.setStauts(int)方法，但為了簡單起見，HttpServletResponse為兩種常見的情形提供了專用方法：sendError方法產生一個404應答，同時產生一個簡短的HTML錯誤資訊文檔；sendRedirect方法產生一個302應答，同時在Location頭中指示新文檔的URL。

　　 7.3 HTTP 1.1狀態碼及其含義

　　 下表顯示了常見的HTTP 1.1狀態碼以及它們對應的狀態資訊和含義。

　　 應當謹慎地使用那些只有HTTP 1.1支援的狀態碼，因為許多瀏覽器還只能夠支援HTTP 1.0。如果你使用了HTTP 1.1特有的狀態碼，最好能夠檢查一下請求的HTTP版本號碼（通過HttpServletRequest的getProtocol方法）。 狀態碼 狀態資訊 含義
100 Continue 初始的請求已經接受，客戶應當繼續發送請求的其餘部分。（HTTP 1.1新）
101 Switching Protocols 伺服器將遵從客戶的請求轉換到另外一種協議（HTTP 1.1新）
200 OK 一切正常，對GET和POST請求的應答文檔跟在後面。如果不用setStatus設定狀態碼，Servlet預設使用202狀態碼。
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”，而HttpServletResponse中相應的常量是SC_MOVED_TEMPORARILY，而不是SC_FOUND。
出現該狀態碼時，瀏覽器能夠自動訪問新的URL，因此它是一個很有用的狀態碼。為此，Servlet提供了一個專用的方法，即sendRedirect。使用response.sendRedirect(url)比使用response.setStatus(response.SC_MOVED_TEMPORARILY)和response.setHeader("Location",url)更好。這是因為：

首先，代碼更加簡潔。
第二，使用sendRedirect，Servlet會自動構造一個包含新連結的頁面（用於那些不能自動重新導向的老式瀏覽器）。
最後，sendRedirect能夠處理相對URL，自動把它們轉換成絕對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頭所指明的Proxy 伺服器提取（HTTP 1.1新）。
307 Temporary Redirect 和302（Found）相同。許多瀏覽器會錯誤地響應302應答進行重新導向，即使原來的請求是POST，即使它實際上只能在POST請求的應答是303時才能重新導向。由於這個原因，HTTP 1.1新增了307，以便更加清除地區分幾個狀態碼：當出現303應答時，瀏覽器可以跟隨重新導向的GET和POST請求；如果是307應答，則瀏覽器只能跟隨對GET請求的重新導向。
注意，HttpServletResponse中沒有為該狀態碼提供相應的常量。（HTTP 1.1新）

400 Bad Request 請求出現語法錯誤。
401 Unauthorized 客戶試圖未經授權訪問受密碼保護的頁面。應答中會包含一個WWW-Authenticate頭，瀏覽器據此顯示使用者名稱字/密碼對話方塊，然後在填寫合適的Authorization頭後再次發出請求。
403 Forbidden 資源不可用。伺服器理解客戶的請求，但拒絕處理它。通常由於伺服器上檔案或目錄的使用權限設定導致。
404 Not Found 無法找到指定位置的資源。這也是一個常用的應答，HttpServletResponse專門提供了相應的方法：sendError(message)。
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，表示客戶必須先經過Proxy 伺服器的授權。（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新）

　　 7.4 執行個體：訪問多個搜尋引擎

　　 下面這個例子用到了除200之外的另外兩個常見狀態碼：302和404。302通過sendRedirect方法設定，404通過sendError方法設定。

　　 在這個例子中，首先出現的HTML表單用來選擇搜尋引擎、搜尋字串、每頁顯示的搜尋結果數量。表單提交後，Servlet提取這三個變數，按照所選擇的搜尋引擎的要求構造出包含這些變數的URL，然後把使用者重新導向到這個URL。如果使用者不能正確地選擇搜尋引擎，或者利用其他表單發送了一個不認識的搜尋引擎名字，則返回一個提示搜尋引擎找不到的404頁面。

　　 SearchEngines.java

　　 注意：這個Servlet要用到後面給出的SearchSpec類，SearchSpec的功能是構造適合不同搜尋引擎的URL。

package hall;

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.net.*;

public class SearchEngines extends HttpServlet {
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
// getParameter自動解碼URL編碼的查詢字串。由於我們
// 要把查詢字串發送給另一個伺服器，因此再次使用
// URLEncoder進行URL編碼
String searchString =
URLEncoder.encode(request.getParameter("searchString"));
String numResults =
request.getParameter("numResults");
String searchEngine =
request.getParameter("searchEngine");
SearchSpec[] commonSpecs = SearchSpec.getCommonSpecs();
for(int i=0; i＜commonSpecs.length; i++) {
SearchSpec searchSpec = commonSpecs[i];
if (searchSpec.getName().equals(searchEngine)) {
String url =
response.encodeURL(searchSpec.makeURL(searchString,
numResults));
response.sendRedirect(url);
return;
}
}
response.sendError(response.SC_NOT_FOUND,
"No recognized search engine specified.");
}

public void doPost(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
doGet(request, response);
}
}


　　 SearchSpec.java
package hall;

class SearchSpec {
private String name, baseURL, numResultsSuffix;

private static SearchSpec[] commonSpecs =
{ new SearchSpec("google",
"http://www.google.com/search?q=",
"&num="),
new SearchSpec("infoseek",
"http://infoseek.go.com/Titles?qt=",
"&nh="),
new SearchSpec("lycos",
"http://lycospro.lycos.com/cgi-bin/pursuit?query=",
"&maxhits="),
new SearchSpec("hotbot",
"http://www.hotbot.com/?MT=",
"&DC=")
};

public SearchSpec(String name,
String baseURL,
String numResultsSuffix) {
this.name = name;
this.baseURL = baseURL;
this.numResultsSuffix = numResultsSuffix;
}

public String makeURL(String searchString, String numResults) {
return(baseURL + searchString + numResultsSuffix + numResults);
}

public String getName() {
return(name);
}

public static SearchSpec[] getCommonSpecs() {
return(commonSpecs);
}
}

　　 SearchEngines.html

　　 下面是調用上述Servlet的HTML表單。

＜!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"＞
＜HTML＞
＜HEAD＞
＜TITLE＞訪問多個搜尋引擎＜/TITLE＞
＜/HEAD＞

＜BODY BGCOLOR="#FDF5E6"＞

＜FORM ACTION="/servlet/hall.SearchEngines"＞
＜CENTER＞
搜尋索引鍵:
＜INPUT TYPE="TEXT" NAME="searchString"＞＜BR＞
每頁顯示幾個查詢結果:
＜INPUT TYPE="TEXT" NAME="numResults"
VALUE=10 SIZE=3＞＜BR＞
＜INPUT TYPE="RADIO" NAME="searchEngine"
VALUE="google"＞
Google |
＜INPUT TYPE="RADIO" NAME="searchEngine"
VALUE="infoseek"＞
Infoseek |
＜INPUT TYPE="RADIO" NAME="searchEngine"
VALUE="lycos"＞
Lycos |
＜INPUT TYPE="RADIO" NAME="searchEngine"
VALUE="hotbot"＞
HotBot
＜BR＞
＜INPUT TYPE="SUBMIT" VALUE="Search"＞
＜/CENTER＞
＜/FORM＞
＜/BODY＞
＜/HTML＞