最全面的SpringBoot教程（三）——SpringBoot Web开发
前言
本文为SpringBoot Web开发相关内容介绍，下边将对静态资源管理（包括：静态资源访问，静态资源前缀，webjar，首页支持），请求参数处理（包括：Rest风格，参数注释），数据响应，模板引擎（包括：Thymeleaf模板引擎，基本语法，thymeleaf使用），登录功能 + 拦截器，异常处理等进行详尽介绍~
博主主页：小新要变强 的主页
Java全栈学习路线可参考：【Java全栈学习路线】最全的Java学习路线及知识清单，Java自学方向指引，内含最全Java全栈学习技术清单~
算法刷题路线可参考：算法刷题路线总结与相关资料分享，内含最详尽的算法刷题路线指南及相关资料分享~
Java微服务开源项目可参考：企业级Java微服务开源项目（开源框架，用于学习、毕设、公司项目、私活等，减少开发工作，让您只关注业务！）
目录
SpringBoot Web开发
- 前言
- 目录
- 一、静态资源管理
-
- 1️⃣静态资源访问
- 2️⃣静态资源前缀
- 3️⃣webjar
- 4️⃣首页支持
- 二、请求参数处理
-
- 1️⃣Rest风格
- 2️⃣参数注释
- 三、数据响应
- 四、模板引擎
-
- 1️⃣Thymeleaf模板引擎
- 2️⃣基本语法
- 3️⃣thymeleaf使用
- 五、登录功能 + 拦截器
- 六、异常处理
- 后记
一、静态资源管理
1️⃣静态资源访问
默认情况下，Spring Boot 从类路径中的/static (或/public 或/resources 或/META-INF/resources)目录或 ServletContext的根目录提供静态内容。
访问： 当前项目根路径/ + 静态资源名
原理： 静态映射/**。
请求进来，先去找Controller看能不能处理。不能处理的所有请求又都交给静态资源处理器。静态资源也找不到则响应404页面
我们添加图片到resource下的static里：
请求进来，先去找Controller看能不能处理。不能处理的所有请求又都交给静态资源处理器。静态资源也找不到则响应404页面
2️⃣静态资源前缀
可以添加访问静态资源前缘：
spring:
mvc:
static-path-pattern: /res/**
现在访问就是： 当前项目根路径 + /res + 静态资源名
3️⃣webjar
webjar官网：https://www.webjars.org/
webJars是可以让大家以jar包的形式来使用前端的各种框架、组件。例如，引用jquery。
org.webjars
jquery
3.6.1
访问路径：当前项目根路径/ + webjars/**
4️⃣首页支持
- 静态资源路径下 index.html
- 可以配置静态资源路径
- 不能与静态资源前缀共用
spring:
resources:
static-locations: [classpath:/haha/]
二、请求参数处理
1️⃣Rest风格
RESTFUL是一种网络应用程序的设计风格和开发方式。
对比：
| 功能 | 传统请求 | Rest风格 |
|---|---|---|
| 获取用户 | /user/getUser （GET请求） | /user （GET请求） |
| 保存用户 | /user/saveUse （POST请求） | /user （POST请求） |
| 修改用户 | /user/editUser （POST请求） | /user （PUT请求） |
| 删除用户 | /user/deleteUser（POST请求） | /user （DELETE请求） |
springboot用法：表单method=post，隐藏域 _method=put。
（1）开启页面表单的Rest功能
spring:
mvc:
hiddenmethod:
filter:
# 开启页面表单的Rest功能
enabled: true
（2）添加页面请求
DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Titletitle>
head>
<script src="/webjars/jquery/3.6.1/jquery.js">script>
<body>
<h1>首页h1>
<button id="getUser">获取用户button>
<button id="saveUser">保存用户button>
<button id="editUser">修改用户button>
<button id="deleteUser">删除用户button>
<p id="msg">p>
<script>
$("#getUser").on("click",()=>{
$.get("/user",(res)=>{
$("#msg").text(res);
})
});
$("#saveUser").on("click",()=>{
sendAjax(null);
});
$("#editUser").on("click",()=>{
sendAjax('PUT');
});
$("#deleteUser").on("click",()=>{
sendAjax("DELETE");
});
function sendAjax(type){
let data = {'_method':type}
$.post("/user",data,(res)=>{
$("#msg").text(res);
})
}
script>
body>
html>
（3）添加后端接口
// 组合注解，@Controller + RequestBody
@RestController
@RequestMapping("/user")
public class UserController {
// 普通写法
// @RequestMapping(value = "/user",method = RequestMethod.GET)
// 精简写法
@GetMapping
public String getUser(){
return "get user";
}
@PostMapping
public String saveUser(){
return "post user";
}
@PutMapping
public String editUser(){
return "put user";
}
@DeleteMapping
public String deleteUser(){
return "delete user";
}
}
为什么明明请求方式是POST，会跑到别的接口。
- 核心Filter；HiddenHttpMethodFilter。
- 由过滤器来判断改变。
如果请求方式是直接发送Put、delete等方式请求，无需Filter。
扩展：_method的值可以自定义，只需要重新实现过滤器方法即可。
//自定义filter
@Bean
public HiddenHttpMethodFilter hiddenHttpMethodFilter(){
HiddenHttpMethodFilter methodFilter = new HiddenHttpMethodFilter();
methodFilter.setMethodParam("_m");
return methodFilter;
}
2️⃣参数注释
@PathVariable：从请求路径上获取参数@RequestHeader：从请求头上获取参数@RequestParam：从请求参数上获取参数@CookieValue：从请求Cookie中获取参数@RequestBody：从请求body上获取参数@MatrixVariable：从请求路径上；分割获取变量- SpringBoot默认禁用
- 语法：
请求路径/test;user=jack;age=16,interests=sleep,dream - 后端接收,
@MatrixVariable("user") String name,@MatrixVariable("age") Integer age,@MatrixVariable("interests") Listinterests
@GetMapping("/{id}")
public String getParam(@PathVariable("id") Integer id,
@RequestHeader("Host") String host,
@RequestParam("name") Integer name,
@CookieValue("_username") String usernmae){
}
@PostMapping
public void postMethod(@RequestBody String content){
}
// 可以传多个值，用对象来接收，存在相同属性时，会自动封装到里面。
@PostMapping
public void postMethod(@RequestBody Student student){
}
三、数据响应
数据响应，一般分两个类型：
- 响应页面
- 响应数据
响应数据的格式可以是json,xml,io流等。
SpringMVC支持返回值：
ModelAndView
Model
View
ResponseEntity
ResponseBodyEmitter
StreamingResponseBody
HttpEntity
HttpHeaders
Callable
DeferredResult
ListenableFuture
CompletionStage
WebAsyncTask
有 @ModelAttribute 且为对象类型的@ResponseBody 注解
四、模板引擎
SpringBoot默认不支持 JSP，需要引入第三方模板引擎技术实现页面渲染。
1️⃣Thymeleaf模板引擎
官网：https://www.thymeleaf.org/
前端显示页面，是html页面。我们以前开发，做的是jsp页面，jsp可以动态渲染一些数据在页面上，可以写Java代码。JSP+Servlet+JavaBean，是我们很早之前就不用了，企业也用得少。
现在SpringBoot推荐Thymeleaf模板引擎。
2️⃣基本语法
| 表达式名字 | 语法 | 用途 |
|---|---|---|
| 变量取值 | ${…} | 获取请求域、session域、对象等值 |
| 选择变量 | *{…} | 获取上下文对象值 |
| 消息 | #{…} | 获取国际化等值 |
| 链接 | @{…} | 生成链接 |
| 片段表达式 | ~{…} | jsp:include 作用，引入公共页面片段 |
<html xmlns:th="http://www.thymeleaf.org">
<p data-th-text="${msg}">msgp>
<p th:text="${msg}">提醒消息p>
<a th:href="@{href}">超链接a>
<input type="text" th:id="${student.id}" />
<p th:id="${#session.user}" />
3️⃣thymeleaf使用
（1）添加thymeleaf依赖
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-thymeleafartifactId>
dependency>
（2）创建文件，springboot帮我们配置好了，我们直接开发页面即可
// 接口
@Controller
public class IndexController {
@GetMapping("/thymeleaf")
public String index(Model model) {
model.addAttribute("msg","hello thymeleaf");
model.addAttribute("link","www.baidu.com");
// 返回视图层
return "thymeleaf";
}
}
在templates下新建thymeleaf.html：
doctype html>
<html>
<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 data-th-text="${msg}">提醒消息h1>
<h2>
<a data-th-href="${link}">超连接a>
h2>
body>
html>
（3）效果
五、登录功能 + 拦截器
例子：访问项目，需要登录，如果没有登录就不能访问
（1）添加登录页面：login.html
DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>LOGINtitle>
<style>
* {
margin: 0;
padding: 0;
}
html {
height: 100%;
}
body {
height: 100%;
}
.container {
height: 100%;
background-image: linear-gradient(to right, #fbc2eb, #a6c1ee);
}
.login-wrapper {
background-color: #fff;
width: 358px;
height: 588px;
border-radius: 15px;
padding: 0 50px;
position: relative;
left: 50%;
top: 50%;
transform: translate(-50%, -50%);
}
.header {
font-size: 38px;
font-weight: bold;
text-align: center;
line-height: 200px;
}
.input-item {
display: block;
width: 100%;
margin-bottom: 20px;
border: 0;
padding: 10px;
border-bottom: 1px solid rgb(128, 125, 125);
font-size: 15px;
outline: none;
}
.input-item:placeholder {
text-transform: uppercase;
}
.btn {
border: 0;
font-size: 20px;
text-align: center;
padding: 10px;
width: 100%;
margin-top: 40px;
background-image: linear-gradient(to right, #a6c1ee, #fbc2eb);
color: #fff;
}
.msg {
color:red;
text-align: center;
line-height: 88px;
}
a {
text-decoration-line: none;
color: #abc1ee;
}
style>
head>
<body>
<div class="container">
<div class="login-wrapper">
<div class="header">Logindiv>
<div class="form-wrapper">
<form data-th-action="@{/login}" method="post">
<input type="password" name="password" placeholder="password" class="input-item" />
<input type="submit" class="btn" value="Login" />
form>
div>
<div class="msg" data-th-text="${msg}">
Don't have account?
<a href="#">Sign upa>
div>
div>
div>
body>
html>
（2）添加登录接口
@Controller
public class LoginController {
@GetMapping("/")
public String index() {
// 返回视图层
return "/login/login";
}
@PostMapping("/login")
public String login(String username, String password, HttpSession session, Model model) {
if(StringUtils.hasLength(username) && "123456".equals(password)){
//把登陆成功的用户保存起来
session.setAttribute("loginUserName",username);
//登录成功重定向到 thymeleaf ; 重定向防止表单重复提交
return "redirect:/thymeleaf";
}else {
model.addAttribute("msg","账号密码错误");
//回到登录页面
return "/";
}
}
}
（3）添加拦截器
继承HandlerInterceptor 接口
@Slf4j
public class LoginInterceptor implements HandlerInterceptor {
/**
* 目标方法执行之前
* @param request
* @param response
* @param handler
* @return
* @throws Exception
*/
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
// 请求路径 request.getRequestURI();
//登录检查逻辑
HttpSession session = request.getSession();
Object loginUser = session.getAttribute("loginUserName");
if(loginUser != null){
//放行
return true;
}
//拦截住。未登录。跳转到登录页
request.setAttribute("msg","请先登录");
// 跳转
request.getRequestDispatcher("/").forward(request,response);
return false;
}
}
（4）配置拦截器
@Configuration
public class AdminWebConfig implements WebMvcConfigurer {
@Override
public void addInterceptors(InterceptorRegistry registry) {
registry.addInterceptor(new LoginInterceptor())
// 所有请求都被拦截包括静态资源
.addPathPatterns("/**")
// 放行的请求
.excludePathPatterns("/","/login","/css/**","/fonts/**","/images/**","/js/**");
}
}
（5）测试
六、异常处理
错误处理：
- 默认情况下，Spring Boot提供
/error处理所有错误的映射 - 对于浏览器客户端，响应一个“ whitelabel”错误视图，以HTML格式呈现相同的数据
- 对于机器客户端，它将生成JSON响应，其中包含错误，HTTP状态和异常消息的详细信息
SpringBoot也为我们提供了自定义错误页的功能。
自定义错误页的话可以在静态路径(如/static/）下的error目录。或放在模板目录(如 /templates/)下的error目录，都会被SpringBootz自动解析。
DefaultErrorAttributes：定义错误页面中可以包含哪些数据。
后记
Java全栈学习路线可参考：【Java全栈学习路线】最全的Java学习路线及知识清单，Java自学方向指引，内含最全Java全栈学习技术清单~
算法刷题路线可参考：算法刷题路线总结与相关资料分享，内含最详尽的算法刷题路线指南及相关资料分享~