[Java Web]Request对象 | 超1w字带你熟悉Servlet中的request请求

⭐作者介绍：大二本科网络工程专业在读，持续学习Java，输出优质文章

⭐所属专栏：Java Web

⭐如果觉得文章写的不错，欢迎点个关注😉有写的不好的地方也欢迎指正，一同进步😁

目录

Request对象

1、Request继承体系

2、Request获取请求数据

2.1、获取请求行数据

2.2、获取请求头数据

2.3、获取请求体数据

2.4、获取请求参数的通用方式

2.5、完整代码

3、IDEA快速创建Servlet

4、请求参数中文乱码问题

4.1、🔺POST请求解决方案

4.2、🔺🔺GET请求解决方案

5、Request请求转发

---

Request对象

1、Request继承体系

在学习这节内容之前，先思考一个问题，前面在介绍Request和Reponse对象的时候：

• 当Servlet类实现的是Servlet接口的时候，service方法中的参数是ServletRequest和ServletResponse

• 当Servlet类继承的是HttpServlet类的时候，doGet和doPost方法中的参数就变成HttpServletRequest和HttpServletReponse

那么：

• ServletRequest和HttpServletRequest的关系是什么?

• request对象是有谁来创建的?

• request提供了哪些API，这些API从哪里查?

首先，先看Request的继承体系：

​

从上图中可以看出，ServletRequest和HttpServletRequest都是Java提供的，所以我们可以打开JavaEE提供的API文档查看：

​

​

所以ServletRequest和HttpServletRequest是继承关系，并且两个都是接口，接口是无法创建对象，这个时候就引发了下面这个问题：方法参数中传递的对象是由谁创建的

​

这个时候，就需要用到Request继承体系中的RequestFacade：

• 该类实现了HttpServletRequest接口，也间接实现了ServletRequest接口。

• Servlet类中的service方法、doGet方法或者是doPost方法最终都是由Web服务器[Tomcat]来调用的，所以Tomcat提供了方法参数接口的具体实现类，并完成了对象的创建

• 要想了解RequestFacade中都提供了哪些方法，可以直接查看JavaEE的API文档中关于ServletRequest和HttpServletRequest的接口文档，因为RequestFacade实现了其接口就需要重写接口中的方法

对于上述结论，要想验证，可以编写一个Servlet，在方法中把request对象打印下，就能看到最终的对象是不是RequestFacade,代码如下：

@WebServlet("/demo2")
public class Demo2 extends HttpServlet {@Overrideprotected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {System.out.println(request);}@Overrideprotected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {}
}

启动服务器，运行访问,得到运行结果:

​

小结：

• Request的继承体系为ServletRequest-->HttpServletRequest-->RequestFacade

• Tomcat需要解析请求数据，封装为request对象,并且创建request对象传递到service方法

• 使用request对象，可以查阅JavaEE API文档的HttpServletRequest接口中方法说明

2、Request获取请求数据

HTTP请求数据总共分为三部分内容，分别是请求行、请求头、请求体，对于这三部分内容的数据，分别该如何获取，首先我们先来学习请求行数据如何获取?

2.1、获取请求行数据

请求行包含三块内容，分别是请求方式、请求资源路径、HTTP协议及版本

​

对于这三部分内容，request对象都提供了对应的API方法来获取，具体如下:

• 获取请求方式: GET->String getMethod()

• 获取虚拟目录(项目访问路径): /Servlet->String getContextPath()

• 获取URL(统一资源定位符): http://localhost:8080/Servlet/req1->StringBuffer getRequestURL()

• 获取URI(统一资源标识符): /Servlet/req1->String getRequestURI()

• 获取请求参数(GET方式): username=zhangsan&password=123->String getQueryString()

介绍完上述方法后，下面通过代码把上述方法都使用下:

package com.xzl.Request_Response;import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;/*** @author ︶ㄣ释然* @date 2023/3/10 8:46* request 获取请求数据*/
@WebServlet("/demo3")
public class Demo3 extends HttpServlet {@Overrideprotected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {// String getMethod()：获取请求方式： GETString method = req.getMethod();System.out.println(method);//GET// String getContextPath()：获取虚拟目录(项目访问路径)：//ServletString contextPath = req.getContextPath();System.out.println(contextPath);// StringBuffer getRequestURL(): 获取URL(统一资源定位符)：http://localhost:8080/Servlet/demo3StringBuffer url = req.getRequestURL();System.out.println(url.toString());// String getRequestURI()：获取URI(统一资源标识符)： /Servlet/demo3String uri = req.getRequestURI();System.out.println(uri);// String getQueryString()：获取请求参数（GET方式）： name=ZiLin+XString queryString = req.getQueryString();System.out.println(queryString);}@Overrideprotected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {}
}

启动服务器，访问http://localhost:8080/Servlet/demo3?name=ZiLin+X，获取的结果如下:

​

2.2、获取请求头数据

对于请求头的数据，格式为key: value如下:

​

所以根据请求头名称获取对应值的方法为：->String getHeader(String name)

接下来，在代码中如果想要获取客户端浏览器的版本信息，则可以使用

/*** request 获取请求数据*/
@WebServlet("/version")
public class version extends HttpServlet {@Overrideprotected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {//获取请求头: user-agent: 浏览器的版本信息String agent = req.getHeader("user-agent");System.out.println(agent);}@Overrideprotected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {}
}

重新启动服务器后，获取的结果如下:

​

2.3、获取请求体数据

浏览器在发送GET请求的时候是没有请求体的，所以需要把请求方式变更为POST，请求体中的数据格式如下:

​

对于请求体中的数据，Request对象提供了如下两种方式来获取其中的数据，分别是:

• 获取字节输入流，如果前端发送的是字节数据，比如传递的是文件数据，则使用该方法

ServletInputStream getInputStream() 该方法可以获取字节

• 获取字符输入流，如果前端发送的是纯文本数据，则使用该方法

BufferedReader getReader()

接下来，需要思考，要想获取到请求体的内容该如何实现?

具体实现的步骤如下:

1.准备一个页面，在页面中添加form表单,用来发送post请求

2.在Servlet的doPost方法中获取请求体数据

3.在doPost方法中使用request的getReader()或者getInputStream()来获取

4.访问测试

详细步骤：

1、在项目的webapp目录下添加一个html页面，名称为：req.html

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Title</title>
</head>
<body>
<!--action:form表单提交的请求地址method:请求方式，指定为post
-->
<form action="/Servlet/req1" method="post"><input type="text" name="username"><input type="password" name="password"><input type="submit">
</form>
</body>
</html>

 2、在Servlet的doPost方法中获取数据

调用getReader()或者getInputStream()方法，因为目前前端传递的是纯文本数据，所以我们采用getReader()方法来获取

package com.xzl.Request_Response;/*** @author ︶ㄣ释然* @date 2023/3/10 10:27*/import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.BufferedReader;
import java.io.IOException;/*** request 获取请求数据*/
@WebServlet("/req1")
public class req1 extends HttpServlet {@Overrideprotected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {}@Overrideprotected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {//在此处获取请求体中的数据//获取post 请求体：请求参数//1. 获取字符输入流BufferedReader br = req.getReader();//2. 读取数据String line = br.readLine();System.out.println(line);}
}

 3、启动服务器，通过浏览器访问http://localhost:8080/Servlet/req.html

​

点击提交按钮后，就可以在控制台看到前端所发送的请求数据

​

注意

BufferedReader流是通过request对象来获取的，当请求完成后request对象就会被销毁，request对象被销毁后，BufferedReader流就会自动关闭，所以此处就不需要手动关闭流了。

小结

HTTP请求数据中包含了请求行、请求头和请求体，针对这三部分内容，Request对象都提供了对应的API方法来获取对应的值:

1. 请求行
   1. getMethod()获取请求方式
   2. getContextPath()获取项目访问路径
   3. getRequestURL()获取请求URL
   4. getRequestURI()获取请求URI
   5. getQueryString()获取GET请求方式的请求参数
2. 请求头：getHeader(String name)根据请求头名称获取其对应的值
3. 请求体
   1. 注意: 浏览器发送的POST请求才有请求体
   2. 如果是纯文本数据:getReader()
   3. 如果是字节数据如文件数据:getInputStream()

2.4、获取请求参数的通用方式

在介绍下面内容之前，先提出两个问题:

1. 什么是请求参数?
2. 请求参数和请求数据的关系是什么?

1、什么是请求参数?

为了能更好的回答上述两个问题，这里拿用户登录的例子来说明：

1.1 想要登录网址，需要进入登录页面

1.2 在登录页面输入用户名和密码

1.3 将用户名和密码提交到后台

1.4 后台校验用户名和密码是否正确

1.5 如果正确，则正常登录，如果不正确，则提示用户名或密码错误

上述例子中，用户名和密码其实就是所谓的请求参数。

2.什么是请求数据?

请求数据则是包含请求行、请求头和请求体的所有数据

3.请求参数和请求数据的关系是什么?

3.1 请求参数是请求数据中的部分内容

3.2 如果是GET请求，请求参数在请求行中

3.3 如果是POST请求，请求参数一般在请求体中

对于请求参数的获取，常用的有以下两种:

• GET方式->String getQueryString()

• POST方式->BufferedReader getReader();

练习一个案例需求:

（1）发送一个GET请求并携带用户名，后台接收后打印到控制台

（2）发送一个POST请求并携带用户名，后台接收后打印到控制台

此处大家需要注意的是GET请求和POST请求接收参数的方式不一样，具体实现的代码如下:

package com.xzl.Request_Response;/*** @author ︶ㄣ释然* @date 2023/3/10 10:27*/import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.BufferedReader;
import java.io.IOException;/*** request 获取请求数据*/
@WebServlet("/req1")
public class req1 extends HttpServlet {@Overrideprotected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {String result = req.getQueryString();System.out.println(result);}@Overrideprotected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {//在此处获取请求体中的数据//获取post 请求体：请求参数//1. 获取字符输入流BufferedReader br = req.getReader();//2. 读取数据String line = br.readLine();System.out.println(line);}
}

• 对于上述的代码，会存在什么问题呢?

由于请求方式不一样，导致两个方法中存在着大量重复代码

• 如何解决上述重复代码的问题?

​

需要注意的是，doGet和doPost方法都必须存在，不能删除任意一个。

使用request的getMethod()来获取请求方式，根据请求方式的不同分别获取请求参数值，这样就可以解决上述问题，但是以后每个Servlet都需要这样写代码，实现起来比较麻烦，所以这种方法不采用。

更好的解决方案：

request对象已经将上述获取请求参数的方法进行了封装，并且request提供的方法实现的功能更强大，以后只需要调用request提供的方法即可，在request的方法中都实现了哪些操作?

(1)根据不同的请求方式获取请求参数，获取的内容如下:

​

(2)把获取到的内容进行分割，内容如下:

​

(3)把分割后端数据，存入到一个Map集合中

注意:因为参数的值可能是一个，也可能有多个，所以Map的值的类型为String数组。

基于上述理论，request对象提供了如下方法:

• 获取所有参数Map集合->Map<String,String[]> getParameterMap()

• 根据名称获取参数值（数组）->String[] getParameterValues(String name)

• 根据名称获取参数值(单个值)->String getParameter(String name)

接下来，通过案例来把上述的三个方法进行实例演示:

1.修改req.html页面，添加爱好选项，爱好可以同时选多个

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Title</title>
</head>
<body>
<form action="/Servlet/req2" method="get"><input type="text" name="username"><br><input type="password" name="password"><br><input type="checkbox" name="hobby" value="1"> 游泳<input type="checkbox" name="hobby" value="2"> 爬山 <br><input type="submit">
</form>
</body>
</html>

​

2.在Servlet代码中获取页面传递GET请求的参数值 [完整代码放在本小节2.2的最后]

2.1获取GET方式的所有请求参数

​

获取的结果为:

​

2.2获取GET请求参数中的爱好，结果是数组值

​

获取的结果为:

​

2.3、获取GET请求参数中的用户名和密码，结果是单个值

​

获取的结果为:

​

3.在Servlet代码中获取页面传递POST请求的参数值

3.1将req.html页面form表单的提交方式改成post

3.2将doGet方法中的内容复制到doPost方法中即可

​

2.5、完整代码

package com.xzl.Request_Response;/*** @author ︶ㄣ释然* @date 2023/3/10 17:39*/import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.text.MessageFormat;
import java.util.Map;/*** request 通用方式获取请求参数*/
@WebServlet("/req2")
public class req2 extends HttpServlet {@Overrideprotected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {//GET请求逻辑System.out.println("get....");//1. 获取所有参数的Map集合Map<String, String[]> map = req.getParameterMap();for (String key : map.keySet()) {// username:XuZiLinSystem.out.print(key + ":");//获取值String[] values = map.get(key);for (String value : values) {System.out.print(value + " ");}System.out.println();}//2、获取GET请求参数中的爱好，结果是数组值System.out.println("-------------");String[] hobbies = req.getParameterValues("hobby");for (String hobby : hobbies) {System.out.println(hobby);}//3、获取GET请求参数中的用户名和密码，结果是单个值String username = req.getParameter("username");String password = req.getParameter("password");System.out.println(MessageFormat.format("username：{0}\npassword：{1}", username, password));}@Overrideprotected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {System.out.println("post....");this.doGet(req,resp);}
}

3、IDEA快速创建Servlet

由于一开始创建Servlet的时候，有一些代码是固定要写的，即有固定格式，那么可以通过IDEA来设置创建模板，从而实现快速创建。[可以根据自己的需求修改模板内容]

​

使用Servlet模板创建模板类：

​

​

创建成功：

​

4、请求参数中文乱码问题

不管是GET还是POST请求，在发送的请求参数中如果有中文，在后台接收的时候，都会出现中文乱码的问题。

4.1、🔺POST请求解决方案

分析出现中文乱码的原因：

• POST的请求参数是通过request的getReader()来获取流中的数据
• TOMCAT在获取流的时候采用的编码是ISO-8859-1
• ISO-8859-1编码是不支持中文的，所以会出现乱码

解决方案：

• 页面设置的编码格式为UTF-8
• 把Tomcat在获取流数据之前的编码设置为UTF-8
• 通过request.setCharacterEncoding("UTF-8")设置编码,UTF-8也可以写成小写

重新发送POST请求，就会在控制台看到正常展示的中文结果。

至此POST请求中文乱码的问题就已经解决，但是这种方案不适用于GET请求

4.2、🔺🔺GET请求解决方案

刚才提到一个问题是POST请求的中文乱码解决方案为什么不适用GET请求？

• GET请求获取请求参数的方式是request.getQueryString()

• POST请求获取请求参数的方式是request.getReader()

• request.setCharacterEncoding("utf-8")是设置request处理流的编码

• getQueryString方法并没有通过流的方式获取数据

所以GET请求不能用设置编码的方式来解决中文乱码问题

如何解决GET的编码问题：

首先需要先分析下GET请求出现乱码的原因:

​

(1)浏览器通过HTTP协议发送请求和数据给后台服务器（Tomcat)

(2)浏览器在发送HTTP的过程中会对中文数据进行URL编码

(3)在进行URL编码的时候会采用页面<meta>标签指定的UTF-8的方式进行编码，张三编码后的结果为%E5%BC%A0%E4%B8%89

(4)后台服务器(Tomcat)接收到%E5%BC%A0%E4%B8%89后会默认按照ISO-8859-1进行URL解码

(5)由于前后编码与解码采用的格式不一样，就会导致后台获取到的数据为乱码。

补充两个知识点：

URL编码

具体编码过程分两步，分别是:

(1)将字符串按照编码方式转为二进制

(2)每个字节转为2个16进制数并在前边加上%

张三按照UTF-8的方式转换成二进制的结果为：

1110 0101 1011 1100 1010 0000 1110 0100 1011 1000 1000 1001

在Java中已经提供了编码和解码的API工具类可以让我们更快速的进行编码和解码：

编码->java.net.URLEncoder.encode("需要被编码的内容","字符集(UTF-8)")

解码->java.net.URLDecoder.decode("需要被解码的内容","字符集(UTF-8)")

接下来对张三来进行编码和解码

public class URLDemo {public static void main(String[] args) throws UnsupportedEncodingException {String username = "张三";//1. URL编码String encode = URLEncoder.encode(username, "utf-8");System.out.println(encode); //打印:%E5%BC%A0%E4%B8%89//2. URL解码//String decode = URLDecoder.decode(encode, "utf-8");//打印:张三String decode = URLDecoder.decode(encode, "ISO-8859-1");//打印:`å¼ ä¸ `System.out.println(decode);}
}

到这，我们就可以分析出GET请求中文参数出现乱码的原因了：

• 浏览器把中文参数按照UTF-8进行URL编码

• Tomcat对获取到的内容进行了ISO-8859-1的URL解码

• 在控制台就会出现类上å¼ ä¸的乱码，最后一位是个空格

清楚了出现乱码的原因，接下来提出解决办法：

​

从上图可以看出：

• 在进行编码和解码的时候，不管使用的是哪个字符集，他们对应的%E5%BC%A0%E4%B8%89是一致的

• 那他们对应的二进制值也是一样的，为:

1110 0101 1011 1100 1010 0000 1110 0100 1011 1000 1000 1001

• 所以可以考虑把å¼ ä¸转换成字节，再把字节转换成张三，在转换的过程中使它们的编码一致，就可以解决中文乱码问题。

具体的实现步骤为:

1.按照ISO-8859-1编码获取乱码å¼ ä¸对应的字节数组

2.按照UTF-8编码获取字节数组对应的字符串

实现代码如下:

public class URLDemo {public static void main(String[] args) throws UnsupportedEncodingException {String username = "张三";//1. URL编码String encode = URLEncoder.encode(username, "utf-8");System.out.println(encode);//2. URL解码String decode = URLDecoder.decode(encode, "ISO-8859-1");System.out.println(decode); //此处打印的是对应的乱码数据//3. 转换为字节数据,编码byte[] bytes = decode.getBytes("ISO-8859-1");for (byte b : bytes) {System.out.print(b + " ");}//此处打印的是:-27 -68 -96 -28 -72 -119//4. 将字节数组转为字符串，解码String s = new String(bytes, "utf-8");System.out.println(s); //此处打印的是张三}
}

至此对于GET请求中文乱码的解决方案，我们就已经分析完了，最后在代码中去实现下:

/*** 中文乱码问题解决方案*/
package com.xzl.Request_Response; /*** @author ︶ㄣ释然* @date 2023/3/10 18:49*/import javax.servlet.*;
import javax.servlet.http.*;
import javax.servlet.annotation.*;
import java.io.IOException;
import java.nio.charset.StandardCharsets;@WebServlet("/GarbledCode")
public class GarbledCode extends HttpServlet {@Overrideprotected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {String username = request.getParameter("username");byte[] bytes = username.getBytes(StandardCharsets.ISO_8859_1);username = new String(bytes,StandardCharsets.UTF_8);}@Overrideprotected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {this.doGet(request, response);}
}

注意

• 在doPost没有写request.setCharacterEncoding("UTF-8")代码的情况下，会发现GET请求参数乱码解决方案同时也可也把POST请求参数乱码的问题也解决了

• 只不过对于POST请求参数一般都会比较多，采用这种方式解决乱码起来比较麻烦，所以对于POST请求还是建议使用设置编码的方式进行。

另外需要说明一点的是Tomcat8.0之后，已将GET请求乱码问题解决，设置默认的解码方式为UTF-8

5、Request请求转发

1、请求转发(forward):一种在服务器内部的资源跳转方式。

​

(1)浏览器发送请求给服务器，服务器中对应的资源A接收到请求

(2)资源A处理完请求后将请求发给资源B

(3)资源B处理完后将结果响应给浏览器

(4)请求从资源A到资源B的过程就叫请求转发

2、请求转发的实现方式->req.getRequestDispatcher("资源B路径").forward(req,resp);

具体如何使用：

​

针对上述需求，实现步骤为:

1.创建一个RequestDemo1类，接收/reqDemo1的请求

2.创建一个RequestDemo2类，接收/reqDemo2的请求

3.在RequestDemo1的方法中使用

req.getRequestDispatcher("/reqDemo2").forward(req,resp)进行请求转发

4.启动测试

具体实现：

(1)创建RequestDemo1类

​

(2)创建RequestDemo2类

​

(3)在RequestDemo1的doGet方法中进行请求转发

​

(4)启动测试

​

可以看到请求已经转发成功了

3、请求转发资源间共享数据：使用request对象

此处主要解决的问题是把请求从/reqDemo1转发到/reqDemo2的时候，如何传递数据给/reqDemo2。

需要使用request对象提供的三个方法:

• 存储数据到request域[范围,数据是存储在request对象]中：

void setAttribute(String name,Object o);

• 根据key获取值

Object getAttribute(String name);

• 根据key删除该键值对

void removeAttribute(String name);

下面是实现样例：

1.在RequestDemo1的doGet方法中转发请求之前，将数据存入request域对象中

2.在RequestDemo2的doGet方法从request域对象中获取数据，并将数据打印到控制台

3.启动访问测试

(1)修改RequestDemo1中的方法

​

(2)修改RequestDemo2中的方法

​

(3)启动测试

​

可以看到执行成功了。

此时就可以实现在转发多个资源之间共享数据。

4、请求转发的特点

• 浏览器地址栏路径不发生变化
  虽然后台从/reqDemo1转发到/reqDemo2,但是浏览器的地址一直是/reqDemo1,未发生变化

• 只能转发到当前服务器的内部资源
  不能从一个服务器通过转发访问另一台服务器

• 只能执行一次请求，可以在转发资源间使用request共享数据