ServletRequest类及其使用方法介绍

在Java的Servlet技术中，ServletRequest是一个接口，它定义了客户端发送到服务器的请求的API。这个接口提供了获取请求信息的方法，包括参数、头信息、属性等。以下是对ServletRequest接口中一些重要方法的介绍以及它们的使用示例。

ServletRequest接口概述

ServletRequest接口是所有特定于协议的请求对象的超类。例如，HttpServletRequest是ServletRequest的一个子接口，专门用于处理HTTP请求。

ServletRequest接口中的方法

属性相关方法

getAttribute(String name): 获取与指定名称相关联的请求属性的值。
getAttributeNames(): 返回一个枚举，包含所有请求属性的名称。
setAttribute(String name, Object value): 设置请求属性的值。
removeAttribute(String name): 移除指定名称的请求属性。

请求内容相关方法

getCharacterEncoding(): 返回请求的字符编码。
setCharacterEncoding(String enc): 设置请求的字符编码。
getContentLength(): 返回请求体的长度。
getContentLengthLong(): 以long类型返回请求体的长度。
getContentType(): 获取请求体的媒体类型。

输入流和读取器相关方法

getInputStream(): 获取请求体的输入流。
getReader(): 获取请求体的字符流。

参数相关方法

getParameter(String name): 根据参数名获取参数值。
getParameterNames(): 返回一个枚举，包含所有请求参数的名称。
getParameterValues(String name): 获取指定参数的所有值。
getParameterMap(): 获取所有请求参数的映射。

请求上下文信息相关方法

getProtocol(): 获取使用的协议名称和版本。
getScheme(): 获取使用的子协议名称（如http, https）。
getServerName(): 获取服务器的主机名。
getServerPort(): 获取服务器的端口号。
getRemoteAddr(): 获取发出请求的客户端的IP地址。
getRemoteHost(): 获取发出请求的客户端的主机名。

安全相关方法

isSecure(): 检查请求是否使用安全通道，如HTTPS。

其他方法

getRequestDispatcher(String path): 获取用于将请求转发到其他资源的RequestDispatcher对象。
getRealPath(String path): 获取给定虚拟路径的实际路径。
getRemotePort(): 获取发出请求的客户端的端口号。
getLocalName(), getLocalAddr(), getLocalPort(): 获取服务器的相关信息。

异步处理相关方法

从Servlet 3.0开始，ServletRequest接口增加了对异步处理的支持：

startAsync(): 启动异步处理。
startAsync(ServletRequest request, ServletResponse response): 启动异步处理，并提供请求和响应对象。
isAsyncStarted(): 检查是否已启动异步处理。
isAsyncSupported(): 检查容器是否支持异步处理。
getAsyncContext(): 获取异步上下文。
getDispatcherType(): 获取请求的分派类型。

使用示例

假设我们正在开发一个简单的Servlet，用于处理用户提交的表单数据。

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {// 设置请求的字符编码request.setCharacterEncoding("UTF-8");// 获取参数String username = request.getParameter("username");String password = request.getParameter("password");// 检查是否是安全连接if (request.isSecure()) {// 安全连接的处理逻辑}// 获取请求属性String userAttribute = (String) request.getAttribute("userAttribute");// 设置请求属性request.setAttribute("message", "Welcome, " + username);// 获取请求体的长度int contentLength = request.getContentLength();// 使用输入流读取数据try (InputStream inputStream = request.getInputStream()) {// 处理输入流}// 获取请求参数映射Map<String, String[]> parameterMap = request.getParameterMap();// 遍历参数映射for (Map.Entry<String, String[]> entry : parameterMap.entrySet()) {// 处理每个参数}
}