2.2.1客戶端請求 · JavaWeb項目開發學習手冊

# 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*對象可用。 | 序號 | 方法 & 描述 | | --- | --- | | 1 | **Cookie\[\] getCookies()** 返回一個數組，包含客戶端發送該請求的所有的 Cookie 對象。 | | 2 | **Enumeration getAttributeNames()** 返回一個枚舉，包含提供給該請求可用的屬性名稱。 | | 3 | **Enumeration getHeaderNames()** 返回一個枚舉，包含在該請求中包含的所有的頭名。 | | 4 | **Enumeration getParameterNames()** 返回一個 String 對象的枚舉，包含在該請求中包含的參數的名稱。 | | 5 | **HttpSession getSession()** 返回與該請求關聯的當前 session 會話，或者如果請求沒有 session 會話，則創建一個。 | | 6 | **HttpSession getSession(boolean create)** 返回與該請求關聯的當前 HttpSession，或者如果沒有當前會話，且創建是真的，則返回一個新的 session 會話。 | | 7 | **Locale getLocale()** 基于 Accept-Language 頭，返回客戶端接受內容的首選的區域設置。 | | 8 | **Object getAttribute(String name)** 以對象形式返回已命名屬性的值，如果沒有給定名稱的屬性存在，則返回 null。 | | 9 | **ServletInputStream getInputStream()** 使用 ServletInputStream，以二進制數據形式檢索請求的主體。 | | 10 | **String getAuthType()** 返回用于保護 Servlet 的身份驗證方案的名稱，例如，"BASIC" 或 "SSL"，如果JSP沒有受到保護則返回 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)** 以字符串形式返回請求參數的值，或者如果參數不存在則返回 null。 | | 17 | **String getPathInfo()** 當請求發出時，返回與客戶端發送的 URL 相關的任何額外的路徑信息。 | | 18 | **String getProtocol()** 返回請求協議的名稱和版本。 | | 19 | **String getQueryString()** 返回包含在路徑后的請求 URL 中的查詢字符串。 | | 20 | **String getRemoteAddr()** 返回發送請求的客戶端的互聯網協議（IP）地址。 | | 21 | **String getRemoteHost()** 返回發送請求的客戶端的完全限定名稱。 | | 22 | **String getRemoteUser()** 如果用戶已通過身份驗證，則返回發出請求的登錄用戶，或者如果用戶未通過身份驗證，則返回 null。 | | 23 | **String getRequestURI()** 從協議名稱直到 HTTP 請求的第一行的查詢字符串中，返回該請求的 URL 的一部分。 | | 24 | **String getRequestedSessionId()** 返回由客戶端指定的 session 會話 ID。 | | 25 | **String getServletPath()** 返回調用 JSP 的請求的 URL 的一部分。 | | 26 | **String\[\] getParameterValues(String name)** 返回一個字符串對象的數組，包含所有給定的請求參數的值，如果參數不存在則返回 null。 | | 27 | **boolean isSecure()** 返回一個布爾值，指示請求是否使用安全通道，如 HTTPS。 | | 28 | **int getContentLength()** 以字節為單位返回請求主體的長度，并提供輸入流，或者如果長度未知則返回 -1。 | | 29 | **int getIntHeader(String name)** 返回指定的請求頭的值為一個 int 值。 | | 30 | **int getServerPort()** 返回接收到這個請求的端口號。 | | 31 | **int 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 請求實例"; ????????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.yiniuedu.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**會產生以下結果： ![](http://h.yiniuedu.com/4e15547952e8a87ba4f1ef5d229087b2)