# Servlet 客户端 HTTP 请求
当浏览器请求网页时，它会向 Web 服务器发送特定信息，这些信息不能被直接读取，因为这些信息是作为 HTTP 请求的头的一部分进行传输的。您可以查看 [HTTP 协议](/http/http-tutorial.html) 了解更多相关信息。
以下是来自于浏览器端的重要头信息，您可以在 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_ 对象可用。
| 方法 | 描述 |
| --- | --- |
| **Cookie[] getCookies()** | 返回一个数组，包含客户端发送该请求的所有的 Cookie 对象。 |
| **Enumeration getAttributeNames()** | 返回一个枚举，包含提供给该请求可用的属性名称。 |
| **Enumeration getHeaderNames()** | 返回一个枚举，包含在该请求中包含的所有的头名。 |
| **Enumeration getParameterNames()** | 返回一个 String 对象的枚举，包含在该请求中包含的参数的名称。 |
| **HttpSession getSession()** | 返回与该请求关联的当前 session 会话，或者如果请求没有 session 会话，则创建一个。 |
| **HttpSession getSession(boolean create)** | 返回与该请求关联的当前 HttpSession，或者如果没有当前会话，且创建是真的，则返回一个新的 session 会话。 |
| **Locale getLocale()** | 基于 Accept-Language 头，返回客户端接受内容的首选的区域设置。 |
| **Object getAttribute(String name)** | 以对象形式返回已命名属性的值，如果没有给定名称的属性存在，则返回 null。 |
| **ServletInputStream getInputStream()** | 使用 ServletInputStream，以二进制数据形式检索请求的主体。 |
| **String getAuthType()** | 返回用于保护 Servlet 的身份验证方案的名称，例如，"BASIC" 或 "SSL"，如果JSP没有受到保护则返回 null。 |
| **String getCharacterEncoding()** | 返回请求主体中使用的字符编码的名称。 |
| **String getContentType()** | 返回请求主体的 MIME 类型，如果不知道类型则返回 null。 |
| **String getContextPath()** | 返回指示请求上下文的请求 URI 部分。 |
| **String getHeader(String name)** | 以字符串形式返回指定的请求头的值。 |
| **String getMethod()** | 返回请求的 HTTP 方法的名称，例如，GET、POST 或 PUT。 |
| **String getParameter(String name)** | 以字符串形式返回请求参数的值，或者如果参数不存在则返回 null。 |
| **String getPathInfo()** | 当请求发出时，返回与客户端发送的 URL 相关的任何额外的路径信息。 |
| **String getProtocol()** | 返回请求协议的名称和版本。 |
| **String getQueryString()** | 返回包含在路径后的请求 URL 中的查询字符串。 |
| **String getRemoteAddr()** | 返回发送请求的客户端的互联网协议（IP）地址。 |
| **String getRemoteHost()** | 返回发送请求的客户端的完全限定名称。 |
| **String getRemoteUser()** | 如果用户已通过身份验证，则返回发出请求的登录用户，或者如果用户未通过身份验证，则返回 null。 |
| **String getRequestURI()** | 从协议名称直到 HTTP 请求的第一行的查询字符串中，返回该请求的 URL 的一部分。 |
| **String getRequestedSessionId()** | 返回由客户端指定的 session 会话 ID。 |
| **String getServletPath()** | 返回调用 JSP 的请求的 URL 的一部分。 |
| **String[] getParameterValues(String name)** | 返回一个字符串对象的数组，包含所有给定的请求参数的值，如果参数不存在则返回 null。 |
| **boolean isSecure()** | 返回一个布尔值，指示请求是否使用安全通道，如 HTTPS。 |
| **int getContentLength()** | 以字节为单位返回请求主体的长度，并提供输入流，或者如果长度未知则返回 -1。 |
| **int getIntHeader(String name)** | 返回指定的请求头的值为一个 int 值。 |
| **int getServerPort()** | 返回接收到这个请求的端口号。 |
## HTTP Header 请求实例
下面的实例使用 HttpServletRequest 的 **getHeaderNames()** 方法读取 HTTP 头信息。该方法返回一个枚举，包含与当前的 HTTP 请求相关的头信息。
一旦我们有一个枚举，我们可以以标准方式循环枚举，使用 _hasMoreElements()_ 方法来确定何时停止，使用 _nextElement()_ 方法来获取每个参数的名称。
```
// 导入必需的 java 库
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;
// 扩展 HttpServlet 类
public class DisplayHeader extends HttpServlet {
// 处理 GET 方法请求的方法
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException
{
// 设置响应内容类型
response.setContentType("text/html");
PrintWriter out = response.getWriter();
String title = "HTTP Header 请求实例";
String docType =
"<!doctype html public \"-//w3c//dtd html 4.0 " +
"transitional//en\">\n";
out.println(docType +
"<html>\n" +
"<head><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);
}
}
```
现在，调用上面的 Servlet 会产生以下结果：
```
<h1>HTTP Header 请求实例</h1>
<table>
<tbody>
<tr bgcolor="#949494"><th>Header 名称</th><th>Header 值</th></tr>
<tr><td>accept</td><td>*/*</td></tr>
<tr><td>accept-language</td><td>en-us</td></tr>
<tr><td>user-agent</td><td>Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; Trident/4.0; InfoPath.2; MS-RTC LM 8)</td></tr>
<tr><td>accept-encoding</td><td>gzip, deflate</td></tr>
<tr><td>host</td><td>localhost:8080</td></tr>
<tr><td>connection</td><td>Keep-Alive</td></tr>
<tr><td>cache-control</td><td>no-cache</td></tr>
</tbody>
</table>
```
- Java 基础
- Java 简介
- Java开发环境配置
- Java基础语法
- Java对象和类
- Java基本数据类型
- Java变量类型
- Java修饰符
- Java运算符
- Java循环结构 - for, while 及 do...while
- Java分支结构 - if...else/switch
- Java Number类
- Java Character类
- Java String类
- Java StringBuffer和StringBuilder类
- Java 数组
- Java 日期时间
- Java正则表达式
- Java 方法
- Java 流(Stream)、文件(File)和IO
- Java 异常处理
- Java 面向对象
- Java 继承
- Java 重写(Override)与重载(Overload)
- Java 多态
- Java 抽象类
- Java 接口
- Java 包(package)
- Java 高级教程
- Java 数据结构
- Java Enumeration接口
- Java Bitset类
- Java Vector 类
- Java Stack 类
- Java Dictionary 类
- Java Hashtable 接口
- Java Properties 接口
- Java 集合框架
- Java 泛型
- Java序列化
- Java 网络编程
- Java 发送邮件
- Java 多线程编程
- Java Applet基础
- Java 文档注释
- Servlet 教程
- Servlet 简介
- Servlet 环境设置
- Servlet 生命周期
- Servlet 实例
- Servlet 表单数据
- Servlet 客户端 HTTP 请求
- Servlet 服务器 HTTP 响应
- Servlet HTTP 状态码
- Servlet 编写过滤器
- Servlet 异常处理
- Servlet Cookies 处理
- Servlet Session 跟踪
- Servlet 数据库访问
- Servlet 文件上传
- Servlet 处理日期
- Servlet 网页重定向
- Servlet 点击计数器
- Servlet 自动刷新页面
- Servlet 发送电子邮件
- Servlet 包
- Servlet 调试
- Servlet 国际化
- JSP 基础
- JSP 简介
- JSP 开发环境搭建
- JSP 结构
- JSP 生命周期
- JSP 语法
- JSP 指令
- JSP 动作元素
- JSP 动作元素
- JSP 隐含对象
- JSP 客户端请求
- JSP 服务器响应
- JSP HTTP 状态码
- JSP 表单处理
- JSP 过滤器
- JSP Cookies 处理
- JSP Session
- JSP 文件上传
- JSP 日期处理
- JSP 页面重定向
- JSP 点击量统计
- JSP 自动刷新
- JSP 发送邮件
- JSP 高级教程
- JSP 标准标签库（JSTL）
- JSP 连接数据库
- JSP XML 数据处理
- JSP JavaBean
- JSP 自定义标签
- JSP 表达式语言
- JSP 异常处理
- JSP 调试
- JSP 国际化
- 免责声明