最全面的SpringBoot教程（三）——SpringBoot Web开发-个人在线分享

前言

最全面的SpringBoot教程（三）——SpringBoot Web开发插图

本文为SpringBoot Web开发相关内容介绍，下边将对静态资源管理（包括：静态资源访问，静态资源前缀，webjar，首页支持），请求参数处理（包括：Rest风格，参数注释），数据响应，模板引擎（包括：Thymeleaf模板引擎，基本语法，thymeleaf使用），登录功能 + 拦截器，异常处理等进行详尽介绍~

📌博主主页：小新要变强的主页
👉Java全栈学习路线可参考：【Java全栈学习路线】最全的Java学习路线及知识清单，Java自学方向指引，内含最全Java全栈学习技术清单~
👉算法刷题路线可参考：算法刷题路线总结与相关资料分享，内含最详尽的算法刷题路线指南及相关资料分享~
👉Java微服务开源项目可参考：企业级Java微服务开源项目（开源框架，用于学习、毕设、公司项目、私活等，减少开发工作，让您只关注业务！）

前言
目录
一、静态资源管理
- 1️⃣静态资源访问
- 2️⃣静态资源前缀
- 3️⃣webjar
- 4️⃣首页支持
二、请求参数处理
- 1️⃣Rest风格
- 2️⃣参数注释
三、数据响应
四、模板引擎
- 1️⃣Thymeleaf模板引擎
- 2️⃣基本语法
- 3️⃣thymeleaf使用
五、登录功能 + 拦截器
六、异常处理
后记

最全面的SpringBoot教程（三）——SpringBoot Web开发插图(1)

一、静态资源管理

1️⃣静态资源访问

默认情况下，Spring Boot 从类路径中的/static (或/public 或/resources 或/META-INF/resources)目录或 ServletContext的根目录提供静态内容。

访问： 当前项目根路径/ + 静态资源名

原理： 静态映射/**。

请求进来，先去找Controller看能不能处理。不能处理的所有请求又都交给静态资源处理器。静态资源也找不到则响应404页面

我们添加图片到resource下的static里：

最全面的SpringBoot教程（三）——SpringBoot Web开发插图(2)

请求进来，先去找Controller看能不能处理。不能处理的所有请求又都交给静态资源处理器。静态资源也找不到则响应404页面

2️⃣静态资源前缀

可以添加访问静态资源前缘：

spring:
  mvc:
    static-path-pattern: /res/**

现在访问就是： 当前项目根路径 + /res + 静态资源名

3️⃣webjar

webjar官网：http://www.webjars.org/

webJars是可以让大家以jar包的形式来使用前端的各种框架、组件。例如，引用jquery。


    org.webjars
    jquery
    3.6.1

最全面的SpringBoot教程（三）——SpringBoot Web开发插图(3)

访问路径：当前项目根路径/ + webjars/**

最全面的SpringBoot教程（三）——SpringBoot Web开发插图(4)

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>Title</title>
</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。
由过滤器来判断改变。

最全面的SpringBoot教程（三）——SpringBoot Web开发插图(5)

如果请求方式是直接发送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") List interests

@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模板引擎

官网：http://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}">msg</p>

<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.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

（2）创建文件，springboot帮我们配置好了，我们直接开发页面即可

最全面的SpringBoot教程（三）——SpringBoot Web开发插图(6)

// 接口
@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>Document</title>
</head>
<body>
<h1 data-th-text="${msg}">提醒消息</h1>
<h2>
<a data-th-href="${link}">超连接</a>
</h2>
</body>
</html>

（3）效果

最全面的SpringBoot教程（三）——SpringBoot Web开发插图(7)

五、登录功能 + 拦截器

例子：访问项目，需要登录，如果没有登录就不能访问

🍀（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>LOGIN</title>
<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">Login</div>
<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 up</a>
</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）测试

最全面的SpringBoot教程（三）——SpringBoot Web开发插图(8)

六、异常处理

错误处理：

默认情况下，Spring Boot提供/error处理所有错误的映射
对于浏览器客户端，响应一个“ whitelabel”错误视图，以HTML格式呈现相同的数据
对于机器客户端，它将生成JSON响应，其中包含错误，HTTP状态和异常消息的详细信息

最全面的SpringBoot教程（三）——SpringBoot Web开发插图(9)

SpringBoot也为我们提供了自定义错误页的功能。

自定义错误页的话可以在静态路径(如/static/）下的error目录。或放在模板目录(如 /templates/)下的error目录，都会被SpringBootz自动解析。

DefaultErrorAttributes：定义错误页面中可以包含哪些数据。

最全面的SpringBoot教程（三）——SpringBoot Web开发插图(11)

后记

最全面的SpringBoot教程（三）——SpringBoot Web开发插图(12)

👉Java全栈学习路线可参考：【Java全栈学习路线】最全的Java学习路线及知识清单，Java自学方向指引，内含最全Java全栈学习技术清单~
👉算法刷题路线可参考：算法刷题路线总结与相关资料分享，内含最详尽的算法刷题路线指南及相关资料分享~

2024年七月
一	二	三	四	五	六	日
						1
2	3	4	5	6	7	8
9	10	11	12	13	14	15
16	17	18	19	20	21	22
23	24	25	26	27	28	29
30

前言

目录

SpringBoot Web开发