五、读取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);
  }
}