Servlet的服務端響應
以下內容引用自http://wiki.jikexueyuan.com/project/servlet/server-response.html:
當一個Web服務器對瀏覽器響應一個HTTP請求時,響應通常包括一個狀態行、一些響應頭信息、一個空行和文檔。一個典型的響應如下所示:
HTTP/1.1 200 OK Content-Type: text/html Header2: ... ... HeaderN: ... (Blank Line) <!doctype ...> <html> <head>...</head> <body>... </body> </html>
狀態行包括HTTP版本(例子中的HTTP/1.1)、一個狀態碼(例子中的200)和一個對應於狀態碼的短消息(例子中的OK)。
下面是從Web服務器端返回到瀏覽器的最有用的HTTP 1.1響應頭信息的總結,且在Web編程中會頻繁地使用它們:
頭信息 | 描述 |
---|---|
Allow | 這個頭信息指定服務器支持的請求方法(GET、POST等)。 |
Cache-Control | 這個頭信息指定響應文檔在何種情況下可以安全地緩存。可能的值有:public, private no-cache等。public意味著文檔是可緩存,private意味著文檔是單個用戶私用文檔,且只能存儲在私有(非共享)緩存中,no-cache意味著文檔不應被緩存。 |
Connection | 這個頭信息指示瀏覽器是否使用持久HTTP連接。值close指示瀏覽器不使用持久HTTP連接,值keep-alive意味著使用持久連接。 |
Content-Disposition | 這個頭信息可以讓您請求瀏覽器要求用戶以給定名稱的文件把響應保存到磁盤。 |
Content-Encoding | 在傳輸過程中,這個頭信息指定頁面的編碼方式。 |
Content-Language | 這個頭信息表示文檔編寫所使用的語言。例如,en、en-us、ru等。 |
Content-Length | 這個頭信息指示響應中的字節數。只有當瀏覽器使用持久(keep-alive)HTTP連接時才需要這些信息。 |
Content-Type | 這個頭信息提供了響應文檔的MIME(Multipurpose Internet Mail Extension)類型。 |
Expires | 這個頭信息指定內容過期的時間,在這之後內容不再被緩存。 |
Last-Modified | 這個頭信息指示文檔的最後修改時間。然後,客戶端可以緩存文件,並在以後的請求中通過If-Modified-Since請求頭信息提供一個日期。 |
Location | 這個頭信息應被包含在所有的帶有狀態碼的響應中。在300s內,這會通知瀏覽器文檔的地址。瀏覽器會自動重新連接到這個位置,並獲取新的文檔。 |
Refresh | 這個頭信息指定瀏覽器應該如何盡快請求更新的頁面。您可以指定頁面刷新的秒數。 |
Retry-After | 這個頭信息可以與503(服務不可用)響應配合使用,這會告訴客戶端多久就可以重復它的請求。 |
Set-Cookie | 這個頭信息指定一個與頁面關聯的Cookie。 |
一、設置HTTP響應頭信息的方法
下面的方法可用於在Servlet程序中設置HTTP響應頭信息。通過HttpServletResponse對象這些方法是可用的。
方法 | 描述 |
---|---|
String encodeRedirectURL(String url) |
為sendRedirect方法中使用的指定的URL進行編碼,或者如果編碼不是必需的,則返回URL未改變。 |
String encodeURL(String url) |
對包含Session會話ID的指定URL進行編碼,或者如果編碼不是必需的,則返回URL未改變。 |
boolean containsHeader(String name) |
返回一個布爾值,指示是否已經設置已命名的響應頭信息。 |
boolean isCommitted() |
返回一個布爾值,指示響應是否已經提交。 |
void addCookie(Cookie cookie) |
把指定的Cookie添加到響應。 |
void addDateHeader(String name, long date) |
添加一個帶有給定的名稱和日期值的響應頭信息。 |
void addHeader(String name, String value) |
添加一個帶有給定的名稱和值的響應頭信息。 |
void addIntHeader(String name, int value) |
添加一個帶有給定的名稱和整數值的響應頭信息。 |
void flushBuffer() |
強制任何在緩沖區中的內容被寫入到客戶端。 |
void reset() |
清除緩沖區中存在的任何數據,包括狀態碼和頭信息。 |
void resetBuffer() |
清除響應中基礎緩沖區的內容,不清除狀態碼和頭信息。 |
void sendError(int sc) |
使用指定的狀態碼發送錯誤響應到客戶端,並清除緩沖區。 |
void sendError(int sc, String msg) |
使用指定的狀態發送錯誤響應到客戶端。 |
void sendRedirect(String location) |
使用指定的重定向位置URL發送臨時重定向響應到客戶端。 |
void setBufferSize(int size) |
為響應主體設置首選的緩沖區大小。 |
void setCharacterEncoding(String charset) |
設置被發送到客戶端的響應的字符編碼(MIME字符集)例如,UTF-8。 |
void setContentLength(int len) |
設置在HTTP Servlet響應中的內容主體的長度,該方法設置HTTP Content-Length頭信息。 |
void setContentType(String type) |
如果響應還未被提交,設置被發送到客戶端的響應的內容類型。 |
void setDateHeader(String name, long date) |
設置一個帶有給定的名稱和日期值的響應頭信息。 |
void setHeader(String name, String value) |
設置一個帶有給定的名稱和值的響應頭信息。 |
void setIntHeader(String name, int value) |
設置一個帶有給定的名稱和整數值的響應頭信息。 |
void setLocale(Locale loc) |
如果響應還未被提交,設置響應的區域。 |
void setStatus(int sc) |
為該響應設置狀態碼。 |
二、HTTP頭信息響應實例
在前面的實例中已經了解了setContentType()方法的工作方式,下面的實例也會用到同樣的方法,此外,會用setIntHeader()方法來設置Refresh頭信息。
// Import required java libraries import java.io.*; import javax.servlet.*; import javax.servlet.http.*; import java.util.*; // Extend HttpServlet class public class Refresh extends HttpServlet { // Method to handle GET method request. public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // Set refresh, autoload time as 5 seconds response.setIntHeader("Refresh", 5); // Set response content type response.setContentType("text/html"); // Get current time Calendar calendar = new GregorianCalendar(); String am_pm; int hour = calendar.get(Calendar.HOUR); int minute = calendar.get(Calendar.MINUTE); int second = calendar.get(Calendar.SECOND); if(calendar.get(Calendar.AM_PM) == 0) am_pm = "AM"; else am_pm = "PM"; String CT = hour+":"+ minute +":"+ second +" "+ am_pm; PrintWriter out = response.getWriter(); String title = "Auto Refresh Header Setting"; String docType = "<!doctype html public \"-//w3c//dtd html 4.0 " + "transitional//en\">\n"; out.println(docType + "<html>\n" + "<head><title>" + title + "</title></head>\n"+ "<body bgcolor=\"#f0f0f0\">\n" + "<h1 align=\"center\">" + title + "</h1>\n" + "<p>Current Time is: " + CT + "</p>\n"); } // Method to handle POST method request. public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { doGet(request, response); } }
配置web.xml:
<servlet> <servlet-name>Refresh</servlet-name> <servlet-class>com.jsoft.testservletbasics.Refresh</servlet-class> </servlet> <servlet-mapping> <servlet-name>Refresh</servlet-name> <url-pattern>/Refresh</url-pattern> </servlet-mapping>
現在調用上述Servlet,每5秒後就會顯示當前的系統時間,如下所示。運行Servlet並等著看結果:
測試工程:https://github.com/easonjim/5_java_example/tree/master/servletbasics/test4
Servlet的服務端響應