JavaEE进阶学习:Spring MVC 程序开发
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
*/
@Controller
public 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>Documenttitle>
head>
<body>
<h1>hello,i am helloh1>
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）服务器端转发。
- 请求重定向地址发生变化，请求转发地址不发生变化。
- 请求重定向与直接访问新地址效果⼀直，不存在原来的外部资源不能访问；请求转发服务器端转发有可能造成原外部资源不能访问。