Servlet 伺服器 HTTP 回應

正如前面的章節中討論的那樣，當一個 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（Service Unavailable 服務不可用）回應配合使用，這會告訴客戶端多久就可以重複它的請求。
Set-Cookie這個頭資訊指定一個與頁面關聯的 cookie。

設置 HTTP 回應報頭的方法

下麵的方法可用於在 Servlet 程式中設置 HTTP 回應報頭。這些方法通過 HttpServletResponse 對象可用。

序號方法 & 描述
1String encodeRedirectURL(String url)
為 sendRedirect 方法中使用的指定的 URL 進行編碼，或者如果編碼不是必需的，則返回 URL 未改變。
2String encodeURL(String url)
對包含 session 會話 ID 的指定 URL 進行編碼，或者如果編碼不是必需的，則返回 URL 未改變。
3boolean containsHeader(String name)
返回一個布爾值，指示是否已經設置已命名的回應報頭。
4boolean isCommitted()
返回一個布爾值，指示回應是否已經提交。
5void addCookie(Cookie cookie)
把指定的 cookie 添加到回應。
6void addDateHeader(String name, long date)
添加一個帶有給定的名稱和日期值的回應報頭。
7void addHeader(String name, String value)
添加一個帶有給定的名稱和值的回應報頭。
8void addIntHeader(String name, int value)
添加一個帶有給定的名稱和整數值的回應報頭。
9void flushBuffer()
強制任何在緩衝區中的內容被寫入到客戶端。
10void reset()
清除緩衝區中存在的任何數據，包括狀態碼和頭。
11void resetBuffer()
清除回應中基礎緩衝區的內容，不清除狀態碼和頭。
12void sendError(int sc)
使用指定的狀態碼發送錯誤回應到客戶端，並清除緩衝區。
13void sendError(int sc, String msg)
使用指定的狀態發送錯誤回應到客戶端。
14void sendRedirect(String location)
使用指定的重定向位置 URL 發送臨時重定向回應到客戶端。
15void setBufferSize(int size)
為回應主體設置首選的緩衝區大小。
16void setCharacterEncoding(String charset)
設置被發送到客戶端的回應的字元編碼（MIME 字元集）例如，UTF-8。
17void setContentLength(int len)
設置在 HTTP Servlet 回應中的內容主體的長度，該方法設置 HTTP Content-Length 頭。
18void setContentType(String type)
如果回應還未被提交，設置被發送到客戶端的回應的內容類型。
19void setDateHeader(String name, long date)
設置一個帶有給定的名稱和日期值的回應報頭。
20void setHeader(String name, String value)
設置一個帶有給定的名稱和值的回應報頭。
21void setIntHeader(String name, int value)
設置一個帶有給定的名稱和整數值的回應報頭。
22void setLocale(Locale loc)
如果回應還未被提交，設置回應的區域。
23void setStatus(int sc)
為該回應設置狀態碼。

HTTP Header 回應實例

您已經在前面的實例中看到 setContentType() 方法，下麵的實例也使用了同樣的方法，此外，我們會用 setIntHeader() 方法來設置 Refresh 頭。

//導入必需的 java 庫

import java.io.IOException;
import java.io.PrintWriter;
import java.text.SimpleDateFormat;
import java.util.Calendar;
import java.util.Date;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@WebServlet("/Refresh")

//擴展 HttpServlet 類

public class Refresh extends HttpServlet {

    // 處理 GET 方法請求的方法

      public void doGet(HttpServletRequest request,
                        HttpServletResponse response)
                throws ServletException, IOException
      {
          // 設置刷新自動加載時間為 5 秒

          response.setIntHeader("Refresh", 5);
          // 設置回應內容類型
          response.setContentType("text/html;charset=UTF-8");
    
          //使用默認時區和語言環境獲得一個日曆

          Calendar cale = Calendar.getInstance();
          //將Calendar類型轉換成Date類型
          Date tasktime=cale.getTime();
          //設置日期輸出的格式

          SimpleDateFormat df=new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
          //格式化輸出

          String nowTime = df.format(tasktime);
          PrintWriter out = response.getWriter();
          String title = "自動刷新 Header 設置 - IT研修實例";
          String docType =
          "<!DOCTYPE html>\n";
          out.println(docType +
            "<html>\n" +
            "<head><title>" + title + "</title></head>\n"+
            "<body bgcolor=\"#f0f0f0\">\n" +
            "<h1 align=\"center\">" + title + "</h1>\n" +
            "<p>當前時間是：" + nowTime + "</p>\n");
      }
      // 處理 POST 方法請求的方法

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

以上測試實例是位於 TomcatTest 專案下，對應的 web.xml 配置為：

<?xml version="1.0" encoding="UTF-8"?>
<web-app>
  <servlet>
     <!-- 類名 -->
    <servlet-name>Refresh</servlet-name>
    <!-- 所在的包 -->
    <servlet-class>com.zaixian.test.Refresh</servlet-class>
  </servlet>
  <servlet-mapping>
    <servlet-name>Refresh</servlet-name>
    <!-- 訪問的網址 -->
    <url-pattern>/TomcatTest/Refresh</url-pattern>
    </servlet-mapping>
</web-app>

現在，調用上面的 Servlet，每隔 5 秒會顯示當前系統時間。只要運行 Servlet 並稍等片刻，即可看到如下的結果：