Servlet 客戶端 HTTP 請求

當(dāng)瀏覽器請求網(wǎng)頁時，它會向 Web 服務(wù)器發(fā)送特定信息，這些信息不能被直接讀取，因?yàn)檫@些信息是作為 HTTP 請求的頭的一部分進(jìn)行傳輸?shù)?。您可以查?HTTP 協(xié)議 了解更多相關(guān)信息。

以下是來自于瀏覽器端的重要頭信息，您可以在 Web 編程中頻繁使用：

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

讀取 HTTP 頭的方法

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

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

HTTP Header 請求示例

下面的示例使用 HttpServletRequest 的 getHeaderNames() 方法讀取 HTTP 頭信息。該方法返回一個枚舉，包含與當(dāng)前的 HTTP 請求相關(guān)的頭信息。

一旦我們有一個枚舉，我們可以以標(biāo)準(zhǔn)方式循環(huán)枚舉，使用 hasMoreElements() 方法來確定何時停止，使用 nextElement() 方法來獲取每個參數(shù)的名稱。

//導(dǎo)入必需的 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")
//擴(kuò)展 HttpServlet 類
public class DisplayHeader extends HttpServlet {
    // 處理 GET 方法請求的方法
    public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException
    {
        // 設(shè)置響應(yīng)內(nèi)容類型
        response.setContentType("text/html;charset=UTF-8");
        PrintWriter out = response.getWriter();
        String title = "HTTP Header 請求示例 - 菜鳥教程示例";
        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 項(xiàng)目下，對應(yīng)的 web.xml 配置為：

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

現(xiàn)在，調(diào)用上面的 Servlet，訪問 http://localhost:8080/TomcatTest/DisplayHeader 會產(chǎn)生以下結(jié)果：