Servlet 客戶端 HTTP 請求

當流覽器請求網頁時，它會向 Web 伺服器發送特定資訊，這些資訊不能被直接讀取，因為這些資訊是作為 HTTP 請求的頭的一部分進行傳輸的。您可以查看 HTTP 協議 瞭解更多相關資訊。

以下是來自於流覽器端的重要頭資訊，您可以在 Web 編程中頻繁使用：

頭資訊描述
Accept這個頭資訊指定流覽器或其他客戶端可以處理的 MIME 類型。值 image/png 或 image/jpeg 是最常見的兩種可能值。
Accept-Charset這個頭資訊指定流覽器可以用來顯示資訊的字元集。例如 ISO-8859-1。
Accept-Encoding這個頭資訊指定流覽器知道如何處理的編碼類型。值 gzip 或 compress 是最常見的兩種可能值。
Accept-Language這個頭資訊指定客戶端的首選語言，在這種情況下，Servlet 會產生多種語言的結果。例如，en、en-us、ru 等。
Authorization這個頭資訊用於客戶端在訪問受密碼保護的網頁時識別自己的身份。
Connection這個頭資訊指示客戶端是否可以處理持久 HTTP 連接。持久連接允許客戶端或其他流覽器通過單個請求來檢索多個檔。值 Keep-Alive 意味著使用了持續連接。
Content-Length這個頭資訊只適用於 POST 請求，並給出 POST 數據的大小（以位元組為單位）。
Cookie這個頭資訊把之前發送到流覽器的 cookies 返回到伺服器。
Host這個頭資訊指定原始的 URL 中的主機和端口。
If-Modified-Since這個頭資訊表示只有當頁面在指定的日期後已更改時，客戶端想要的頁面。如果沒有新的結果可以使用，伺服器會發送一個 304 代碼，表示 Not Modified 頭資訊。
If-Unmodified-Since這個頭資訊是 If-Modified-Since 的對立面，它指定只有當文檔早於指定日期時，操作才會成功。
Referer這個頭資訊指示所指向的 Web 頁的 URL。例如，如果您在網頁 1，點擊一個鏈接到網頁 2，當流覽器請求網頁 2 時，網頁 1 的 URL 就會包含在 Referer 頭資訊中。
User-Agent這個頭資訊識別發出請求的流覽器或其他客戶端，並可以向不同類型的流覽器返回不同的內容。

讀取 HTTP 頭的方法

下麵的方法可用在 Servlet 程式中讀取 HTTP 頭。這些方法通過 HttpServletRequest 對象可用。

序號方法 & 描述
1Cookie[] getCookies()
返回一個數組，包含客戶端發送該請求的所有的 Cookie 對象。
2Enumeration getAttributeNames()
返回一個枚舉，包含提供給該請求可用的屬性名稱。
3Enumeration getHeaderNames()
返回一個枚舉，包含在該請求中包含的所有的頭名。
4Enumeration getParameterNames()
返回一個 String 對象的枚舉，包含在該請求中包含的參數的名稱。
5HttpSession getSession()
返回與該請求關聯的當前 session 會話，或者如果請求沒有 session 會話，則創建一個。
6HttpSession getSession(boolean create)
返回與該請求關聯的當前 HttpSession，或者如果沒有當前會話，且創建是真的，則返回一個新的 session 會話。
7Locale getLocale()
基於 Accept-Language 頭，返回客戶端接受內容的首選的區域設置。
8Object getAttribute(String name)
以對象形式返回已命名屬性的值，如果沒有給定名稱的屬性存在，則返回 null。
9ServletInputStream getInputStream()
使用 ServletInputStream，以二進位數據形式檢索請求的主體。
10String getAuthType()
返回用於保護 Servlet 的身份驗證方案的名稱，例如，"BASIC" 或 "SSL"，如果JSP沒有受到保護則返回 null。
11String getCharacterEncoding()
返回請求主體中使用的字元編碼的名稱。
12String getContentType()
返回請求主體的 MIME 類型，如果不知道類型則返回 null。
13String getContextPath()
返回指示請求上下文的請求 URI 部分。
14String getHeader(String name)
以字串形式返回指定的請求頭的值。
15String getMethod()
返回請求的 HTTP 方法的名稱，例如，GET、POST 或 PUT。
16String getParameter(String name)
以字串形式返回請求參數的值，或者如果參數不存在則返回 null。
17String getPathInfo()
當請求發出時，返回與客戶端發送的 URL 相關的任何額外的路徑資訊。
18String getProtocol()
返回請求協議的名稱和版本。
19String getQueryString()
返回包含在路徑後的請求 URL 中的查詢字串。
20String getRemoteAddr()
返回發送請求的客戶端的互聯網協議（IP）地址。
21String getRemoteHost()
返回發送請求的客戶端的完全限定名稱。
22String getRemoteUser()
如果用戶已通過身份驗證，則返回發出請求的登錄用戶，或者如果用戶未通過身份驗證，則返回 null。
23String getRequestURI()
從協議名稱直到 HTTP 請求的第一行的查詢字串中，返回該請求的 URL 的一部分。
24String getRequestedSessionId()
返回由客戶端指定的 session 會話 ID。
25String getServletPath()
返回調用 JSP 的請求的 URL 的一部分。
26String[] getParameterValues(String name)
返回一個字串對象的數組，包含所有給定的請求參數的值，如果參數不存在則返回 null。
27boolean isSecure()
返回一個布爾值，指示請求是否使用安全通道，如 HTTPS。
28int getContentLength()
以位元組為單位返回請求主體的長度，並提供輸入流，或者如果長度未知則返回 -1。
29int getIntHeader(String name)
返回指定的請求頭的值為一個 int 值。
30int getServerPort()
返回接收到這個請求的端口號。
31int getParameterMap()
將參數封裝成 Map 類型。

HTTP Header 請求實例

下麵的實例使用 HttpServletRequest 的 getHeaderNames() 方法讀取 HTTP 頭資訊。該方法返回一個枚舉，包含與當前的 HTTP 請求相關的頭資訊。

一旦我們有一個枚舉，我們可以以標準方式迴圈枚舉，使用 hasMoreElements() 方法來確定何時停止，使用 nextElement() 方法來獲取每個參數的名稱。

//導入必需的 java 庫

import java.io.IOException;
import java.io.PrintWriter;
import java.util.Enumeration;

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("/DisplayHeader")

//擴展 HttpServlet 類

public class DisplayHeader extends HttpServlet {

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

    public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException
    {
        // 設置回應內容類型
        response.setContentType("text/html;charset=UTF-8");

        PrintWriter out = response.getWriter();
        String title = "HTTP Header 請求實例 - IT研修實例";
        String docType =
            "<!DOCTYPE html> \n";
            out.println(docType +
            "<html>\n" +
            "<head><meta charset=\"utf-8\"><title>" + title + "</title></head>\n"+
            "<body bgcolor=\"#f0f0f0\">\n" +
            "<h1 align=\"center\">" + title + "</h1>\n" +
            "<table width=\"100%\" border=\"1\" align=\"center\">\n" +
            "<tr bgcolor=\"#949494\">\n" +
            "<th>Header 名稱</th><th>Header 值</th>\n"+
            "</tr>\n");

        Enumeration headerNames = request.getHeaderNames();

        while(headerNames.hasMoreElements()) {
            String paramName = (String)headerNames.nextElement();
            out.print("<tr><td>" + paramName + "</td>\n");
            String paramValue = request.getHeader(paramName);
            out.println("<td> " + paramValue + "</td></tr>\n");
        }
        out.println("</table>\n</body></html>");
    }
    // 處理 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>DisplayHeader</servlet-name>
    <!-- 所在的包 -->
    <servlet-class>com.zaixian.test.DisplayHeader</servlet-class>
  </servlet>
  <servlet-mapping>
    <servlet-name>DisplayHeader</servlet-name>
    <!-- 訪問的網址 -->
    <url-pattern>/TomcatTest/DisplayHeader</url-pattern>
  </servlet-mapping>
</web-app>

現在，調用上面的 Servlet，訪問 http://localhost:8080/TomcatTest/DisplayHeader 會產生以下結果：