跳到主要内容 SpringMVC 详解:原理、HTTP 与参数处理 | 极客日志
Java java
SpringMVC 详解:原理、HTTP 与参数处理 详细讲解了 SpringMVC 的核心概念与实战开发。内容包括 MVC 设计思想、SpringMVC 工作流程、静态与动态请求的处理方式。深入剖析了 HTTP 协议基础,涵盖 URL 结构、请求方法(GET/POST)、请求与响应格式。重点演示了服务端接收参数的三种方式:HttpServletRequest、声明参数及 POJO 类封装,并提供了 Controller 注解使用示例及常见 404 问题排查方案。适合希望快速掌握 SpringMVC 开发规范的初学者阅读。
疯疯癫癫 发布于 2026/3/22 更新于 2026/4/18 5 浏览MVC 是一种软件架构的思想,将软件按照模型、视图、控制器来划分。
Model ,模型层,负责业务逻辑判断,数据库存取
View ,视图层,负责界面展示,向用户呈现数据的方式(html 页面、图片、文本等)
Controller ,控制器,负责接收用户请求,并根据请求调用相应的模型来处理业务逻辑
1.2 Spring MVC SpringMVC 是一种基于 MVC(模型 - 视图 - 控制器)模式的 Web 框架,它是基于 Spring 框架的一个子项目。
它通过将请求分派给相应的控制器来处理 Web 请求,然后将处理结果发送回客户端。
客户端发送请求至前端控制器 DispatcherServlet;
DispatcherServlet 收到请求后,调用处理器映射器 HandlerMapping;
HandlerMapping 根据请求 URL 找到具体的 Controller;
通过处理器适配器 HandlerAdapter 找到具体执行该方法的实现类;
Controller 处理请求,并返回 ModelAndView;
DispatcherServlet 通过 ViewResolver(视图解析器)确定负责显示数据的具体 View;
DispatcherServlet 对 View 进行渲染视图(即将 Model 填充至视图组件中),并将完整的视图响应到客户端。
2 SpringMVC 快速入门
创建工程 :新建工程 _051MVC-BOOT01
选择依赖 :选择 2.7.17 版本,并勾选 Spring Web 依赖项
<dependency >
<groupId > org.springframework.boot</groupId >
<artifactId > spring-boot-starter-web</artifactId >
</dependency >
创建首页文件 :在 resources/static 目录下创建 index.html
<h1 > 工程首页 </h1 >
启动工程 :运行主程序启动应用
刷新静态资源 :右键 static 目录,选择 Rebuild static
3 SpringMVC 处理请求
3.1 请求分类及处理方式
3.1.1 静态请求
定义 :指请求的页面由服务器上预先准备好的静态 web 资源组成,如 HTML、CSS、JS、IMG 等,返回给客户端的信息内容是不变的。
处理方式 :由服务器直接将请求的资源返回给客户端,服务器不处理任何逻辑,只是将预先准备好的资源返回给客户端。
3.1.2 动态请求
定义 :服务器会根据用户的请求动态生成内容,将数据返回到客户端显示页面内容。
处理方式 :由服务器从数据库中获取数据,并进行相应的逻辑处理后将处理结果返回客户端。
3.2 处理静态请求
3.2.1 处理 html 文件请求
3.2.2 处理图片等请求
3.3 处理动态请求 通过在 controller 中定义对应的类及方法实现动态请求的业务逻辑处理。
3.3.1 注解说明
@Controller:添加在类上;表示该类是一个控制器,负责处理用户的请求,并将处理结果生成响应返回给客户端。
@RequestMapping:请求注解;添加在控制器类或控制器方法上;将 HTTP 请求映射到控制器中的方法,指定处理请求的路径。
控制器类上:为整个控制器指定一个基础路径
控制器方法上:指定相对于基础路径的具体路径
@ResponseBody:响应注解;添加在控制器方法上;可以使控制器方法通过返回值的方式将响应返回给客户端。
3.3.2 示例
@Controller
public class OrderController {
@RequestMapping("/selectOrder")
@ResponseBody
public String selectOrder () {
return "查询订单成功~~" ;
}
}
3.4 常见问题
工程已修改,但是浏览器刷新未出现效果
工程 static 目录下文件修改后必须 Rebuild static
浏览器有之前页面的缓存,Shift + F5 刷新页面
404 错误码代表找不到资源
找不到静态资源
检查请求的路径是否正确
检查静态资源文件的存储位置是否在 static 里面
选中 static 文件夹 ReBuild 重新编译再测试
找不到动态资源
检查请求的路径是否正确
检查 @Controller 注解是否添加
检查 @RequestMapping 注解里面的处理路径是否正确
4 HTTP
4.1 HTTP 协议 HTTP 协议是浏览器与服务器通讯的应用层协议,规定了浏览器与服务器之间的交互规则以及交互数据的格式信息等。
用途 :网页获取,数据的传输
特点
应用层协议,使用 tcp 进行数据传输;
有丰富的请求类型;
可以传输的数据类型众多.
4.2 访问网页流程
客户端(浏览器)通过 tcp 传输,发送 http 请求给服务端;
服务端接收到 http 请求后进行解析;
服务端处理请求内容,组织响应内容;
服务端将响应内容以 http 响应格式发送给浏览器;
浏览器接收到响应内容,解析展示.
4.3 请求和响应
4.3.1 HTTP 请求 Request 浏览器给服务端发送的内容称为请求 Request,一个请求包含三部分:请求行,请求头,请求体
请求体 :请求参数或者提交内容。请求体通常是用户上传的信息,比如:在页面输入的注册信息,上传的附件等内容。
请求头 :对请求的进一步解释和描述。请求头是浏览器可以给服务端发送的一些附加信息,有的用来说明浏览器自身内容,有的用来告知服务端交互细节,有的告知服务端消息正文详情等。
Host: localhost:8080
Connection: keep-alive
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.130 Safari/537.36
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9
Accept-Encoding: gzip, deflate, br
Accept-Language: zh-CN,zh;q=0.9
请求类别 :每个请求类别表示向服务器端发请求做不同的操作
GET:获取服务器资源
POST:新增服务器资源
PUT:更新服务器资源
DELETE:删除服务器资源
抽象路径 :请求 URL 地址为:http://localhost:8080/
4.3.2 HTTP 响应 Response 服务端给浏览器发送的内容称为响应 Response,一个响应包含三部分:响应行,响应头,响应体。
响应头 :响应头与请求中的消息头格式一致,表示的是服务端发送给客户端的附加信息。
HTTP/1.1 200 OK
Content-Type: text/html
Content-Length: 3546
Content-Length:是用来告知浏览器响应正文的长度,单位是字节。
Content-Type:是用来告知浏览器响应正文中的内容是什么类型的数据 (图片,页面等等)。不同的类型对应的值是不同,浏览器接收正文前会根据上述两个响应头来得知长度和类型从而读取出来做对应的处理以渲染给用户看。
文件类型 Content-Type 对应的值 html text/html css text/css js application/javascript png image/png gif image/gif jpg image/jpeg
响应码 :
1xx:保留
2xx:成功,表示处理成功,并正常响应
3xx:重定向,表示处理成功,但是需要浏览器进一步请求
4xx:客户端错误,表示客户端请求错误导致服务端无法处理
5xx:服务端错误,表示服务端处理请求过程出现了错误
4.4 URL
4.4.1 定义 URL(Uniform Resource Locator)是互联网上统一资源定位符 的简称,用于标识和定位互联网上资源的地址。在 Web 浏览器中,URL 是用于访问网页的地址。
4.4.2 URL 组成
协议(Protocol) :指定访问资源的协议类型,常见的协议包括 HTTP、HTTPS 等。
主机名(Hostname) :指定要访问的服务器的主机名或域名。
端口号(Port) :指定服务器的端口号,不同的协议和应用程序使用不同的端口号。
路径(Path) :指定要访问的资源的路径,即文件或文件夹的路径。
查询参数(Query Parameters) :用于传递一些额外的信息给服务器,例如参数化的查询条件。查询参数和路径 Path 之间使用?分隔,多个查询参数之间使用 & 分隔。
4.4.3 注意事项
URL 地址是区分大小写的,因此在输入时要注意大小写的一致性。
URL 地址中不能包含非法字符,例如空格、特殊符号等。如果需要传递参数或附加信息,可以使用查询参数或 POST 请求等方式。
4.5 请求方法
4.5.1 GET 请求 GET 请求是 HTTP 协议中最常见的请求方式之一,它用于从服务器获取数据 。
GET 请求将查询参数附加在 URL 之后,通过'?'符号进行分隔。
注意事项
GET 请求的参数是可见的,因此在 URL 中传递敏感信息时需谨慎。
GET 请求的长度有限制,因为 URL 的长度有限制,因此当传递大量数据时,应考虑使用 POST 或其他方式。
发送 GET 请求 :在浏览器中输入 URL 地址确认即可向服务端发送 GET 请求。http://localhost:8080/v1/users/login?username=xxx&password=xxx
查询参数 GET 请求的参数通常以键值对的形式附加在 URL 之后。例如,以下 URL 中,'?name=John&age=25'是两个查询参数,分别表示名字和年龄
http://example.com/users?name =John&age=25
4.5.2 POST 请求 POST 请求是另一种常见的 HTTP 请求方式,它用于向服务器提交数据。与 GET 请求不同,POST 请求将数据放在请求体(Request Body)中,而不是 URL 中。
请求体 :POST 请求的请求体中包含要提交的数据。这些数据可以是 JSON、XML 或其他格式。请求体中的数据通过 Content-Type 头部指定。
使用 POST 请求的注意事项
POST 请求的数据是私密的,不会显示在 URL 中,因此更适合传递敏感信息。
POST 请求的长度没有限制,可以提交大量的数据。
发送 POST 请求 经常在 form 表单中发送。
<form action ="请求地址" method ="post" >
<input type ="text" name ="username" >
<input type ="text" name ="password" >
<input type ="submit" name ="登录" >
</form >
POST /users HTTP/1.1
Host: example.com
Content-Type: application/json
Request Body: {"username" : "john" , "password" : "secret" }
4.6 传递数据方式 客户端向服务端传递数据的方式分为 GET 请求和 POST 请求两种方式。
4.6.1 GET 请求 http://localhost:8080/v1/users/login?username=xxx&password=xxx
4.6.2 POST 请求 <form action ="请求地址" method ="post" >
<input type ="text" name ="username" >
<input type ="text" name ="password" >
<input type ="submit" name ="登录" >
</form >
5 服务端接收参数
5.1 HttpServletRequest 接收
HttpServletRequest 是 Java Servlet 规范中定义的一个接口,它提供了与 HTTP 请求相关的方法和属性。
在 Java Web 应用程序中,当客户端发送 HTTP 请求时,容器(例如 Tomcat)会创建一个 HttpServletRequest 对象,该对象包含了客户端请求的所有信息,如请求的 URL、请求方法、请求头、请求参数等。
在请求处理过程中,开发人员可以使用 HttpServletRequest 对象来获取客户端发送过来的请求参数。通过调用 HttpServletRequest 的方法,可以获取请求的参数名称、参数值以及参数的数量等信息。
以上述案例为准,客户端把用户名和密码信息传递给服务端,服务端接收传递过来的用户名和密码信息。
第 1 步:controller.UserController 处理请求
@RequestMapping("/v1/users/login")
@ResponseBody
public String login (HttpServletRequest request) {
String username = request.getParameter("username" );
String password = request.getParameter("password" );
return username + ":" + password;
}
5.2 声明参数接收 可以在处理请求的方法中通过 声明参数的方式 来接收客户端传递过来的数据。
第 1 步:controller.UserController 处理登录请求
@RequestMapping("/v1/users/login")
@ResponseBody
public String login (String username, String password) {
return "username = " + username + ", password = " + password;
}
5.3 声明 POJO 类接收 如果客户端传递数据过多,通过 HttpServletRequest 方式接收复用性较差,通过 声明参数接收 又很繁琐;所以可以将数据封装到 POJO 类 中来接收。
第 1 步:controller.UserController 处理登录请求
@RequestMapping("/v1/users/login")
@ResponseBody
public String login (User user) {
return user.toString();
}
第 2 步:自定义 pojo 类,工程目录下创建 entity.User
public class User {
private String username;
private String password;
}
6 HttpClient 测试
6.1 HttpClient 说明 使用 SpringMVC 中提供的 .http 后缀的文件来测试 Controller 层接口。
使用三个 # 号 作为不同测试方法的分隔符,也可以作为注释说明。
第 1 步:在 test 目录下创建 Directory:http
第 2 步:创建 .http 后缀的文件进行测试:testUserController.http
### GET 请求测试
GET http://localhost:8080/v1/users/login?username=liying&password=123456
Accept: application/json
### POST 请求测试
POST http://localhost:8080/v1/users/login
Content-Type: application/x-www-form-urlencoded
username=liying&password=123456
7 POJO
7.1 定义 Plain Ordinary Java Object:简单的 Java 对象;
是没有继承任何类或实现任何接口的简单 Java 对象,也不依赖于其他复杂的框架或技术;
POJO 对象通常包含了纯粹的数据和简单的业务逻辑,是一种用于简化 Java 应用程序开发的编程模型;
是 entity 实体类、VO(Value Object 或 View Object)视图对象、DTO(Data Transfer Object)数据传输对象 这 3 个对象的总称。
7.2 entity 实体类|DTO|VO
entity 实体类 :作用用来和数据库中的表字段一一对应的,比如 UserEntity(id,username,password,nickname);
DTO :作用用来接收客户端传递给服务器的数据的,比如:UserLoginDTO(username,password) 实现登录功能,客户端向服务器端传递数据;
VO :作用用来处理服务器响应给客户端的数据的,比如:UserListVO(id,username,nickname) 登录成功后的列表页显示当前用户信息。
微信扫一扫,关注极客日志 微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
相关免费在线工具 Keycode 信息 查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
Escape 与 Native 编解码 JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
JavaScript / HTML 格式化 使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
JavaScript 压缩与混淆 Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online
Base64 字符串编码/解码 将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
Base64 文件转换器 将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online