1.什么是 Spring MVC
Spring Web MVC 是基于Servlet API 构建的原始 Web 框架,从一开始就包含在Spring 框架中。它的正式名称 “Spring Web MVC” 来自其源模块的名称(Spring-webmvc),但它通常被称为“Spring MVC”。
从上述定义我们可以得出两个关键信息:
-
Spring MVC 是⼀个 Web 框架。
-
Spring MVC 是基于 Servlet API 构建的。
1.什么是 MVC
MVC 是 Model View Controller 的缩写,它是软件工程中的一种软件架构模式,它把软件系统分为模型、视图和控制器三个基本部分。
执行流程:
- 用户的请求首先先到 Controller
- Controller 将请求转发给 Model
- Model 处理业并将数据及结果给 Controller
- Controller 会将数据给 View 引擎
- View 转换数据生成最终的页面给用户
- Model(模型)是应用程序中用处理应用程序数据逻辑的部分。通常模型对象负责在数据库中存取数据。
- View(视图)是应用程序中处理数据显示的部分。通常视图是依据模型数据创建的。
- Controller(控制器)是应⽤程序中处理用户交互的部分。通常控制器负责从视图读取数据,控制用户输入,并向模型发送数据。
2.MVC 和 Spring MVC 的关系
MVC 是一种思想,而 Spring MVC 是对 MVC 思想的具体实现。
总结来说,Spring MVC 是⼀个实现了 MVC 模式,并继承了 Servlet API 的 Web 框架。既然是 Web框架,那么当用户在浏览器中输入了 url 之后,我们的 Spring MVC 项⽬就可以感知到用户的请求。
2.Spring MVC 创建和连接
学习 Spring MVC 我们只需要掌握以下 3 个功能:
- 连接的功能:将用户(浏览器)和 Java 程序连接起来,也就是访问一个地址能够调用到我们的Spring 程序。
- 获取参数的功能:用户访问的时候会带一些参数,在程序中要想办法获取到参数。
- 输出数据的功能:执行了业务逻辑之后,要把程序执行的结果返回给用户。
对于 Spring MVC 来说,掌握了以上 3 个功能就相当于掌握了 Spring MVC。
Spring MVC 项目创建和 Spring Boot 创建项目相同(Spring MVC 使用 Spring Boot 的方式创建),在创建的时候选择 Spring Web 就相当于创建了 Spring MVC 的项目。
在 Spring MVC 中使用 @RequestMapping 来实现 URL 路由映射,也就是浏览器连接程序的作用。
接下来要实现的功能是访问地址:http://localhost:8080/user/hi,能打印“hello,spring mvc”信息。
1.实现客户端和程序之间的连接
1.@RequestMapping
package com.example.project.controller;import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;/*** @projectName: Project* @package: com.example.project.controller* @className: TestController* @author: 王嘉辉* @description:* @date: 2023/12/23 18:15* @version: 1.0*/
@RestController
@RequestMapping("/test")
public class TestController {@RequestMapping("/sayhi")public String sayHi() {return "Hello Spring MVC";}
}
@RequestMapping 还可以指定 GET/POST 方法类型
2.@GetMapping
实现 HTTP 链接,但只支持 GET 类型的请求
package com.example.project.controller;import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;/*** @projectName: Project* @package: com.example.project.controller* @className: TestController* @author: 王嘉辉* @description:* @date: 2023/12/23 18:15* @version: 1.0*/
@RestController
@RequestMapping("/test")
public class TestController {@RequestMapping(path = "/sayhi",method = RequestMethod.GET)public String sayHi() {return "Hello Spring MVC !!!";}@GetMapping("/sayhi2")public String sayHi2() {return "Hello Spring MVC2 !!!";}
}
get 请求的 3 种写法:
// 写法1
@RequestMapping("/index")
// 写法2
@RequestMapping(value = "/index",method = RequestMethod.GET)
// 写法3
@GetMapping("/index")
3.@PostMapping
实现 HTTP 链接,但只支持 POST 类型的请求
package com.example.project.controller;import org.springframework.web.bind.annotation.*;/*** @projectName: Project* @package: com.example.project.controller* @className: TestController* @author: 王嘉辉* @description:* @date: 2023/12/23 18:15* @version: 1.0*/
@RestController
@RequestMapping("/test")
public class TestController {@RequestMapping(path = "/sayhi",method = RequestMethod.GET)public String sayHi() {return "Hello Spring MVC !!!";}@GetMapping("/sayhi2")public String sayHi2() {return "Hello Spring MVC2 !!!";}@PostMapping("/sayhi3")public String sayHi3() {return "Hello Spring MVC3 !!!";}
}
post 请求的 3 种写法:
// 写法1
@RequestMapping("/index")
// 写法2
@RequestMapping(value = "/index",method = RequestMethod.POST)
// 写法3
@PostMapping("/index")
2.获取参数
1.传递单个参数
package com.example.project.controller;import jakarta.servlet.http.HttpServletRequest;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;/*** @projectName: Project* @package: com.example.project.controller* @className: TestController2* @author: 王嘉辉* @description:* @date: 2023/12/23 18:44* @version: 1.0*/
@RestController
@RequestMapping("/test2")
public class TestController2 {@RequestMapping("/getname")public String getName(HttpServletRequest request) {return "Name: " + request.getParameter("name");}
}
package com.example.project.controller;import jakarta.servlet.http.HttpServletRequest;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;/*** @projectName: Project* @package: com.example.project.controller* @className: TestController2* @author: 王嘉辉* @description:* @date: 2023/12/23 18:44* @version: 1.0*/
@RestController
@RequestMapping("/test2")
public class TestController2 {@RequestMapping("/getname")public String getName(HttpServletRequest request) {return "Name: " + request.getParameter("name");}@RequestMapping("/getname2")public String getName2(String name) {return "Name: " + name;}
}
2.传递多个参数
package com.example.project.controller;import jakarta.servlet.http.HttpServletRequest;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;/*** @projectName: Project* @package: com.example.project.controller* @className: TestController2* @author: 王嘉辉* @description:* @date: 2023/12/23 18:44* @version: 1.0*/
@RestController
@RequestMapping("/test2")
public class TestController2 {@RequestMapping("/getname")public String getName(HttpServletRequest request) {return "Name: " + request.getParameter("name");}@RequestMapping("/getname2")public String getName2(String name) {return "Name: " + name;}@RequestMapping("/getname3")public String getName3(String name,Integer age) {return "Name: " + name + " age: " + age;}
}
3.传递对象
package com.example.project.controller;import com.example.project.model.User;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;/*** @projectName: Project* @package: com.example.project.controller* @className: UserController* @author: 王嘉辉* @description:* @date: 2023/12/23 18:59* @version: 1.0*/
@RestController
@RequestMapping("/user")
public class UserController {@RequestMapping("/add")public User add(User user) {return user;}
}
package com.example.project.model;import lombok.Data;/*** @projectName: Project* @package: com.example.project.model* @className: User* @author: 王嘉辉* @description:* @date: 2023/12/23 18:58* @version: 1.0*/
@Data
public class User {private int id;private String name;private String password;private int age;
}
4.后端参数重命名
如果我们的实际业务前端的参数是⼀个非必传的参数,我们可以通过设置 @RequestParam 中的 required=false 来避免不传递时报错
5.获取前端的 JSON 对象
6.获取URL中参数
@RequestMapping("/detail/{aid}")public Integer detail(@PathVariable("aid") Integer aid) {return aid;}
7.上传文件
@RequestMapping("/upload")public String upload(@RequestPart("myfile")MultipartFile file) throws IOException {String path = "E:\\study\\Gitee\\test_c\\test-2023-12-23\\Project\\file\\img.jpg";//保存文件file.transferTo(new File(path));return path;}
@RequestMapping("/upload")public String upload(@RequestPart("myfile")MultipartFile file) throws IOException {//1.生成一个唯一的id | UUID = 全球唯一ID -> MAC + 随机种子 + 加密算法String name = UUID.randomUUID().toString().replace("-","");//2.得到源文件后缀名name += file.getOriginalFilename().substring(file.getOriginalFilename().lastIndexOf("."));String path = "E:\\study\\Gitee\\test_c\\test-2023-12-23\\Project\\file\\" + name;//保存文件file.transferTo(new File(path));return path;}
保证不被覆盖
8.获取Cookie/Session/header
获取 Request 和 Response 对象
@RequestMapping("/param10")
public String param10(HttpServletResponse response, HttpServletRequest requ
est) {String name = request.getParameter("name");// 获取所有 cookie 信息Cookie[] cookies = request.getCookies();return name + " 你好.";
}
传统获取 header/cookie
@RequestMapping("/param10")
@ResponseBody
public String param10(HttpServletResponse response, HttpServletRequest requ
est) {String name = request.getParameter("name");// 获取所有 cookie 信息Cookie[] cookies = request.getCookies();String userAgent = request.getHeader("User-Agent");return name + ":"+userAgent;
}
简洁的获取 Cookie—@CookieValue
@RequestMapping("/cookie")public String cookie(@CookieValue(value = "java",required = false) String ck) {return "cookie:" + ck;}
简洁获取 Header—@RequestHeader
@RequestMapping("/header")
@ResponseBody
public String header(@RequestHeader("User-Agent") String userAgent) {return "userAgent:" + userAgent;
}
session 存储和获取
package com.example.project.controller;import com.example.project.model.User;
import jakarta.annotation.PostConstruct;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpSession;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;import java.io.File;
import java.io.IOException;
import java.util.UUID;/*** @projectName: Project* @package: com.example.project.controller* @className: UserController* @author: 王嘉辉* @description:* @date: 2023/12/23 18:59* @version: 1.0*/
@RestController
@RequestMapping("/user")
public class UserController {private static String _SESSION_KEY = "SESSION_KEY";@RequestMapping("/add")public User add(User user) {return user;}@RequestMapping("/name")public String name(@RequestParam(value = "n",required = false)String name) {return name;}@RequestMapping("/add_json")public User addByJson(@RequestBody User user) {return user;}@RequestMapping("/detail/{aid}")public Integer detail(@PathVariable("aid") Integer aid) {return aid;}@RequestMapping("/upload")public String upload(@RequestPart("myfile")MultipartFile file) throws IOException {//1.生成一个唯一的id | UUID = 全球唯一ID -> MAC + 随机种子 + 加密算法String name = UUID.randomUUID().toString().replace("-","");//2.得到源文件后缀名name += file.getOriginalFilename().substring(file.getOriginalFilename().lastIndexOf("."));String path = "E:\\study\\Gitee\\test_c\\test-2023-12-23\\Project\\file\\" + name;//保存文件file.transferTo(new File(path));return path;}@RequestMapping("/cookie")public String Cookie(@CookieValue(value = "java",required = false) String ck) {return "cookie:" + ck;}@RequestMapping("/set_sess")public String setSess(HttpServletRequest request) {HttpSession session = request.getSession();if(session != null) {session.setAttribute(_SESSION_KEY,"张三");return "session set success";}else {return "session set fail";}}@RequestMapping("/get_sess")public String getSess(@SessionAttribute(required = false,value = "SESSION_KEY") String name) {return name;}
}
3.返回参数
通过上面的学习我们知道,默认请求下无论是 Spring MVC 或者是 Spring Boot 返回的是视图(xxx.html),而现在都是前后端分离的,后端只需要返给给前端数据即可,这个时候我们就需要使用@ResponseBody 注解了。
package com.example.project.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;/*** @projectName: Project* @package: com.example.project.controller* @className: TestController3* @author: 王嘉辉* @description:* @date: 2023/12/23 22:04* @version: 1.0*/
@Controllerpublic class TestController3 {@RequestMapping("/index")public String index() {return "hello.html";}
}
<!doctype html>
<html lang="en">
<head><meta charset="UTF-8"><meta name="viewport"content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0"><meta http-equiv="X-UA-Compatible" content="ie=edge"><title>Document</title>
</head>
<body><h1>hello,i am hello</h1>
</body>
</html>
package com.example.project.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;/*** @projectName: Project* @package: com.example.project.controller* @className: TestController3* @author: 王嘉辉* @description:* @date: 2023/12/23 22:04* @version: 1.0*/
@Controller
@ResponseBody
public class TestController3 {@RequestMapping("/index")public String index() {return "hello.html";}
}
4.请求转发或请求重定向
return 不但可以返回一个视图,还可以实现跳转,跳转的方式有两种:
forward: 是请求转发;
redirect:请求重定向。
// 请求重定向
@RequestMapping("/index")
public String index(){return "redirect:/index.html";
}
// 请求转发
@RequestMapping("/index2")
public String index2(){return "forward:/index.html";
}
forward(请求转发)和 redirect(请求重定向)的区别,举例来说,例如,你告诉你妈妈,你想吃辣条,如果你妈妈,说好,我帮你去买,这就是 forward 请求转发;如果你妈妈让你自己去买,那么就是请求 redirect 重定向。
forward 和 redirect 具体区别如下:
- 请求重定向(redirect)将请求重新定位到资源;请求转发(forward)服务器端转发。
- 请求重定向地址发生变化,请求转发地址不发生变化。
- 请求重定向与直接访问新地址效果⼀直,不存在原来的外部资源不能访问;请求转发服务器端转发有可能造成原外部资源不能访问。