直播中
Web服務(wù)器響應(yīng)瀏覽器或其他客戶程序的請求時,其應(yīng)答一般由以下幾個部分組成:一個狀態(tài)行,幾個應(yīng)答頭,一個空行,內(nèi)容文檔。下面是一個最簡單的應(yīng)答:
HTTP/1.1 200 OK
Content-Type: text/plain
Hello World
狀態(tài)行包含HTTP版本、狀態(tài)代碼、與狀態(tài)代碼對應(yīng)的簡短說明信息。在大多數(shù)情況下,除了Content-Type之外的所有應(yīng)答頭都是可選的。但Content-Type是必需的,它描述的是后面文檔的MIME類型。雖然大多數(shù)應(yīng)答都包含一個文檔,但也有一些不包含,例如對HEAD請求的應(yīng)答永遠(yuǎn)不會附帶文檔。有許多狀態(tài)代碼實(shí)際上用來標(biāo)識一次失敗的請求,這些應(yīng)答也不包含文檔(或只包含一個簡短的錯誤信息說明)。
Servlet可以利用狀態(tài)代碼來實(shí)現(xiàn)許多功能。例如,可以把用戶重定向到另一個網(wǎng)站;可以指示出后面的文檔是圖片、PDF文件或HTML文件;可以告訴用戶必須提供密碼才能訪問文檔;等等。這一部分我們將具體討論各種狀態(tài)代碼的含義以及利用這些代碼可以做些什么。
7.2 設(shè)置狀態(tài)代碼
如前所述,HTTP應(yīng)答狀態(tài)行包含HTTP版本、狀態(tài)代碼和對應(yīng)的狀態(tài)信息。由于狀態(tài)信息直接和狀態(tài)代碼相關(guān),而HTTP版本又由服務(wù)器確定,因此需要Servlet設(shè)置的只有一個狀態(tài)代碼。
Servlet設(shè)置狀態(tài)代碼一般使用HttpServletResponse的setStatus方法。setStatus方法的參數(shù)是一個整數(shù)(即狀態(tài)代碼),不過為了使得代碼具有更好的可讀性,可以用HttpServletResponse中定義的常量來避免直接使用整數(shù)。這些常量根據(jù)HTTP 1.1中的標(biāo)準(zhǔn)狀態(tài)信息命名,所有的名字都加上了SC前綴(Status Code的縮寫)并大寫,同時把空格轉(zhuǎn)換成了下劃線。也就是說,與狀態(tài)代碼404對應(yīng)的狀態(tài)信息是“Not Found”,則HttpServletResponse中的對應(yīng)常量名字為SC_NOT_FOUND。但有兩個例外:和狀態(tài)代碼302對應(yīng)的常量根據(jù)HTTP 1.0命名,而307沒有對應(yīng)的常量。
設(shè)置狀態(tài)代碼并非總是意味著不要再返回文檔。例如,雖然大多數(shù)服務(wù)器返回404應(yīng)答時會輸出簡單的“File Not Found”信息,但Servlet也可以定制這個應(yīng)答。不過,定制應(yīng)答時應(yīng)當(dāng)在通過PrintWriter發(fā)送任何內(nèi)容之前先調(diào)用response.setStatus。
雖然設(shè)置狀態(tài)代碼一般使用的是response.setStauts(int)方法,但為了簡單起見,HttpServletResponse為兩種常見的情形提供了專用方法:sendError方法生成一個404應(yīng)答,同時生成一個簡短的HTML錯誤信息文檔;sendRedirect方法生成一個302應(yīng)答,同時在Location頭中指示新文檔的URL。
7.3 HTTP 1.1狀態(tài)代碼及其含義
下表顯示了常見的HTTP 1.1狀態(tài)代碼以及它們對應(yīng)的狀態(tài)信息和含義。
應(yīng)當(dāng)謹(jǐn)慎地使用那些只有HTTP 1.1支持的狀態(tài)代碼,因?yàn)樵S多瀏覽器還只能夠支持HTTP 1.0。如果你使用了HTTP 1.1特有的狀態(tài)代碼,最好能夠檢查一下請求的HTTP版本號(通過HttpServletRequest的getProtocol方法)。 狀態(tài)代碼 狀態(tài)信息 含義
100 Continue 初始的請求已經(jīng)接受,客戶應(yīng)當(dāng)繼續(xù)發(fā)送請求的其余部分。(HTTP 1.1新)
101 Switching Protocols 服務(wù)器將遵從客戶的請求轉(zhuǎn)換到另外一種協(xié)議(HTTP 1.1新)
200 OK 一切正常,對GET和POST請求的應(yīng)答文檔跟在后面。如果不用setStatus設(shè)置狀態(tài)代碼,Servlet默認(rèn)使用202狀態(tài)代碼。
201 Created 服務(wù)器已經(jīng)創(chuàng)建了文檔,Location頭給出了它的URL。
202 Accepted 已經(jīng)接受請求,但處理尚未完成。
203 Non-Authoritative Information 文檔已經(jīng)正常地返回,但一些應(yīng)答頭可能不正確,因?yàn)槭褂玫氖俏臋n的拷貝(HTTP 1.1新)。
204 No Content 沒有新文檔,瀏覽器應(yīng)該繼續(xù)顯示原來的文檔。如果用戶定期地刷新頁面,而Servlet可以確定用戶文檔足夠新,這個狀態(tài)代碼是很有用的。
205 Reset Content 沒有新的內(nèi)容,但瀏覽器應(yīng)該重置它所顯示的內(nèi)容。用來強(qiáng)制瀏覽器清除表單輸入內(nèi)容(HTTP 1.1新)。
206 Partial Content 客戶發(fā)送了一個帶有Range頭的GET請求,服務(wù)器完成了它(HTTP 1.1新)。
300 Multiple Choices 客戶請求的文檔可以在多個位置找到,這些位置已經(jīng)在返回的文檔內(nèi)列出。如果服務(wù)器要提出優(yōu)先選擇,則應(yīng)該在Location應(yīng)答頭指明。
301 Moved Permanently 客戶請求的文檔在其他地方,新的URL在Location頭中給出,瀏覽器應(yīng)該自動地訪問新的URL。
302 Found 類似于301,但新的URL應(yīng)該被視為臨時性的替代,而不是永久性的。注意,在HTTP1.0中對應(yīng)的狀態(tài)信息是“Moved Temporatily”,而HttpServletResponse中相應(yīng)的常量是SC_MOVED_TEMPORARILY,而不是SC_FOUND。
出現(xiàn)該狀態(tài)代碼時,瀏覽器能夠自動訪問新的URL,因此它是一個很有用的狀態(tài)代碼。為此,Servlet提供了一個專用的方法,即sendRedirect。使用response.sendRedirect(url)比使用response.setStatus(response.SC_MOVED_TEMPORARILY)和response.setHeader("Location",url)更好。這是因?yàn)椋?
首先,代碼更加簡潔。
第二,使用sendRedirect,Servlet會自動構(gòu)造一個包含新鏈接的頁面(用于那些不能自動重定向的老式瀏覽器)。
最后,sendRedirect能夠處理相對URL,自動把它們轉(zhuǎn)換成絕對URL。
注意這個狀態(tài)代碼有時候可以和301替換使用。例如,如果瀏覽器錯誤地請求http://host/~user(缺少了后面的斜杠),有的服務(wù)器返回301,有的則返回302。
嚴(yán)格地說,我們只能假定只有當(dāng)原來的請求是GET時瀏覽器才會自動重定向。請參見307。
303 See Other 類似于301/302,不同之處在于,如果原來的請求是POST,Location頭指定的重定向目標(biāo)文檔應(yīng)該通過GET提?。℉TTP 1.1新)。
304 Not Modified 客戶端有緩沖的文檔并發(fā)出了一個條件性的請求(一般是提供If-Modified-Since頭表示客戶只想比指定日期更新的文檔)。服務(wù)器告訴客戶,原來緩沖的文檔還可以繼續(xù)使用。
305 Use Proxy 客戶請求的文檔應(yīng)該通過Location頭所指明的代理服務(wù)器提?。℉TTP 1.1新)。
307 Temporary Redirect 和302(Found)相同。許多瀏覽器會錯誤地響應(yīng)302應(yīng)答進(jìn)行重定向,即使原來的請求是POST,即使它實(shí)際上只能在POST請求的應(yīng)答是303時才能重定向。由于這個原因,HTTP 1.1新增了307,以便更加清除地區(qū)分幾個狀態(tài)代碼:當(dāng)出現(xiàn)303應(yīng)答時,瀏覽器可以跟隨重定向的GET和POST請求;如果是307應(yīng)答,則瀏覽器只能跟隨對GET請求的重定向。
注意,HttpServletResponse中沒有為該狀態(tài)代碼提供相應(yīng)的常量。(HTTP 1.1新)
400 Bad Request 請求出現(xiàn)語法錯誤。
401 Unauthorized 客戶試圖未經(jīng)授權(quán)訪問受密碼保護(hù)的頁面。應(yīng)答中會包含一個WWW-Authenticate頭,瀏覽器據(jù)此顯示用戶名字/密碼對話框,然后在填寫合適的Authorization頭后再次發(fā)出請求。
403 Forbidden 資源不可用。服務(wù)器理解客戶的請求,但拒絕處理它。通常由于服務(wù)器上文件或目錄的權(quán)限設(shè)置導(dǎo)致。
404 Not Found 無法找到指定位置的資源。這也是一個常用的應(yīng)答,HttpServletResponse專門提供了相應(yīng)的方法:sendError(message)。
405 Method Not Allowed 請求方法(GET、POST、HEAD、DELETE、PUT、TRACE等)對指定的資源不適用。(HTTP 1.1新)
406 Not Acceptable 指定的資源已經(jīng)找到,但它的MIME類型和客戶在Accpet頭中所指定的不兼容(HTTP 1.1新)。
407 Proxy Authentication Required 類似于401,表示客戶必須先經(jīng)過代理服務(wù)器的授權(quán)。(HTTP 1.1新)
408 Request Timeout 在服務(wù)器許可的等待時間內(nèi),客戶一直沒有發(fā)出任何請求??蛻艨梢栽谝院笾貜?fù)同一請求。(HTTP 1.1新)
409 Conflict 通常和PUT請求有關(guān)。由于請求和資源的當(dāng)前狀態(tài)相沖突,因此請求不能成功。(HTTP 1.1新)
410 Gone 所請求的文檔已經(jīng)不再可用,而且服務(wù)器不知道應(yīng)該重定向到哪一個地址。它和404的不同在于,返回407表示文檔永久地離開了指定的位置,而404表示由于未知的原因文檔不可用。(HTTP 1.1新)
411 Length Required 服務(wù)器不能處理請求,除非客戶發(fā)送一個Content-Length頭。(HTTP 1.1新)
412 Precondition Failed 請求頭中指定的一些前提條件失敗(HTTP 1.1新)。
413 Request Entity Too Large 目標(biāo)文檔的大小超過服務(wù)器當(dāng)前愿意處理的大小。如果服務(wù)器認(rèn)為自己能夠稍后再處理該請求,則應(yīng)該提供一個Retry-After頭(HTTP 1.1新)。
414 Request URI Too Long URI太長(HTTP 1.1新)。
416 Requested Range Not Satisfiable 服務(wù)器不能滿足客戶在請求中指定的Range頭。(HTTP 1.1新)
500 Internal Server Error 服務(wù)器遇到了意料不到的情況,不能完成客戶的請求。
501 Not Implemented 服務(wù)器不支持實(shí)現(xiàn)請求所需要的功能。例如,客戶發(fā)出了一個服務(wù)器不支持的PUT請求。
502 Bad Gateway 服務(wù)器作為網(wǎng)關(guān)或者代理時,為了完成請求訪問下一個服務(wù)器,但該服務(wù)器返回了非法的應(yīng)答。
503 Service Unavailable 服務(wù)器由于維護(hù)或者負(fù)載過重未能應(yīng)答。例如,Servlet可能在數(shù)據(jù)庫連接池已滿的情況下返回503。服務(wù)器返回503時可以提供一個Retry-After頭。
504 Gateway Timeout 由作為代理或網(wǎng)關(guān)的服務(wù)器使用,表示不能及時地從遠(yuǎn)程服務(wù)器獲得應(yīng)答。(HTTP 1.1新)
505 HTTP Version Not Supported 服務(wù)器不支持請求中所指明的HTTP版本。(HTTP 1.1新)
7.4 實(shí)例:訪問多個搜索引擎
下面這個例子用到了除200之外的另外兩個常見狀態(tài)代碼:302和404。302通過sendRedirect方法設(shè)置,404通過sendError方法設(shè)置。
在這個例子中,首先出現(xiàn)的HTML表單用來選擇搜索引擎、搜索字符串、每頁顯示的搜索結(jié)果數(shù)量。表單提交后,Servlet提取這三個變量,按照所選擇的搜索引擎的要求構(gòu)造出包含這些變量的URL,然后把用戶重定向到這個URL。如果用戶不能正確地選擇搜索引擎,或者利用其他表單發(fā)送了一個不認(rèn)識的搜索引擎名字,則返回一個提示搜索引擎找不到的404頁面。
SearchEngines.java
注意:這個Servlet要用到后面給出的SearchSpec類,SearchSpec的功能是構(gòu)造適合不同搜索引擎的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編碼的查詢字符串。由于我們
// 要把查詢字符串發(fā)送給另一個服務(wù)器,因此再次使用
// URLEncoder進(jìn)行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
下面是調(diào)用上述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>
搜索關(guān)鍵字:
<INPUT TYPE="TEXT" NAME="searchString"><BR>
每頁顯示幾個查詢結(jié)果:
<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>