7.1 狀態(tài)代碼概述

　　 web服務(wù)器響應(yīng)瀏覽器或其他客戶程序的請(qǐng)求時(shí)，其應(yīng)答一般由以下幾個(gè)部分組成：一個(gè)狀態(tài)行，幾個(gè)應(yīng)答頭，一個(gè)空行，內(nèi)容文檔。下面是一個(gè)最簡(jiǎn)單的應(yīng)答：
http/1.1 200 ok
content-type: text/plain

hello world




　　 狀態(tài)行包含http版本、狀態(tài)代碼、與狀態(tài)代碼對(duì)應(yīng)的簡(jiǎn)短說(shuō)明信息。在大多數(shù)情況下，除了content-type之外的所有應(yīng)答頭都是可選的。但content-type是必需的，它描述的是后面文檔的mime類型。雖然大多數(shù)應(yīng)答都包含一個(gè)文檔，但也有一些不包含，例如對(duì)head請(qǐng)求的應(yīng)答永遠(yuǎn)不會(huì)附帶文檔。有許多狀態(tài)代碼實(shí)際上用來(lái)標(biāo)識(shí)一次失敗的請(qǐng)求，這些應(yīng)答也不包含文檔（或只包含一個(gè)簡(jiǎn)短的錯(cuò)誤信息說(shuō)明）。

　　 servlet可以利用狀態(tài)代碼來(lái)實(shí)現(xiàn)許多功能。例如，可以把用戶重定向到另一個(gè)網(wǎng)站；可以指示出后面的文檔是圖片、pdf文件或html文件；可以告訴用戶必須提供密碼才能訪問(wèn)文檔；等等。這一部分我們將具體討論各種狀態(tài)代碼的含義以及利用這些代碼可以做些什么。

　　 7.2 設(shè)置狀態(tài)代碼

　　 如前所述，http應(yīng)答狀態(tài)行包含http版本、狀態(tài)代碼和對(duì)應(yīng)的狀態(tài)信息。由于狀態(tài)信息直接和狀態(tài)代碼相關(guān)，而http版本又由服務(wù)器確定，因此需要servlet設(shè)置的只有一個(gè)狀態(tài)代碼。

　　 servlet設(shè)置狀態(tài)代碼一般使用httpservletresponse的setstatus方法。setstatus方法的參數(shù)是一個(gè)整數(shù)（即狀態(tài)代碼），不過(guò)為了使得代碼具有更好的可讀性，可以用httpservletresponse中定義的常量來(lái)避免直接使用整數(shù)。這些常量根據(jù)http 1.1中的標(biāo)準(zhǔn)狀態(tài)信息命名，所有的名字都加上了sc前綴（status code的縮寫(xiě)）并大寫(xiě)，同時(shí)把空格轉(zhuǎn)換成了下劃線。也就是說(shuō)，與狀態(tài)代碼404對(duì)應(yīng)的狀態(tài)信息是“not found”，則httpservletresponse中的對(duì)應(yīng)常量名字為sc_not_found。但有兩個(gè)例外：和狀態(tài)代碼302對(duì)應(yīng)的常量根據(jù)http 1.0命名，而307沒(méi)有對(duì)應(yīng)的常量。

　　 設(shè)置狀態(tài)代碼并非總是意味著不要再返回文檔。例如，雖然大多數(shù)服務(wù)器返回404應(yīng)答時(shí)會(huì)輸出簡(jiǎn)單的“file not found”信息，但servlet也可以定制這個(gè)應(yīng)答。不過(guò)，定制應(yīng)答時(shí)應(yīng)當(dāng)在通過(guò)printwriter發(fā)送任何內(nèi)容之前先調(diào)用response.setstatus。

　　 雖然設(shè)置狀態(tài)代碼一般使用的是response.setstauts(int)方法，但為了簡(jiǎn)單起見(jiàn)，httpservletresponse為兩種常見(jiàn)的情形提供了專用方法：senderror方法生成一個(gè)404應(yīng)答，同時(shí)生成一個(gè)簡(jiǎn)短的html錯(cuò)誤信息文檔；sendredirect方法生成一個(gè)302應(yīng)答，同時(shí)在location頭中指示新文檔的url。

　　 7.3 http 1.1狀態(tài)代碼及其含義

　　 下表顯示了常見(jiàn)的http 1.1狀態(tài)代碼以及它們對(duì)應(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)代碼，最好能夠檢查一下請(qǐng)求的http版本號(hào)（通過(guò)httpservletrequest的getprotocol方法）。 狀態(tài)代碼 狀態(tài)信息 含義
100 continue 初始的請(qǐng)求已經(jīng)接受，客戶應(yīng)當(dāng)繼續(xù)發(fā)送請(qǐng)求的其余部分。（http 1.1新）
101 switching protocols 服務(wù)器將遵從客戶的請(qǐng)求轉(zhuǎn)換到另外一種協(xié)議（http 1.1新）
200 ok 一切正常，對(duì)get和post請(qǐng)求的應(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)接受請(qǐng)求，但處理尚未完成。
203 non-authoritative information 文檔已經(jīng)正常地返回，但一些應(yīng)答頭可能不正確，因?yàn)槭褂玫氖俏臋n的拷貝（http 1.1新）。
204 no content 沒(méi)有新文檔，瀏覽器應(yīng)該繼續(xù)顯示原來(lái)的文檔。如果用戶定期地刷新頁(yè)面，而servlet可以確定用戶文檔足夠新，這個(gè)狀態(tài)代碼是很有用的。
205 reset content 沒(méi)有新的內(nèi)容，但瀏覽器應(yīng)該重置它所顯示的內(nèi)容。用來(lái)強(qiáng)制瀏覽器清除表單輸入內(nèi)容（http 1.1新）。
206 partial content 客戶發(fā)送了一個(gè)帶有range頭的get請(qǐng)求，服務(wù)器完成了它（http 1.1新）。
300 multiple choices 客戶請(qǐng)求的文檔可以在多個(gè)位置找到，這些位置已經(jīng)在返回的文檔內(nèi)列出。如果服務(wù)器要提出優(yōu)先選擇，則應(yīng)該在location應(yīng)答頭指明。
301 moved permanently 客戶請(qǐng)求的文檔在其他地方，新的url在location頭中給出，瀏覽器應(yīng)該自動(dòng)地訪問(wèn)新的url。
302 found 類似于301，但新的url應(yīng)該被視為臨時(shí)性的替代，而不是永久性的。注意，在http1.0中對(duì)應(yīng)的狀態(tài)信息是“moved temporatily”，而httpservletresponse中相應(yīng)的常量是sc_moved_temporarily，而不是sc_found。
出現(xiàn)該狀態(tài)代碼時(shí)，瀏覽器能夠自動(dòng)訪問(wèn)新的url，因此它是一個(gè)很有用的狀態(tài)代碼。為此，servlet提供了一個(gè)專用的方法，即sendredirect。使用response.sendredirect(url)比使用response.setstatus(response.sc_moved_temporarily)和response.setheader("location",url)更好。這是因?yàn)椋?

首先，代碼更加簡(jiǎn)潔。
第二，使用sendredirect，servlet會(huì)自動(dòng)構(gòu)造一個(gè)包含新鏈接的頁(yè)面（用于那些不能自動(dòng)重定向的老式瀏覽器）。
最后，sendredirect能夠處理相對(duì)url，自動(dòng)把它們轉(zhuǎn)換成絕對(duì)url。
注意這個(gè)狀態(tài)代碼有時(shí)候可以和301替換使用。例如，如果瀏覽器錯(cuò)誤地請(qǐng)求http://host/~user（缺少了后面的斜杠），有的服務(wù)器返回301，有的則返回302。

嚴(yán)格地說(shuō)，我們只能假定只有當(dāng)原來(lái)的請(qǐng)求是get時(shí)瀏覽器才會(huì)自動(dòng)重定向。請(qǐng)參見(jiàn)307。

303 see other 類似于301/302，不同之處在于，如果原來(lái)的請(qǐng)求是post，location頭指定的重定向目標(biāo)文檔應(yīng)該通過(guò)get提?。╤ttp 1.1新）。
304 not modified 客戶端有緩沖的文檔并發(fā)出了一個(gè)條件性的請(qǐng)求（一般是提供if-modified-since頭表示客戶只想比指定日期更新的文檔）。服務(wù)器告訴客戶，原來(lái)緩沖的文檔還可以繼續(xù)使用。
305 use proxy 客戶請(qǐng)求的文檔應(yīng)該通過(guò)location頭所指明的代理服務(wù)器提?。╤ttp 1.1新）。
307 temporary redirect 和302（found）相同。許多瀏覽器會(huì)錯(cuò)誤地響應(yīng)302應(yīng)答進(jìn)行重定向，即使原來(lái)的請(qǐng)求是post，即使它實(shí)際上只能在post請(qǐng)求的應(yīng)答是303時(shí)才能重定向。由于這個(gè)原因，http 1.1新增了307，以便更加清除地區(qū)分幾個(gè)狀態(tài)代碼：當(dāng)出現(xiàn)303應(yīng)答時(shí)，瀏覽器可以跟隨重定向的get和post請(qǐng)求；如果是307應(yīng)答，則瀏覽器只能跟隨對(duì)get請(qǐng)求的重定向。
注意，httpservletresponse中沒(méi)有為該狀態(tài)代碼提供相應(yīng)的常量。（http 1.1新）

400 bad request 請(qǐng)求出現(xiàn)語(yǔ)法錯(cuò)誤。
401 unauthorized 客戶試圖未經(jīng)授權(quán)訪問(wèn)受密碼保護(hù)的頁(yè)面。應(yīng)答中會(huì)包含一個(gè)www-authenticate頭，瀏覽器據(jù)此顯示用戶名字/密碼對(duì)話框，然后在填寫(xiě)合適的authorization頭后再次發(fā)出請(qǐng)求。
403 forbidden 資源不可用。服務(wù)器理解客戶的請(qǐng)求，但拒絕處理它。通常由于服務(wù)器上文件或目錄的權(quán)限設(shè)置導(dǎo)致。
404 not found 無(wú)法找到指定位置的資源。這也是一個(gè)常用的應(yīng)答，httpservletresponse專門(mén)提供了相應(yīng)的方法：senderror(message)。
405 method not allowed 請(qǐng)求方法（get、post、head、delete、put、trace等）對(duì)指定的資源不適用。（http 1.1新）
406 not acceptable 指定的資源已經(jīng)找到，但它的mime類型和客戶在accpet頭中所指定的不兼容（http 1.1新）。
407 proxy authentication required 類似于401，表示客戶必須先經(jīng)過(guò)代理服務(wù)器的授權(quán)。（http 1.1新）
408 request timeout 在服務(wù)器許可的等待時(shí)間內(nèi)，客戶一直沒(méi)有發(fā)出任何請(qǐng)求。客戶可以在以后重復(fù)同一請(qǐng)求。（http 1.1新）
409 conflict 通常和put請(qǐng)求有關(guān)。由于請(qǐng)求和資源的當(dāng)前狀態(tài)相沖突，因此請(qǐng)求不能成功。（http 1.1新）
410 gone 所請(qǐng)求的文檔已經(jīng)不再可用，而且服務(wù)器不知道應(yīng)該重定向到哪一個(gè)地址。它和404的不同在于，返回407表示文檔永久地離開(kāi)了指定的位置，而404表示由于未知的原因文檔不可用。（http 1.1新）
411 length required 服務(wù)器不能處理請(qǐng)求，除非客戶發(fā)送一個(gè)content-length頭。（http 1.1新）
412 precondition failed 請(qǐng)求頭中指定的一些前提條件失敗（http 1.1新）。
413 request entity too large 目標(biāo)文檔的大小超過(guò)服務(wù)器當(dāng)前愿意處理的大小。如果服務(wù)器認(rèn)為自己能夠稍后再處理該請(qǐng)求，則應(yīng)該提供一個(gè)retry-after頭（http 1.1新）。
414 request uri too long uri太長(zhǎng)（http 1.1新）。
416 requested range not satisfiable 服務(wù)器不能滿足客戶在請(qǐng)求中指定的range頭。（http 1.1新）
500 internal server error 服務(wù)器遇到了意料不到的情況，不能完成客戶的請(qǐng)求。
501 not implemented 服務(wù)器不支持實(shí)現(xiàn)請(qǐng)求所需要的功能。例如，客戶發(fā)出了一個(gè)服務(wù)器不支持的put請(qǐng)求。
502 bad gateway 服務(wù)器作為網(wǎng)關(guān)或者代理時(shí)，為了完成請(qǐng)求訪問(wèn)下一個(gè)服務(wù)器，但該服務(wù)器返回了非法的應(yīng)答。
503 service unavailable 服務(wù)器由于維護(hù)或者負(fù)載過(guò)重未能應(yīng)答。例如，servlet可能在數(shù)據(jù)庫(kù)連接池已滿的情況下返回503。服務(wù)器返回503時(shí)可以提供一個(gè)retry-after頭。
504 gateway timeout 由作為代理或網(wǎng)關(guān)的服務(wù)器使用，表示不能及時(shí)地從遠(yuǎn)程服務(wù)器獲得應(yīng)答。（http 1.1新）
505 http version not supported 服務(wù)器不支持請(qǐng)求中所指明的http版本。（http 1.1新）


　　 7.4 實(shí)例：訪問(wèn)多個(gè)搜索引擎

　　 下面這個(gè)例子用到了除200之外的另外兩個(gè)常見(jiàn)狀態(tài)代碼：302和404。302通過(guò)sendredirect方法設(shè)置，404通過(guò)senderror方法設(shè)置。

　　 在這個(gè)例子中，首先出現(xiàn)的html表單用來(lái)選擇搜索引擎、搜索字符串、每頁(yè)顯示的搜索結(jié)果數(shù)量。表單提交后，servlet提取這三個(gè)變量，按照所選擇的搜索引擎的要求構(gòu)造出包含這些變量的url，然后把用戶重定向到這個(gè)url。如果用戶不能正確地選擇搜索引擎，或者利用其他表單發(fā)送了一個(gè)不認(rèn)識(shí)的搜索引擎名字，則返回一個(gè)提示搜索引擎找不到的404頁(yè)面。

　　 searchengines.java

　　 注意：這個(gè)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自動(dòng)解碼url編碼的查詢字符串。由于我們
// 要把查詢字符串發(fā)送給另一個(gè)服務(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＞訪問(wèn)多個(gè)搜索引擎＜/title＞
＜/head＞

＜body bgcolor="#fdf5e6"＞

＜form action="/servlet/hall.searchengines"＞
＜center＞
搜索關(guān)鍵字:
＜input type="text" name="searchstring"＞＜br＞
每頁(yè)顯示幾個(gè)查詢結(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＞