HttpServletRequest简介
HttpServletRequest是什么？
- HttpServletRequest是一个接口，其父接口是ServletRequest；
- HttpServletRequest是Tomcat将请求报文转换封装而来的对象，在Tomcat调用service方法时传入；
- HttpServletRequest代表客户端发来的请求，请求中的所有信息都可以通过该对象获得；
如何使用HttpServletRequest？
获取请求行信息相关方法：
这些方法用于获取客户端发送请求时的信息，包括 URL、协议、方法、端口等。
| API | 功能解释 |
|---|---|
StringBuffer getRequestURL() | 获取客户端请求的完整 URL。 |
String getRequestURI() | 获取客户端请求的项目目录的具体资源。 |
int getServerPort() | 获取客户端发送请求时使用的服务器端口。 |
int getLocalPort() | 获取应用程序所在容器的端口。 |
int getRemotePort() | 获取客户端程序所使用的端口。 |
String getScheme() | 获取请求的协议（如 HTTP、HTTPS）。 |
String getProtocol() | 获取请求使用的协议及版本号（如 HTTP/1.1）。 |
String getMethod() | 获取请求的 HTTP 方法（如 GET、POST）。 |
获取请求头信息相关方法：
这些方法用于处理请求头信息，包括获取特定请求头或所有请求头的名称。
| API | 功能解释 |
|---|---|
String getHeader(String headerName) | 根据头名称获取请求头的值。 |
Enumeration getHeaderNames() | 获取所有的请求头名称。 |
String getContentType() | 获取 Content-Type 请求头。 |
package Servlet;
import jakarta.servlet.ServletException;
import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;import java.io.IOException;
import java.util.Enumeration;@WebServlet("/servlet04")
public class servlet4_1 extends HttpServlet {@Overrideprotected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {// 行情求相关 get/post uri http/1.1System.out.println(req.getMethod()); // 获取请求方式System.out.println(req.getScheme()); // 获取请求协议System.out.println(req.getProtocol()); //获取请求协议及其版本System.out.println(req.getRequestURI());// 获取请求的uri 项目内的资源路径System.out.println(req.getRequestURL());// 获取请求的url 项目内的资源的完成的路径System.out.println(req.getLocalPort());//本应用容器的端口号8080System.out.println(req.getServerPort()); // 客户端发请求时使用的端口号System.out.println(req.getRemotePort());// 客户端软件的端口号System.out.println("--------------------头请求-------------------------");// 根据名字单独获取请求头String accept = req.getHeader("Accept");System.out.println("Accept :" + accept );// 获取本次请求中所有的请求头的名字System.out.println("--------------------所有请求头----------------------");Enumeration<String> headNames = req.getHeaderNames();while(headNames.hasMoreElements()){String hname = headNames.nextElement();System.out.println(hname +" : " +req.getHeader(hname));}}
}
控制台输出：
浏览器的报文内容
获取请求参数相关API
| API | 功能解释 |
|---|---|
String getParameter(String parameterName) | 根据请求参数名获取请求单个参数值。 |
String[] getParameterValues(String parameterName) | 根据请求参数名获取请求多个参数值数组。 |
Enumeration getParameterNames() | 获取所有请求参数名。 |
Map<String, String[]> getParameterMap() | 获取所有请求参数的键值对集合。 |
BufferedReader getReader() throws IOException | 获取读取请求体的字符输入流。（JSON串） |
ServletInputStream getInputStream() throws IOException | 获取读取请求体的字节输入流。（读文件） |
int getContentLength() | 获取请求体长度的字节数。 |
package Servlet;import jakarta.servlet.ServletException;
import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;import java.io.IOException;
import java.util.Arrays;
import java.util.Enumeration;
import java.util.Map;
import java.util.Set;@WebServlet ("/servlet05")
public class servlet4_2 extends HttpServlet {@Overrideprotected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {// 获取键值对形式的参数// 获取请求中的参数String username = req.getParameter("username");System.out.println(username);String password = req.getParameter("usePsw");System.out.println(password);// 根据参数名获取多个参数值String[] hobbies = req.getParameterValues("hobby");System.out.println(Arrays.toString(hobbies));// 获取所有的参数名Enumeration<String> pnames = req.getParameterNames();while(pnames.hasMoreElements()){String pname = pnames.nextElement();String[] values = req.getParameterValues(pname);if(values.length > 1){System.out.println(Arrays.toString(values));}else System.out.println(pname + " = " + values[0]);}System.out.println("----------------Map--------------------");// 返回所有参数的map集合 key = 参数名 value = 参数值Map<String,String[]> parameterMap = req.getParameterMap();Set<Map.Entry<String,String[]>> entries = parameterMap.entrySet();for (Map.Entry<String,String[]> entry : entries){String pname = entry.getKey();String[] value = entry.getValue();if(value.length > 1){System.out.println(pname +" = " + Arrays.toString(value));} else System.out.println(pname + " = " + value[0]);}}}
.System.out.println(Arrays.toString(hobbies))：
Arrays.toString(hobbies)将数组hobbies转换为字符串表示形式（如["reading", "swimming", "coding"]），方便输出查看。System.out.println会将转换后的字符串打印到控制台，便于开发者检查获取到的参数值
HTML代码
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Title</title>
</head>
<body>
# 可以改成post方法，Java代码同样可以处理
<form action="servlet05" method="get"><input type="text" name="username"> <br><input type="password" name="usePsw"> <br>爱好：<input type="checkbox" name="hobby" value="1"> 篮球<input type="checkbox" name="hobby" value="2"> 足球<input type="checkbox" name="hobby" value="3"> 排球<input type="checkbox" name="hobby" value="4"> 铅球<input type="submit" >
</form>
</body>
</html>Get请求和post请求的区别
数据传递方式
- GET 请求：
- 数据通过 URL 查询字符串 传递，放在 URL 的末尾。
- 例如：
GET /search?query=java HTTP/1.1，其中query=java是查询参数。 - 查询字符串长度受浏览器和服务器的限制（通常在 2000 个字符左右）。
- POST 请求：
- 数据通过 请求体（body） 传递，而不是 URL。这使得 POST 请求适合传输较大或复杂的数据。
- 例如：
POST /submit HTTP/1.1，数据放在请求体中（如表单数据或 JSON 数据）。
其他常用API
| API | 功能解释 |
|---|---|
String getServletPath() | 获取请求的 Servlet 的映射路径。（就是WebServlet ("/servlet05")中的 /servlet05） |
ServletContext getServletContext() | 获取 ServletContext 对象，用于与 Servlet 环境交互。 |
Cookie[] getCookies() | 获取请求中所有的 Cookie。 |
HttpSession getSession() | 获取 HttpSession 对象，处理会话信息。 |
void setCharacterEncoding(String encoding) | 设置请求体字符编码。 |
HttpServletRequest怎么用？
. 设置响应行相关：
| API | 功能解释 |
|---|---|
void setStatus(int code) | 设置响应状态码 |
setStatus(int code)：用于设置 HTTP 响应的状态码，如200（成功）、404（未找到）、500（服务器内部错误）等。
2. 设置响应头相关：
| API | 功能解释 |
|---|---|
void setHeader(String headerName, String headerValue) | 设置或修改响应头键值对。 |
void setContentType(String contentType) | 设置 Content-Type 响应头以及字符集（设置 MIME 类型）。 |
setHeader(String headerName, String headerValue)：用于设置或修改 HTTP 响应头信息。例如，设置Content-Type、Cache-Control等。setContentType(String contentType)：用于设置Content-Type响应头，指定返回内容的类型，如text/html、application/json等。
3. 设置响应体相关：
| API | 功能解释 |
|---|---|
PrintWriter getWriter() throws IOException | 获取响应输出体放入信息的字符输出流（通常用于文本）。 |
ServletOutputStream getOutputStream() throws IOException | 获取响应输出体放入信息的字节输出流（通常用于二进制数据）。 |
void setContentLength(int length) | 设置响应体的字节长度，其实质是在设置 Content-Length 响应头。 |
getWriter()：用于获取PrintWriter对象，可以通过它向客户端发送字符数据（如 HTML、JSON、纯文本等）。getOutputStream()：用于获取ServletOutputStream对象，通常用于发送二进制数据（如图片、PDF 等）。setContentLength(int length)：设置响应体的字节长度，用于告诉客户端响应内容的大小
package Servlet;import jakarta.servlet.ServletException;
import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;import java.io.IOException;
import java.io.PrintWriter;@WebServlet("/servlet06")
public class servlet4_3 extends HttpServlet {@Overrideprotected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {// 设置响应行相关的API
// resp.setStatus(404); // 故意响应404resp.setStatus(200);// 设置响应头相关的API
// resp.setHeader("aaa","valuea");
// resp.setHeader("Content-Type","text/html");
// resp.setHeader("Content-Length","1234");String info = "<h1>hello<h1>";resp.setContentType("text/html");resp.setContentLength(info.length());// 设置响应体内容的API// 获得一个响应体中输入文本字符输出流PrintWriter writer = resp.getWriter();writer.write(info);}
}