1. SpringMVC概述
1.1. 什么是SpringMVC?
Spring Web MVC (Model View Controller)是基于 Servlet API 构建的原始 Web 框架,从一开始就包含在 Spring Framework 中。正式名称“Spring Web MVC”来自其源模块的名称(spring-webmvc),但它通常被称为“Spring MVC”。
1.1.1. MVC与SpringMVC
MVC 是 Model View Controller 的缩写,它是软件工程中的一种软件架构模式,它把软件系统分为模型、视图和控制器三个基本部分。
Model(模型)是应用程序中用于处理应用程序数据逻辑的部分,通常模型对象负责在数据库中存取数据。
View(视图)是应用程序中处理数据显示的部分,通常视图是依据模型数据创建的,是前端(客户端)的可视的页面。
Controller(控制器)是应用程序中处理用户交互的部分,通常控制器负责从视图读取数据,控制用户输入,并向模型发送数据。
🎯MVC 执行流程:
- 用户(客户端)向发送的请求首先到服务器端的 Controller。
- Controller 将请求继续转发给 Model。
- Model 处理业务并将数据结果返回给 Controller。
- Controller 会将数据交给 View 引擎。
- View 会将数据进行转换渲染生成最终的页面给用户(客户端)。
🎯MVC与Spring MVC之间的区别?
MVC 是一种思想,而 Spring MVC 是对 MVC 思想的具体实现。
Spring MVC 是⼀个实现了 MVC 模式,并继承了 Servlet API 的 Web 框架,当⽤户在浏览器中输⼊了 URL 之后,我们的 Spring MVC 项目就可以感知到用户的请求。
1.2. SpringMVC项目的优势
现在绝大部分的 Java 项目都是基于 Spring(或 Spring Boot)的,而 Spring 的核心就是 Spring MVC;也就是说 Spring MVC 是 Spring 框架的核心模块,而 Spring Boot 是 Spring 的脚手架,因此我们可以推断出,现在市面上绝大部分的 Java 项目基本上都是 Spring MVC 项目,这也是我们要学 Spring MVC 的原因。
学习SpringMVC项目,主要学习的是三个功能:
- 连接:将用户(浏览器)和 Java 程序连接起来,也就是访问⼀个地址(URL)能够调用到我们的
Spring 程序。 - 获取参数:用户访问的时候会携带⼀些参数数据,在程序中要能够获取到这些参数。
- 输出数据:执行了业务逻辑之后,要把程序执行的结果返回给用户。
2. SpringMVC项目的创建与使用
2.1. 创建SpringMVC项目
首先,我们需要新建 SpringBoot 项目。
要注意,在添加依赖的时候,一定要添加 Web 模块,它其实就是 SpringMVC 的依赖。
2.2. 设置路由
设置路由可以实现程序与用户之间的映射(路由映射),也就是当用户访问某一个 URL 时,会将用户的请求对应到程序中的某个类的某个方法中,实现浏览器连接程序的作用,设置路由可以使用@RequestMapping
注解实现,注意要实现路由访问,必须使用 @Controller 将对象储存到 Spring 中。
package com.example.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("/user") // 一级路由
@Slf4j // 日志框架
public class UserController {
@RequestMapping("/hi") // 二级路由
public String sayHi() {
return "<h1>Hi, Spring MVC.</h1>";
}
}
其中,访问方法所返回数据或页面的 URL 为http://IP:端口号/类上的路由地址/方法上加的路由地址
,这样就能访问到每个方法所返回的页面或者数据了,也可以只在方法上设置路由地址;且当类中只有一个方法时,类上/方法上也可以不设置路由地址(挑一个设置即可),此时直接使用一级路由就能直接访问了。
由于历史原因,方法返回默认是一个静态页面,如果要设置返回一个页面数据,需要搭配使用 @ResponseBody
注解,放在类上,类里面所有的方法都会默认放回的是页面数据,而不是一个静态页面,放到方法上生效的只是当前方法。
启动程序,我们去浏览器通过访问http://127.0.0.1:8080/user/hi
地址,观察结果。
@RequestMapping
默认情况下,同时支持 GET 和 POST 等其他请求方式;而如果我们想要仅支持一种请求方式,需要做一些配置。
我们需要设置 @RequestMapping 的method
属性为RequestMethod.xxx
,RequestMethod 其实是一个枚举,里面储存了多种的请求方式。
我们这里设置一个 POST 请求。
@Controller
@ResponseBody
@Slf4j
@RequestMapping("/user")
public class UserController {
@RequestMapping(method = RequestMethod.POST, value = "/onlypost")
public String func1() {
return "post";
}
}
我们使用 postman 构造 GET 与 POST 请求看看能不能进行处理。
首先我们来试一试GET请求,
通过抓包,可以看到返回给用户的结果是405
,出错了,这就表示该方法是不支持 GET 请求的,我们再来试一试POST请求。
构造 POST 请求:
返回结果:
返回了一个post
数据,与我们预期相同,所以像上面那样进行配置,可以使一个方法只支持 GET 或 POST 一种请求格式。
当然还有另外的方法,如果只支持 POST 请求,我们还可以使用@PostMapping
注解来实现。
@PostMapping("/hello")
public String func2() {
return "hello";
}
同理,如果需要只支持 GET 请求我们也可以使用@GetMapping
注解来进行实现。
2.3. 获取参数
在 MVC 项目中,因为 SpringMVC 是基于 Servlet 的,所以使用 Servlet 那一套操作也是可以的,只不过有点繁琐,Spring 中就有了更方便获取参数的方式。
2.3.1. 获取一个参数
假设有一个类User
,客户端会传一个用户id
到后端,我们需要返回一个User
对象。
package com.example.demo.model;
import lombok.Data;
@Data
public class User {
private int id;
private String name;
private String password;
}
根据 id 查询 User 对象,这里主要是示范 Spring Web API 的使用,就不添加数据库查询了,这里直接构造相应 id 的对象,返回即可,重点是模拟数据的传入与传出。
我们直接在方法中加上一个形参(要与前端传入的参数名相同),访问路径时就会后会自动根据形参的名字以前端传来参数的 key 进行匹配,如果能够对应,后端就能成功接收参数。
@RequestMapping("/getuserbyid")
public User getUserById(Integer id) {
User user = new User();
user.setId(id);
user.setName("张三");
user.setPassword("zs12345678");
return user;
}
我们再通过 postman 来构造一个 id 参数,并获取到一个 User 对象。
Spring 会根据响应的返回值,决定返回数据的类型,比如你返回一个对象或 Map,就会返回一个 json 格式的数据,你返回一个页面,那它返回的就是页面类型的数据。
因为 SpringMVC 是基于 Servlet 的,所以 Servlet 中的那一套 API 在这里也适用,在MVC中,方法中的HttpServletRequest 与 HttpServletResponse 参数默认是隐藏的,如果想要使用,需要显示地进行声明,获取请求参数时需要通过 HttpServeletRequest 对象手动获取,我们只声明一个即可,相较来看写法上就比较繁琐了。
@RequestMapping("/getUserById2")
public User getUserById2(HttpServletRequest request) {
User user = new User();
user.setId(Integer.parseInt(request.getParameter("id")));
user.setName("李四");
user.setPassword("ls12345678");
return user;
}
还需要知道默认情况下,前端多传或者少传参数都是可以的,少传参数的情况下,结果就是 null,而多传参数并不会被 SpringMVC 读取。
2.3.2. 获取多个参数
我们还可以获取多个参数,此时可以给方法设置多个参数,也可以设置一个对象参数直接获取多个前端传来的参数。
比如,一个登录的逻辑,需要用户传来账户名与密码,这里就不实现一个登录逻辑了,我们直接将获取到的账户名与密码作为响应返回出去。
@RequestMapping("/login")
public String login(String name, String password) {
return "用户名:" + name + "密码:" + password;
}
我们从前端传入同名的键值对,后端就能够自动获取到。
当然,我们也可以使用对象来进行接收前端的参数,后端会根据 key 与对象中的属性名自动地进行匹配。
@RequestMapping("/object")
public String getObject(User user) {
return user.toString();
}
User 中的属性有 id,name 和 password,我们直接从前端传递三个对应名称的键值对,SpringMVC 会自动进行对象的初始化(参数映射)。
除此之外,我们还可以接收form
表单的形式的参数,可以使用是 GET/POST 请求方式。
2.3.3. 获取日期参数
使用@DateTimeFormat
注解完成日期参数格式转换,该注解有个pattern
的属性,值为我们所传递的日期参数的格式即可。
@RequestMapping("/dateParam")
public String dateParam(@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") LocalDateTime updateTime) {
return updateTime.toString();
}
2.3.4. 参数重命名@RequestParam
如果后端方法形参名和与客户端请求参数名不匹配时,就会出现参数接收不到的情况,这种情况,我们可以使用@RequestParam
来重命名后端的参数值(后端参数映射)。
其中@RequestParam
里面的参数为前端传来的参数名字,它可以自动匹配到注解所在的形参中。
@RequestMapping("/rename")
public String getNameAndPass(@RequestParam("name") String username,
@RequestParam("pass") String password) {
return "用户名:" + username + "密码:" + password;
}
还需要注意,使用 @RequestParam 注解修饰的参数,默认情况下,参数是必传,如果不传或少传就会报 400 请求错误。
这个情况是因为 @RequestParam 注解里面还有一个属性required
,默认情况下值为true
,这个属性的意思是是否是必须参数,所以参数重命名后,重命名的参数默认情况下不能缺少,如果不想将参数设置成必须,但是想重命名,那么就需要额外设置required
属性值为false
。
@RequestMapping("/rename")
public String getNameAndPass(@RequestParam(name = "name", required = false) String username,
@RequestParam(name = "pass", required = false) String password) {
return "用户名:" + username + " 密码:" + password;
}
2.3.5. 获取json字符串
如果我们想要获取 json 格式的参数,需要使用@RequestBody
注解修饰参数(声明了这个参数接收 json 数据)。
@RequestMapping("/object2")
public String getObject2(@RequestBody User user) {
return user.toString();
}
像上面这样,我们能够获取到 json 格式的参数了。
但这样设置后,就不能接收其他格式的数据了。
2.3.6. 获取URL中的参数
这里所说的从 URL 获取参数,并不是获取查询字符串部分的参数,而是直接拿 URL 地址中的参数,简单来说,就是从 URL 中?
前面的字段中获取参数;这种方式的优点是搜索引擎抓取关键字权重更高,有利于提高曝光度,且让 URL 更简洁。
获取方法:使用特定 URL 格式和在参数前加上注解@PathVariable
@RequestMapping("/hero/{id}/{name}")
public String geuURL(@PathVariable Integer id, @PathVariable String name) {
return "id:" + id + " name:" + name;
}
我们访问http://127.0.0.1:8080/user/hero/1234/梧桐
网页就能够获取到如下内容:
其中hero
表示二级目录地址,后面使用{}
的就表示参数。
2.3.7. 上传文件
文件的上传,我们需要使用到@RequestPart
注解和MultipartFile
,我们写方法形参定义的时候,需要一个MultipartFile
变量来接收前端传递的文件参数,并设置@RequestPart
的属性来表示接收前端参数的名字。
//上传文件
@RequestMapping("/upimg")
public boolean updateImg(@RequestPart("img") MultipartFile file) {
boolean result = false;
try {
//将图片保存
file.transferTo(new File("D:\\image\\yan.jpg"));
result = true;
} catch (IOException e) {
log.error("图片上传失败!" + e.getMessage());
}
return result;
}
我们使用 postman 构造一个请求,给服务器端发送一个图片,我们来看看目标目录下是否得到了我们上传的文件。
目标目录:
在上面的代码中是将保存文件的路径写死的了,但是,在实际开发到上线的过程当中,是涉及到至少三个环境的(开发,测试,生产),所以,保存的文件路径并不会写死,而是将保存文件的路径放在配置文件当中,然后读取配置环境中的保存图片路径。
还要注意, 一次上传文件大小默认是1MB
,一次请求上传文件大小默认是10MB
,可以在配置文件中进行修改。
# 设置一次上传文件大小(默认是1MB)
spring.servlet.multipart.max-file-size=100MB
# 设置一次请求上传文件大小(默认是10MB)
spring.servlet.multipart.max-request-size=100MB
这里我们来实现一个小案例,就是实现一下上传头像的功能,那这个功能的实现有如下过程:
- 配置保存的路径,并获取
- 设置不会重名的图片名称(UUID)
- 获取图片格式,得到文件的格式
- 将随机 UUID 与图片格式拼接得到完整的图片文件名
- 储存图片
对于不重名文件名的设定,我们可以使用 UUID,UUID 可以自动生成一个唯一的标识序列,简单理解就是 UUID 可以生成一个全球唯一 id,它由MAC + 随机种子 + 加密算法
得出。
# 设置文件保存路径
img.path=D:\\image\\
//获取配置文件的保存路径
@Value("${img.path}")
private String path;
@RequestMapping("/upload")
public String upLoad(@RequestPart("img") MultipartFile file) throws IOException {
// 1.生成一个唯一的 id
String name = UUID.randomUUID().toString().replace("-", "");
// 2. 得到源文件的后缀名, 和 id 组合成新的文件名
name += (file.getOriginalFilename().
substring(file.getOriginalFilename().lastIndexOf(".")));
// 保存文件
System.out.println(path);
path += name;
file.transferTo(new File(path));
return path;
}
2.3.8. 获取Cookie
一般用户是不会传递这种参数的,基本上都是浏览器构造发过来的,Cookie 和 Session 通常配合使用在登录验证的场景下。
这里同样可以使用 Servlet 那一套 API 获取。
@RequestMapping("/servlet")
public void get(HttpServletRequest req, HttpServletResponse resp) {
//...
}
🍂使用 Servlet 方式获取 Cookie:
@RequestMapping("/cookie")
public void getCookie(HttpServletRequest req) {
//获取请求中全部的 ookie
Cookie[] cookies = req.getCookies();
for (Cookie c : cookies) {
log.info("CookieKey : " + c.getName() + " CookieValue : " + c.getValue());
}
}
我们可以在浏览器随便加上一些 Cookie。
此时我们访问http://127.0.0.1:8080/user/cookie
,来看看控制台是否有输出我们所传的 Cookie。
有记录,就说明我们成功获取到了 Cookie。
🍂简洁地获取Cookie,使用@CookieValue注解,所传参数为你需要获取 Cookie 的 key,使用该注解修饰一个变量,变量里面就会自动获取对应的value值。
@RequestMapping("/cookie2")
public String getCookie2(@CookieValue("zhangsan") String cookie) {
return "zhangsan : " + cookie;
}
如果需要多个 Cookie 值,就写多个 CookieValue 修饰变量就行。
2.3.9. 获取Header
Header 用的比较多的就是获取用户的浏览器的一些基本信息了。
🍂使用 Servlet 获取 Header
@RequestMapping("/getua")
public String getUA(HttpServletRequest req) {
return "用户设备信息User-Agent : " + req.getHeader("User-Agent");
}
🍂更简单地获取 Header,使用 @RequestHeader 注解
和前面使用注解 @CookieValue 用法类似,也是设置一个 key 来获取对应的 value。
@RequestMapping("/getua2")
public String getUA2(@RequestHeader("User-Agent") String ua) {
return "用户设备信息User-Agent : " + ua;
}
2.3.10. 存储和获取Session
在登录逻辑中,我们需要存储 Session 对象,这一步存储操作,SpringMVC 与 Servlet 操作是一样的,获取方式则有两种方式。
🍂存储Session对象:
@RequestMapping("/setsession")
public boolean setSession(HttpServletRequest req) {
boolean result = false;
//1. 获取Session
HttpSession session = req.getSession(true);
//2. 设置Session里面的内容
session.setAttribute("sunli", "sl1213456");
result = true;
return result;
}
访问路径,当新建一个Session对象后,后端会返回一个 Cookie 给前端,根据这个 Cookie 下次验证的时候就能自动登录,不用再次输入账号密码登录了。
🍂使用 Servlet 获取 Session**:**
@RequestMapping("/getsession")
public String getSession(HttpServletRequest req) {
String result = "";
//1.获取Session
HttpSession session = req.getSession(false);
//2.验证
if (session != null && session.getAttribute("sunli") != null) {
result = (String) session.getAttribute("sunli");
}
return result;
}
🍂更加简洁获取 Session,使用@SessionAttribute
该注解有两个属性,value
表示需要获取 Session 对象里面内容的 key 值,还有一个require
表示修饰的参数是否必须,一般需要设置为false
,如果设置成true
,没有获取到对应的value就会返回一个400的页面。
@RequestMapping("/getsession2")
public String getSession2(@SessionAttribute(value = "sunli", required = false) String session) {
return session;
}
2.4. 返回数据
2.4.1. 返回普通的text文本/静态页面
SpringMVC/SpringBoot 默认返回的是视图(xxx.html),这是历史原因了,在方法中返回的数据默认是一个静态页面,如果没有找到这个静态页面,就会显示404。
@Controller
public class TestController {
@RequestMapping("/sayhi")
public String sayHi() {
return "hello.html";
}
}
页面访问结果:
我们再简单写一个静态页面,放入static
目录,来验证一下是否能够获取到。
访问页面结果:
而如果想要返回一个 text 文本数据,则需要使用注解@ResponseBody
修饰对应的方法或者修饰类才能实现。
@Controller
@ResponseBody
public class TestController {
@RequestMapping("/sayhi")
public String sayHi() {
return "hello.html";
}
}
@ResponseBody既可以修饰类,也可以修饰方法;修饰类时,类中所有方法都会返回一个非静态页面数据;修饰方法时,只有被修饰的方法返回的是一个非静态页面的数据;返回的值如果是字符会就转换为 text/html,如果返回的是对象会转换成 application/json 返回给前端。
组合注解:@RestController = @Controller + @ResponseBody
🍂小案例,实现一个加法计数器。
前端页面:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>calc</title>
</head>
<body>
<form action="calc">
<h1>计算器</h1>
数字1 :<input name="num1" type="text"><br>
数字2 :<input name="num2" type="text"><br>
<input type="submit" value=" 查看结果 ">
</form>
</body>
</html>
后端处理代码,返回计算结果:
package com.example.demo.controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class CalcController {
@RequestMapping("/calc")
public String calc(Integer num1, Integer num2) {
// 非空验证
if (num1 == null || num2 == null) {
return "<h2>参数错误!</h2><a href='javascript:history.go(-1)'>返回</a>";
}
return "<h1>" + (num1+num2) + "</h1>";
}
}
前端输入数据:
后端返回结果:
2.4.2. 返回JSON对象
要将指定数据构造成 JSON 格式返回,直接返回一个HashMap<String, Object>
对象即可,SpringMVC会自动处理成 JSON 对象。
@RequestMapping("/getjson")
public HashMap<String, String> method_8() {
HashMap<String, String> map = new HashMap<>();
map.put("Java", "Java Value");
map.put("MySQL", "MySQL Value");
map.put("Redis", "Redis Value");
return map;
}
🍂小案例,实现登录功能。
前端代码如下,实现的功能大致是发送含有账号与密码参数的请求,等待后端验证是否登录成功,给出简单的提示。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<script src="https://apps.bdimg.com/libs/jquery/2.1.4/jquery.min.js"></script>
<title>login</title>
<script>
function mysub() {
let username = jQuery("#username").val();
let password = jQuery("#password").val();
jQuery.getJSON("/login",
{
"username":username,
"password":password
},
function (result) {
if(result.succ==200){
alert("返回结果:"+result.msg);
}else{
alert("操作失败,请重试。");
}
});
}
</script>
</head>
<body>
<div style="text-align: center;">
<h1>登录</h1>
⽤户:<input id="username">
<br>
密码:<input id="password" type="password">
<br>
<input type="button" value=" 提交 " onclick="mysub()" style="margin-top: 20px; margin-left: 50px;">
</div>
</body>
</html>
在后端,我们首先需要接收账号与密码参数,然后对这些参数进行确认,为了方便起见,我们将账号与密码写死,即账号是zhangsan
密码是123
才能登录成功。
我们返回一个 json 格式的数据给前端,里面包含是否登录成功msg
,状态码succ
,将这两种参数以键值对的形式储存到哈希表中返回即可。
package com.example.demo.controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.HashMap;
@RestController
public class LoginController {
@RequestMapping(value = "/login")
public HashMap<String, Object> login(String username, String password){
HashMap<String, Object> res = new HashMap<>();
int succ = 200;
if(username != null && password != null &&
username.equals("zhangsan") && password.equals("123")){
res.put("msg","登录成功");
}else{
res.put("msg","登录失败");
}
res.put("succ",succ);
return res;
}
}
实现效果:
2.4.3. 实现请求转发与重定向
return 不但可以返回一个视图,还可以实现跳转,跳转的方式分别为两种:
- forward:请求转发
- redirect:请求重定向
🎯请求转发是服务器端的行为,不管几次转发都是只发生服务器端,经过多次转发拿到数据后发送给浏览器。
请求转发实现方式1:
@RequestMapping("/fw")
public String myForward() {
//转发 html 静态页面
return "forward:/hello.html";
}
这种方式其实forward:/
是可以省略的,因为我们知道默认情况下,返回的就是一个静态页面。
转发是发生在服务器内,所以,浏览器中的路由地址自始至终是不会发生改变的
请求转发实现方式2:
@RequestMapping("/fw2")
public void myForward2(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
req.getRequestDispatcher("hello.html").forward(req, resp);
}
效果是一样的:
🎯请求重定向其实是多次客户端和浏览器的交互,是浏览器和服务器共同的行为,浏览器发送请求后,服务端只是发送一个重定向响应,告诉浏览器要继续访问哪个 URL,浏览器收到服务器的重定向响应后,就会去访问目标地址。
请求重定向的实现方式1: 与请求转发类似,只不过将forward
改为redirect
。
@RequestMapping("/rd")
public String myRedirect() {
return "redirect:/hello.html";
}
效果图:
从rd
路径跳转到hello.html
页面了,重定向浏览器中的路由地址是会发生改变的。
请求重定向的实现方式2:
@RequestMapping("/rd2")
public void myRedirect2(HttpServletResponse resp) throws IOException {
resp.sendRedirect("hello.html");
}
效果和上面一样的,就不添效果图了。
🍂请求转发(forward)与请求重定向(redirect)之间的区别:
- 定义不同:请求转发发生在服务端程序内部,当服务器端收到一个客户端的请求之后,会先将请求,转发给目标地址,再将目标地址返回的结果转发给客户端;请求重定向指的是服务器端接收到客户端的请求之后,会给客户端返回了一个临时响应头,这个临时响应头中记录了客户端需要再次发送请求(重定向)的 URL 地址,客户端再收到了地址之后,会将请求发送到新的地址上。
- 请求方不同:请求转发是服务器端的行为,是服务器提出请求去获取资源,而请求重定向是客户端的行为,服务器只是告诉客户端去哪里拿资源,实际上是客户端提出请求去获取资源。
- 数据共享不同,请求转发是服务器端实现的,所以整个执行流程中,客户端(浏览器)只需要发送一次请求,因此整个交互过程中使用的都是同一个 Request 请求对象和一个 Response 响应对象,所以整个请求过程中,请求和返回的数据是共享的;而请求重定向客户端发送两次完全不同的请求,所以两次请求中的数据是不同的,是不共享的。
- 最终URL地址不同:请求转发是服务器端代为请求,再将结果返回给客户端的,所以整个请求的过程中 URL 地址是不变的;而请求重定向是服务器端告诉客户端去另外一个地方,于是客户端会再次发送一个请求,因此客户端最终访问的 URL 会发生变化,不是最初的那个URL。
- 代码实现是不同的,写法上类似,但还是有区别,看上面的代码。