# JSP 客户端请求
当浏览器请求一个网页时，它会向网络服务器发送一系列不能被直接读取的信息，因为这些信息是作为HTTP信息头的一部分来传送的。您可以查阅HTTP协议来获得更多的信息。
下表列出了浏览器端信息头的一些重要内容，在以后的网络编程中将会经常见到这些信息：
| **信息** | **描述** |
| --- | --- |
| Accept | 指定浏览器或其他客户端可以处理的MIME类型。它的值通常为 **image/png** 或 **image/jpeg** |
| Accept-Charset | 指定浏览器要使用的字符集。比如 ISO-8859-1 |
| Accept-Encoding | 指定编码类型。它的值通常为 **gzip** 或**compress** |
| Accept-Language | 指定客户端首选语言，servlet会优先返回以当前语言构成的结果集，如果servlet支持这种语言的话。比如 en，en-us，ru等等 |
| Authorization | 在访问受密码保护的网页时识别不同的用户 |
| Connection | 表明客户端是否可以处理HTTP持久连接。持久连接允许客户端或浏览器在一个请求中获取多个文件。**Keep-Alive** 表示启用持久连接 |
| Content-Length | 仅适用于POST请求，表示 POST 数据的字节数 |
| Cookie | 返回先前发送给浏览器的cookies至服务器 |
| Host | 指出原始URL中的主机名和端口号 |
| If-Modified-Since | 表明只有当网页在指定的日期被修改后客户端才需要这个网页。 服务器发送304码给客户端，表示没有更新的资源 |
| If-Unmodified-Since | 与If-Modified-Since相反， 只有文档在指定日期后仍未被修改过，操作才会成功 |
| Referer | 标志着所引用页面的URL。比如，如果你在页面1，然后点了个链接至页面2，那么页面1的URL就会包含在浏览器请求页面2的信息头中 |
| User-Agent | 用来区分不同浏览器或客户端发送的请求，并对不同类型的浏览器返回不同的内容 |
## HttpServletRequest类
request对象是javax.servlet.http.HttpServletRequest类的实例。每当客户端请求一个页面时，JSP引擎就会产生一个新的对象来代表这个请求。
request对象提供了一系列方法来获取HTTP信息头，包括表单数据，cookies，HTTP方法等等。
接下来将会介绍一些在JSP编程中常用的获取HTTP信息头的方法。详细内容请见下表：
| **方法** | **描述** |
| --- | --- |
| **Cookie[] getCookies()** |返回客户端所有的Cookie的数组 |
| **Enumeration getAttributeNames()** |返回request对象的所有属性名称的集合 |
| **Enumeration getHeaderNames()** |返回所有HTTP头的名称集合 |
| **Enumeration getParameterNames()** |返回请求中所有参数的集合 |
| **HttpSession getSession()** |返回request对应的session对象，如果没有，则创建一个 |
| **HttpSession getSession(boolean create)** |返回request对应的session对象，如果没有并且参数create为true，则返回一个新的session对象 |
| **Locale getLocale()** |返回当前页的Locale对象，可以在response中设置 |
| **Object getAttribute(String name)** |返回名称为name的属性值，如果不存在则返回null。 |
| **ServletInputStream getInputStream()** |返回请求的输入流 |
| **String getAuthType()** |返回认证方案的名称，用来保护servlet，比如 "BASIC" 或者 "SSL" 或 null 如果 JSP没设置保护措施 |
| **String getCharacterEncoding()** |返回request的字符编码集名称 |
| **String getContentType()** |返回request主体的MIME类型，若未知则返回null |
| **String getContextPath()** |返回request URI中指明的上下文路径 |
| **String getHeader(String name)** |返回name指定的信息头 |
| **String getMethod()** |返回此request中的HTTP方法，比如 GET,，POST，或PUT |
| **String getParameter(String name)** |返回此request中name指定的参数，若不存在则返回null |
| **String getPathInfo()** |返回任何额外的与此request URL相关的路径 |
| **String getProtocol()** |返回此request所使用的协议名和版本 |
| **String getQueryString()** |返回此 request URL包含的查询字符串 |
| **String getRemoteAddr()** |返回客户端的IP地址 |
| **String getRemoteHost()** |返回客户端的完整名称 |
| **String getRemoteUser()** |返回客户端通过登录认证的用户，若用户未认证则返回null |
| **String getRequestURI()** |返回request的URI |
| **String getRequestedSessionId()** |返回request指定的session ID |
| **String getServletPath()** |返回所请求的servlet路径 |
| **String[] getParameterValues(String name)** |返回指定名称的参数的所有值，若不存在则返回null |
| **boolean isSecure()** |返回request是否使用了加密通道，比如HTTPS |
| **int getContentLength()** |返回request主体所包含的字节数，若未知的返回-1 |
| **int getIntHeader(String name)** |返回指定名称的request信息头的值 |
| **int getServerPort()** |返回服务器端口号 |
## HTTP信息头示例
在这个例子中，我们会使用HttpServletRequest类的getHeaderNames()方法来读取HTTP信息头。这个方法以枚举的形式返回当前HTTP请求的头信息。
获取Enumeration对象后，用标准的方式来遍历Enumeration对象，用hasMoreElements()方法来确定什么时候停止，用nextElement()方法来获得每个参数的名字。
```
<%@ page import="java.io.*,java.util.*" %>
<html>
<head>
<title>HTTP Header Request Example</title>
</head>
<body>
<center>
<h2>HTTP Header Request Example</h2>
<table width="100%" border="1" align="center">
<tr bgcolor="#949494">
<th>Header Name</th><th>Header Value(s)</th>
</tr>
<%
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");
}
%>
</table>
</center>
</body>
</html>
```
访问main.jsp，将会得到以下结果：
```
<h1>HTTP Header Request Example</h1>
<table width="100%" border="1" align="center">
<tbody>
<tr><th>Header Name</th><th>Header Value(s)</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>
```
您可以在上面代码中尝试HttpServletRequest类的其它方法。
- 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 国际化
- 免责声明