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>
"; out.println(docType + "<html>
" + "<head><meta charset="utf-8"><title>" + title + "</title></head>
"+ "<body bgcolor="#f0f0f0">
" + "<h1 align="center">" + title + "</h1>
" + "<table width="100%" border="1" align="center">
" + "<tr bgcolor="#949494">
" + "<th>Header 名稱</th><th>Header 值</th>
"+ "</tr>
"); Enumeration headerNames = request.getHeaderNames(); while(headerNames.hasMoreElements()) { String paramName = (String)headerNames.nextElement(); out.print("<tr><td>" + paramName + "</td>
"); String paramValue = request.getHeader(paramName); out.println("<td> " + paramValue + "</td></tr>
"); } out.println("</table>
</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.runoob.test.DisplayHeader</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>DisplayHeader</servlet-name>
<!-- 訪問的網址 -->
<url-pattern>/TomcatTest/DisplayHeader</url-pattern>
</servlet-mapping> </web-app>


TAG:程序員小新人學習 |