Spring MVC 全称 Spring Web MVC，又称为 Spring Web
“MVC” 代表模型-视图-控制器（Model-View-Controller）。这是一种设计模式，用于构建具有良好组织结构的应用程序，以便更好地管理代码和提高可维护性。
学习 Spring MVC 最关注以下 3 个功能：
在创建 Spring Boot 项目的时候，我们已经引入了 Spring Web 依赖，引入这个依赖，我们的项目就是一个 Spring MVC 项目。
例：通过访问 http://127.0.0.1:8080/web/hi 来返回 Hello
package com.example.spring_mvc_demo.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
@Controller // 类注解，在 Spring 启动的时候加载并注册
@ResponseBody // 当前类返回的非静态页面
@RequestMapping("/web") // 当使用 /web 可以访问到当前类
public class WebController {
@RequestMapping("/hi") // 当使用 /web/hi 可以访问到当前方法
public Object hi() {
return "Hello";
}
}
@ResponseBody
用于标识控制器方法的返回值应该直接作为 HTTP 响应的主体部分，而不是视图解析器渲染成视图。
@RequestMapping
可以应用在类级别和方法级别，用于定义 URL 映射规则，将 HTTP 请求映射到相应的控制器方法上。
结果：
注意：
@ResponseBody
，那么返回的就是一个视图，也就是 html 文件的路径
@Controller
不可替换为其他类注解（如
@Service
、
@Component
）
@RestController
，相当于
@Controller
+
@ResponseBody
更简单的写法：
package com.example.spring_mvc_demo.controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class WebController {
@RequestMapping("/hi") // 当使用 /hi 可以访问到当前方法
public Object hi() {
return "Hello";
}
}
访问 http://127.0.0.1:8080/hi 就可以看到 Hello 了。
@RequestMapping
默认支持所有请求方法，可以通过指定
method
属性使其只匹配某一种请求方法：
@RequestMapping(value = "/greet", method = RequestMethod.GET)
public String greet() {
return "greet";
}
在较新的 Spring 版本中，
@RequestMapping
已经被更具体的注解取代，例如
@GetMapping
、
@PostMapping
、
@PutMapping
和
@DeleteMapping
，它们分别用于处理
GET
、
POST
、
PUT
和
DELETE
请求。这些注解提供了更清晰和简洁的方式来定义映射规则
如：
@RequestMapping(value = "/greet", method = RequestMethod.GET)
// 等效于
@GetMapping("/greet")
Spring MVC 兼容 Servlet 的用法
@RestController
public class WebController {
@GetMapping("/hi") // 当使用 /hi 可以访问到当前方法
public Object hi(HttpServletRequest request, HttpServletResponse response) {
return "Hello" + request.getParameter("name");
}
}
在 Spring MVC 中默认内置隐藏了两个参数，HttpServletRequest 和 HttpServletResponse，想要用只要声明这两个参数即可
直接声明要获取的参数，参数名和查询字符串的参数名一致
@GetMapping("/get1")
public String getParam1(String name) {
return "value: " + name;
}
结果：
参数的类型也可以写成其他的，比如 int 或 Integer，类型会自动转换
@GetMapping("/get1")
public String getParam1(Integer age) {
return "value: " + age;
}
如果查询字符串中没有指定 age 参数，那么这里会显示 null，如果 int 类型，则会报错，因为 int 无法接收 null
先定义一个类：
package com.example.spring_mvc_demo.model;
import lombok.Data;
@Data
public class Student {
private Integer id;
private String name;
private Integer age;
private String sex;
}
然后就可以获取这个类的对象，对象的属性会自动从查询字符串中获取
@GetMapping("/get2")
public String getParam2(Student student) {
return student.toString();
}
上面的方式，传输的数据都是
application/x-www-form-urlencoded
格式，也就是查询字符串的格式。
Json 字符串是另外一种格式，要获取其解析后的对象，只要在参数的声明前加
@RequestBody
注解
@PostMapping("/login3")
public HashMap<String, Object> login3(@RequestBody Student student) {
HashMap<String, Object> result = new HashMap<>();
result.put("id", student.getId());
result.put("name", student.getName());
result.put("age", student.getAge());
return result;
}
我们使用
HashMap
作为返回类型，Spring 会自动将其转换为 JSON 格式作为 HTTP 响应返回给客户端
使用 Postman 构造请求并验证：
使用
MultipartFile
类来描述一个文件，前面加上 @RequestPart 注解
@RequestPart
注解，用于处理HTTP请求中的"multipart/form-data"类型的数据来支持文件上传
该注解可以传入参数，比如，
@RequestPart("myfile")
注解表示将请求中名为"file"的部分映射到
MultipartFile file
参数上
@PostMapping("/reg")
public String reg(@RequestPart("myfile") MultipartFile file) throws IOException {
file.transferTo(new File("d:/img.png"));
return "success";
}
使用
MultipartFile
中的方法
transferTo
，将文件保存到硬盘。
获取 Cookie
@CookieValue
注解，用于从 HTTP 请求中提取特定 Cookie 的值，并将其映射到控制器方法的参数上。
注解中传入参数，比如
@CookieValue("cookie")
表示提取名为"cookie"的 Cookie 的值
@GetMapping("/getck")
public String getCookie(@CookieValue("cookie") String cookie) {
return "cookie: " + cookie;
}
在浏览器中手动添加 cookie，可以看到服务端成功获取并返回了：
获取 Header
@RequestHeader
注解 用于从 HTTP 请求头中提取特定的信息，并将其映射到控制器方法的参数上。
传入参数指定要提取的请求头的名称。
@GetMapping("/gethead")
public String getHead(@RequestHeader("User-Agent") String userAgent) {
return "User-Agent: " + userAgent;
}
session 存储和获取
@GetMapping("/setSession")
public String setSession(HttpServletRequest request) {
// 获取 HttpSession 对象
HttpSession session = request.getSession();
// 存储数据到会话中
session.setAttribute("username", "john_doe");
return "redirect:/getSession";
}
@GetMapping("/getSession")
public String getSession(HttpSession session, Model model) {
// 从会话中获取数据
String username = (String) session.getAttribute("username");
return "sessionResult: " + username;
}
和原始的 Servlet 没有区别，这里不做赘述。
@RequestParam
用于指定要提取的参数名称，这样，参数名和前端的查询字符串的名称就可以不一样了。
@GetMapping("/gettime")
public String getTime(@RequestParam("t") String time) {
return "time: " + time;
}
在Spring MVC中，你可以通过在方法参数上使用
@RequestParam
注解，并设置
required
属性为
false
来表示一个参数是非必传的。默认情况下，
@RequestParam
的
required
属性是
true
，即参数是必传的。
@Controller
public class MyController {
@GetMapping("/example")
public String exampleMethod(
@RequestParam(name = "optionalParam", required = false) String optionalParam) {
// 处理参数
if (optionalParam != null) {
// 参数存在时的处理逻辑
System.out.println("Optional Parameter: " + optionalParam);
} else {
// 参数不存在时的处理逻辑
System.out.println("Optional Parameter is not provided");
}
// 其他业务逻辑
return "exampleView";
}
}
如果请求中包含了该参数，则参数值会被传递到方法中；如果请求中没有包含该参数，方法中的
optionalParam
将为
null
。
如下代码 其中
{name}
和
{password}
是占位符，表示路径中的变量
@PathVariable
注解：用于将 URI 模板变量映射到方法的参数上。
@RequestMapping("/login4/{name}/{password}")
public String login4(@PathVariable String name, @PathVariable String password) {
return "name: " + name + ", password: " + password;
}
区别
在Spring MVC中，“forward:” 和 “redirect:” 是用于控制器方法返回视图的两个关键字。
例：
@Controller
public class TestController {
// 请求转发
@RequestMapping("/hello1")
public Object hello1() {
return "forward:/login.html";
}
// 请求重定向
@RequestMapping("/hello2")
public Object hello2() {
return "redirect:https://www.baidu.com";
}
}