HttpServletRequest
1、HttpServletRequest对象
在Servlet API中，定义了一个HttpServletRequest接口，它继承自ServletRequest接口，专门用于封装HTTP请求消息
1.1 获取请求行信息的相关方法
当访问Servlet时，请求消息的请求行中会包含请求方法、请求资源名、请求路径等信息。因此HttpServletRequest接口定义了一系列用于获取请求行的方法
- 1、String getMethod（）
功能：获取HTTP请求消息中的请求方式（例如GET、POST等）
- 2、String getRequestURI（）
功能：获取请求行中资源名称部分，即位于URL的主机和端口之后、参数部分之前的数据
- 3、String getQueryString（）
功能：获取请求行中的参数部分，也就是资源路径后面问号（？）以后的所有内容
- 4、String getProtocol（）
功能：获取请求行中的协议名和版本，例如HTTP/1.0或HTTP/1.1
- 5、String getContextPath（）
功能：获取请求URL中属于Web应用程序的路径，这个路径以“/“开头，表示相对于整个Web站点的根目录，路径结尾不含“/”。如果请求URL属于Web站点的根目录，那么返回结果为空字符串（“”）
- 6、String getServletPath（）
功能：获取Servlet的名称或Servlet所映射的路径
- 7、String getRemoteAddr（）
功能：获取请求客户端的IP地址，其格式类似于“192.168.0.3”
- 8、String getRemoteHost（）
功能：获取请求客户端的完整主机名，其格式类似于“pc1.itcast.cn”。需要注意的是，如果无法解析出客户机的完整主机名，该方法会返回客户端的IP地址
- 9、int getRemotePort（）
功能：获取请求客户端网络连接的端口号
- 10、String getLocalAddr（）
功能：获取Web服务器上接收当前请求网络连接的IP地址
- 11、String getLocalName（）
功能：获取Web服务器上接收当前请求网络连接的IP所对应的主机名
- 12、int getLocalPort（）
功能：获取Web服务器上接收当前请求网络连接的端口号
- 13、String getServerName（）
功能：获取当前请求所指向的主机名，即HTTP请求消息中Host头字段所对应的主机名部分
- 14、int getServerPort（）
功能：获取当前请求所连接的服务器端口号，即HTTP请求消息中Host头字段所对应的端口号部分
- 15、String getScheme（）
功能：获取请求的协议名，例如HTTP、HTTPS或FTP
- 16、StringBuffer getRequestURL（）
功能：获取客户端发出请求时的完整URL，包括协议、服务器名、端口号、资源路径等信息，但不包括后面的查询参数部分。需要注意的是，getRequestURL（）方法返回的结果时StringBuffer类型，而不是String类型，这样便于对结果进行修改
案例：
1.2 获取请求头的相关方法
当请求Servlet时，需要通过请求头向服务器传递附加消息，例如客户端可以接受的数据类型、压缩方式、语言等。为此HttpServletRequest接口定义了一系列用于获取HTTP请求头字段的方法
- 1、String getHeader（String name）
功能：获取一个指定头字段的值，若没有指定头字段则返回null，若含有多个则返回一个头字段值
- 2、Enumeration getHeaders（String name）
功能：返回一个Enumeration集合对象，该集合对象由请求消息中出现的某个指定名称的所有头字段值组成。在多数情况下，一个头字段名在请求消息中只出现了一次，但有时候可能出现多次
- 3、Enumeration getHeaderNames（）
功能：获取一个包含所有请求头字段的Enumeration对象
- 4、int getIntHeader（String name）
功能：获取指定名称的头字段，并且将其值转为int类型。需要注意的是，如果指定名称的头字段不存在，返回值为-1；如果获取到的头字段的值不能转为int类型，将发生NumberFormatException异常
- 5、long getDateHeader（String name）
功能：获取指定头字段的值，并将其按GMT时间格式转换成一个代表日期/时间的长整数，这个长整数是自1970年1月1日0点0分0秒算起的以毫秒为单位的时间值
- 6、String getContentType（）
功能：获取Content-Type头字段的值，结果为String类型
- 7、int getContentLength（）
功能：获取Content-Length头字段的值，结果为int类型
- 8、String getCharacterEncoding（）
功能：返回请求消息的实体部分的字符集编码，通常从Content-Type头字段中进行提取，结果为String类型
案例：
1.3 请求转发
Servlet之间可以相互跳转，利用Servlet的跳转可以很容易把一项任务按模块分开
Servlet的跳转要通过RequestDispatcher接口的实例对象实现
HttpServletRequest接口提供了getRequestDispatcher（）方法用于获取RequestDispatcher对象
- RequestDispatcher getRequestDispatcher（String path）
该方法返回封装了某条路径所指定资源的RequestDispatcher对象
参数path必须以 “/” 开头，用于表示当前Web应用的根目录
注意：WEB-INF目录中的内容对RequestDispatcher对象也是可见的，因此传递给该方法的资源可以是WEB-INF目录中的文件
获取到RequestDispatcher对象后，如果当前Web资源不想处理请求，RequestDispatcher接口提供了一个forward（）方法，该方法可以将当前请求传递给其他Web资源，由其他资源对这些信息进行处理并将响应提交给客户端，这种方式被称为请求转发
- forward（ServletRequest request，ServletRespon respon）
forward方法用于将请求从一个Servlet传递给另一个Web资源。在Servlet中，可以对请求做一个初步处理，然后通过调用forward方法将请求传递给其他资源进行响应
注意：该方法必须在将响应提交给客户端之前被调用，否则将抛出IllegalStateException异常
forward工作原理：
当浏览器访问Servlet1时，可以通过forward（）方法将请求转发给其他Web资源，其他Web资源处理完请求后，直接将响应结果返回到浏览器
案例：使用RequestForwardServlet类将请求转发到一个新的Servlet页面
地址栏显示的是RequestForwardServlet的请求路径，但是浏览器却显示除了ResultServlet中要输出的内容。这是因为请求转发是发生在服务器内部的行为，从RequestForwardServlet到ResultServlet属于一次请求，在一次请求中可以使用request属性进行数据共享
1.4 获取请求参数
HttpServletRequest接口中定义了一系列获取参数的方法
- 1、String getParameter（String name）
功能：获取某个指定名称的参数值，如果请求消息中没有包含指定名称的参数则返回null；如果指定名称的参数存在但没有设置值则返回一个空串；如果包含多个指定名称的参数则返回第一个出现的参数值
- 2、String[] getParameterValues（String name）
功能：返回一个String类型的数组，HTTP请求消息中可以有多个相同名称的参数（通常由一个包含多个同名的字段元素的form表单生成）
- 3、Enumeration getParameterNames（）
功能：返回一个包含请求消息中所有参数名的Enumeration对象，在此基础上可以对请求消息中的所有参数进行遍历处理
- 4、Map getParameterMap（）
功能：将请求消息中的所有参数名和值装入一个Map对象中返回
案例;
1.5 通过Request对象传递数据
Request对象不仅可以获取一系列数据，还可以通过属性传递数据
- 1、void setAttribute（）
功能：将一个对象和一个name关联后存储进ServletRequest对象中
注意：如果已经存在指定名称的属性，该方法会先删除原来的属性，然后再添加新属性，如果传的是null则等于removeAttribute（）
- 2、Obj getAttribute（）
功能：从ServletRequest对象中返回指定名称的属性对象
- 3、void removeAttribute（）
功能：从ServletRequest对象中删除指定名称的属性
- 4、Enumation getAttributeNames（）
功能：返回一个包含所有ServletRequest对象中的属性名的Enumeration对象