5、讀取HTTP請求頭

　　 5.1 HTTP請求頭概述

　　 HTTP客戶程序（例如瀏覽器），向服務器發送請求的時候必須指明請求類型（一般是GET或者POST）。如有必要，客戶程序還可以選擇發送其他的請求頭。大多數請求頭并不是必需的，但Content-Length除外。對于POST請求來說Content-Length必須出現。

　　 下面是一些最常見的請求頭：

Accept：瀏覽器可接受的MIME類型。
Accept-Charset：瀏覽器可接受的字符集。
Accept-Encoding：瀏覽器能夠進行解碼的數據編碼方式，比如gzip。Servlet能夠向支持gzip的瀏覽器返回經gzip編碼的HTML頁面。許多情形下這可以減少5到10倍的下載時間。
Accept-Language：瀏覽器所希望的語言種類，當服務器能夠提供一種以上的語言版本時要用到。
Authorization：授權信息，通常出現在對服務器發送的WWW-Authenticate頭的應答中。
Connection：表示是否需要持久連接。如果Servlet看到這里的值為“Keep-Alive”，或者看到請求使用的是HTTP 1.1（HTTP 1.1默認進行持久連接），它就可以利用持久連接的優點，當頁面包含多個元素時（例如Applet，圖片），顯著地減少下載所需要的時間。要實現這一點，Servlet需要在應答中發送一個Content-Length頭，最簡單的實現方法是：先把內容寫入ByteArrayOutputStream，然后在正式寫出內容之前計算它的大小。
Content-Length：表示請求消息正文的長度。
Cookie：這是最重要的請求頭信息之一，參見后面《Cookie處理》一章中的討論。
From：請求發送者的email地址，由一些特殊的Web客戶程序使用，瀏覽器不會用到它。
Host：初始URL中的主機和端口。
If-Modified-Since：只有當所請求的內容在指定的日期之后又經過修改才返回它，否則返回304“Not Modified”應答。
Pragma：指定“no-cache”值表示服務器必須返回一個刷新后的文檔，即使它是代理服務器而且已經有了頁面的本地拷貝。
Referer：包含一個URL，用戶從該URL代表的頁面出發訪問當前請求的頁面。
User-Agent：瀏覽器類型，如果Servlet返回的內容與瀏覽器類型有關則該值非常有用。
UA-Pixels，UA-Color，UA-OS，UA-CPU：由某些版本的IE瀏覽器所發送的非標準的請求頭，表示屏幕大小、顏色深度、操作系統和CPU類型。
　　 有關HTTP頭完整、詳細的說明，請參見http://www.w3.org/Protocols/的HTTP規范。

　　 5.2 在Servlet中讀取請求頭

　　 在Servlet中讀取HTTP頭是非常方便的，只需要調用一下HttpServletRequest的getHeader方法即可。如果客戶請求中提供了指定的頭信息，getHeader返回對應的字符串；否則，返回null。部分頭信息經常要用到，它們有專用的訪問方法：getCookies方法返回Cookie頭的內容，經解析后存放在Cookie對象的數組中，請參見后面有關Cookie章節的討論；getAuthType和getRemoteUser方法分別讀取Authorization頭中的一部分內容；getDateHeader和getIntHeader方法讀取指定的頭，然后返回日期值或整數值。

　　 除了讀取指定的頭之外，利用getHeaderNames還可以得到請求中所有頭名字的一個Enumeration對象。

　　 最后，除了查看請求頭信息之外，我們還可以從請求主命令行獲得一些信息。getMethod方法返回請求方法，請求方法通常是GET或者POST，但也有可能是HEAD、PUT或者DELETE。getRequestURI方法返回URI（URI是URL的從主機和端口之后到表單數據之前的那一部分）。getRequestProtocol返回請求命令的第三部分，一般是“HTTP/1.0”或者“HTTP/1.1”。

　　 5.3 實例：輸出所有的請求頭

　　 下面的Servlet實例把所有接收到的請求頭和它的值以表格的形式輸出。另外，該Servlet還會輸出主請求命令的三個部分：請求方法，URI，協議/版本。

　　 ShowRequestHeaders.java
package hall;

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;

public class ShowRequestHeaders extends HttpServlet {
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html");
PrintWriter out = response.getWriter();
String title = "顯示所有請求頭";
out.println(ServletUtilities.headWithTitle(title) +
"＜BODY BGCOLOR=＼"#FDF5E6＼"＞＼n" +
"＜H1 ALIGN=CENTER＞" + title + "＜/H1＞＼n" +
"＜B＞Request Method: ＜/B＞" +
request.getMethod() + "＜BR＞＼n" +
"＜B＞Request URI: ＜/B＞" +
request.getRequestURI() + "＜BR＞＼n" +
"＜B＞Request Protocol: ＜/B＞" +
request.getProtocol() + "＜BR＞＜BR＞＼n" +
"＜TABLE BORDER=1 ALIGN=CENTER＞＼n" +
"＜TR BGCOLOR=＼"#FFAD00＼"＞＼n" +
"＜TH＞Header Name＜TH＞Header Value");
Enumeration headerNames = request.getHeaderNames();
while(headerNames.hasMoreElements()) {
String headerName = (String)headerNames.nextElement();
out.println("＜TR＞＜TD＞" + headerName);
out.println(" ＜TD＞" + request.getHeader(headerName));
}
out.println("＜/TABLE＞＼n＜/BODY＞＜/HTML＞");
}

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