获取请求消息头的相关方法

当请求Servlet时，需要通过请求头向服务器传递附加信息，例如，客户端可以接受的数据类型，压缩方式，语言等等。为此，在HttpServletRequest接口中，定义了一系列用于获取HTTP请求头字段的方法，如表1所示。

表1 获取请求消息头的方法

方法声明	功能描述
String getHeader(String name)	该方法用于获取一个指定头字段的值，如果请求消息中没有包含指定的头字段，getHeader方法返回null；如果请求消息中包含有多个指定名称的头字段，getHeader方法返回其中第一个头字段的值
Enumeration getHeaders(String name)	该方法返回一个Enumeration集合对象，该集合对象由请求消息中出现的某个指定名称的所有头字段值组成。在多数情况下，一个头字段名在请求消息中只出现一次，但有时候可能会出现多次
Enumeration getHeaderNames()	该方法用于获取一个包含所有请求头字段的Enumeration对象
int getIntHeader(String name)	该方法用于获取指定名称的头字段，并且将其值转为int类型。需要注意的是，如果指定名称的头字段不存在，返回值为-1；如果获取到的头字段的值不能转为int类型，将发生NumberFormatException异常
long getDateHeader(String name)	该方法用于获取指定头字段的值，并将其按GMT时间格式转换成一个代表日期/时间的长整数，这个长整数是自1970年1月1日0点0分0秒算起的以毫秒为单位的时间值
String getContentType()	该方法用于获取Content-Type头字段的值，结果为String类型
int getContentLength()	该方法用于获取Content-Length头字段的值，结果为int类型
String getCharacterEncoding()	该方法用于返回请求消息的实体部分的字符集编码，通常是从Content-Type头字段中进行提取，结果为String类型

在表1中，列出了一系列用于读取HTTP请求消息头字段的方法，为了更好地掌握这些方法，接下来通过一个案例来学习这些方法的使用，如例1所示。

例1 RequestHeadersServlet.java

 1    package cn.itcast.chapter05.request; 
 2    import java.io.IOException;
 3    import java.io.PrintWriter;
 4    import java.util.Enumeration;
 5    import javax.servlet.*;
 6    import javax.servlet.http.*;
 7    public class RequestHeadersServlet extends HttpServlet {
 8        public void doGet(HttpServletRequest request, HttpServletResponse response)
 9                throws ServletException, IOException {
 10            response.setContentType("text/html;charset=utf-8");
 11            PrintWriter out = response.getWriter();
 12            Enumeration headerNames = request.getHeaderNames();// 获取请求消息中所有头字段
 13             // 使用循环遍历所有请求头，并通过getHeader()方法获取一个指定名称的头字段
 14            while (headerNames.hasMoreElements()) { 
 15                String headerName = (String) headerNames.nextElement();
 16                out.print(headerName + " : " + request.getHeader(headerName)+ "<br>");
 17            }
 18        }
 19        public void doPost(HttpServletRequest request, HttpServletResponse response)
 20                throws ServletException, IOException {
 21            doGet(request, response);
 22        }
 23    }

在web.xml中配置完RequestHeadersServlet映射后，启动Tomcat服务器，在浏览器的地址栏中输入URL地址http://localhost:8080/chapter05/RequestHeadersServlet访问RequestHeadersServlet，浏览器显示的结果如图1所示。

图1 运行结果