Spring Boot 3 指南 三、Spring MVC(2)
zhezhongyun 2025-01-31 16:17 55 浏览
3-3. 使用Thymeleaf与Spring Boot
问题
你希望使用Thymeleaf来渲染你应用程序的页面。
解决方案
添加Thymeleaf的依赖,并创建一个@Controller来确定视图并填充模型。
它是如何工作的
要开始,你首先需要将spring-boot-starter-thymeleaf作为依赖项添加到你的项目中,以获取所需的Thymeleaf依赖项。
通过添加这个依赖项,您将同时获得Thymeleaf库以及Thymeleaf Spring方言,以便两者能够很好地集成。由于这两个库的存在,Spring Boot将自动配置ThymeleafViewResolver。ThymeleafViewResolver需要一个Thymeleaf ITemplateEngine才能解析和渲染视图。一个特殊的SpringTemplateEngine将预先配置有SpringDialect,这样您就可以在Thymeleaf页面中使用SpEL。
要添加其他Thymeleaf方言,您只需要创建一个@Bean方法,Spring Boot将自动检测并将其与Thymeleaf连接。有些甚至在与Spring Security集成时会自动配置(参见第5章)。
要配置Thymeleaf,Spring Boot在spring.thymeleaf命名空间中公开了几个属性(参见表3-2)。
添加一个索引页面
首先,在我们的应用程序中添加一个索引页面。在src/main/resources/templates目录(默认位置)内创建一个index.html文件。参见列表3-13。
这只是一个带有Thymeleaf一些小改动的基础HTML5页面。首先,有xmlns:th="http://www.thymeleaf.org"来启用Thymeleaf的命名空间。命名空间在链接中通过th:href使用。@{/books.html}部分将被Thymeleaf扩展成一个适当的链接,并放置在链接的实际href属性中。
现在,当运行应用程序时,你应该会看到一个带有指向书籍概览链接的页面(见图3-5)。
添加一个控制器和视图
当点击索引页面提供的链接时,我们希望看到一个页面,该页面显示图书馆中可用的书籍列表(见图3-6)。为此,需要添加两样东西:首先是一个可以处理请求并准备模型的控制器,其次是一个用于渲染书籍列表的视图。
让我们添加一个控制器,它将用书籍列表填充模型,并选择要渲染的视图名称。控制器是一个带有@Controller注解的类,其中包含处理请求的方法(带有@RequestMapping注解的方法,或者像本例中的@GetMapping,这是一个专门的@RequestMapping注解)。参见列表3-14。
BookController 需要 BookService 来获取书籍列表以展示。all 方法有一个参数是 org.springframework.ui.Model,这样我们就可以将书籍列表放入模型中。请求处理方法可以有不同的参数;其中一个就是 Model 类。在方法中,我们使用 BookService 从数据存储中检索所有书籍,并使用 model.addAttribute 将其添加到模型中。现在,书籍列表在模型中以键 books 可用。
最后,我们返回视图名称以渲染books/list。
现在控制器以及请求处理方法已经添加,
我们需要创建视图。在src/main/templates/books目录下创建一个list.html文件。参见列表3-15。
这又是一个使用Thymeleaf语法的HTML5页面。页面将使用th:each表达式渲染书籍列表。它将从模型中的books属性获取所有书籍,并为每本书创建一行。行中的每一列将使用th:text表达式包含一些文本;它将打印书籍的标题、作者和ISBN。表格的最后一列包含指向书籍详情的链接。它使用th:href表达式构建URL。注意括号之间的表达式;这将添加isbn请求参数。
当启动应用程序并点击索引页面上的链接时,您应该会看到一个显示图书馆内容的页面,如前面的图3-6所示。
添加详情页面
最后,当点击表格中的ISBN号码时,您希望显示一个包含详情的页面。链接包含一个名为isbn的请求参数,我们可以在控制器中检索并使用它来查找书籍。通过带有@RequestParam注解的方法参数可以检索请求参数。
以下方法将处理GET请求,将请求参数映射到方法参数,并包括模型,以便我们可以将书籍添加到模型中。
控制器将渲染书籍/详情页面。将details.html文件添加到src/main/resources/templates/books目录中。参见列表3-16。
这个HTML5 Thymeleaf模板将在页面上渲染两个可用块中的一个。如果找到了书籍,它将显示详细信息;如果没有找到,它将显示一个“未找到”的消息。这是通过使用th:if表达式实现的。"未找到"消息的isbn是从请求参数中检索的,使用param作为前缀;${param.isbn}将获取isbn请求参数。
测试一个@Controller
由于你希望确保控制器能够执行其应有的功能,编写一个测试来验证控制器的正确行为。参见列表3-17。
测试使用 @WebMvcTest 创建基于 MockMvc 的集成测试。它将创建一个最小的 Spring Boot 应用程序以便能够运行控制器。控制器需要一个 BookService 的实例,因此我们让框架使用 @MockBean 注解来创建一个模拟对象。在不同的测试方法中,我们模拟预期的行为(比如返回书籍列表,返回一个空的 Optional 等)。
Spring Boot 使用 Mockito 通过 @MockBean 创建模拟对象。
通过 Spring 测试框架的 MockMvc 支持,我们可以检查控制器是否返回了我们所期望的。我们可以检查 HTTP 状态,视图的名称,以及 Model 是否包含了正确的条目。
相关推荐
- 用豆包生成的BMI计算器(豆包的热量是多少?)
-
<!DOCTYPEhtml><htmllang="en"><head><metacharset="UTF-8...
- Android 开发中文引导-应用小部件
-
应用小部件是可以嵌入其它应用(例如主屏幕)并收到定期更新的微型应用视图。这些视图在用户界面中被叫做小部件,并可以用应用小部件提供者发布。可以容纳其他应用部件的应用组件叫做应用部件的宿主(1)。下面的截...
- Qt推流(视频文件/视频流/摄像头/桌面转流媒体rtmp+hls+webrtc)
-
一、前言说明推流直播就是把采集阶段封包好的内容传输到服务器的过程。其实就是将现场的视频信号从手机端,电脑端,摄影机端打包传到服务器的过程。“推流”对网络要求比较高,如果网络不稳定,直播效果就会很差,观...
- 一看就会!谷歌广告转化跟踪详细设置指南来了
-
在出海推广业务中,投放广告最常见的目的是获取订单,但我们怎么知道有没有达成投放目的呢?谷歌转化跟踪技术就可以做到!熟悉谷歌的卖家朋友都知道,转化跟踪在最近几年变得越来越复杂了,虽然有很多选项可以自定义...
- Android原生编解码接口MediaCodec详解
-
作者:躬行之MediaCodec是Android中的编解码器组件,用来访问底层提供的编解码器,通常与MediaExtractor、MediaSync、MediaMuxer、MediaCrypt...
- 手把手搭建RTSP流媒体服务器(rtsp 流媒体)
-
0.引言本文主要讲解如何搭建RTSP流媒体服务器的过程,使用开源项目ZLMediaKit。通过这个开源项目,推RTSP流到服务器,然后拉流端可以拉取RTSP、RTMP等流。ZLMediaKit码云链接...
- MediaInfo 24.04.0 是一个关于多媒体文件的信息提供工具
-
MediaInfo24.04.0是一个关于多媒体文件的信息提供工具(仅当文件中包含信息时才提供):包括常规信息(标题、作者、导演、专辑、曲目编号、日期、时长等);视频信息(编解码器、画面比例、帧率...
- rmvb格式视频怎么打开,rmvb转MP4认准这个方法
-
一、rmvb是什么格式? RMVB是一种视频文件格式,其中的VB指的是可变比特率。比起上一代的RM格式,RMVB 格式的画面比较清晰,因为它是降低了静态画面下的比特率。 二、制作rmvb ①...
- 教你用Plex Media Server,把铁威马变成你的“私人好莱坞”!
-
TNAS(铁威马NAS)中可以安装多媒体服务器、影视、PlexMediaServer、EmbyServer作为个人媒体服务器使用。PlexMediaServer可以组织整理TNAS上的媒体...
- 你肯定用过!经典Windows软件被抛弃
-
Windows系统这些年持续更新的过程中,不断融入新的软件和功能的同时,一些经典的应用也渐渐成为了历史……Windows媒体播放器被抛弃Windows系统不断地推陈出新,一些老旧的组件也难免被抛弃,在...
- 博思得Q8标签打印全能手(博思得标签打印机安装教程)
-
2014-12-0905:35:00作者:宋达希【中关村在线办公打印频道原创】服装吊牌、洗涤标签、产品说明标签等都要用到标签打印机,这些标签涵盖多种尺寸的长度和宽度以及材质。另外作为一件商品或者产...
- flv文件用什么播放器打开,这样做不踩雷!
-
FLV是FLASHVIDEO的简称,是随着FlashMX的推出发展而来的视频格式。它的出现有效地解决了视频文件导入Flash后,使导出的SWF文件体积庞大,不能在网络上很好的使用等问题。一、...
- media player怎么转换格式?音频转换神器推荐!
-
Windowsmediaplayer怎么转换格式?WindowsMediaPlayer是微软公司出品的一款多媒体播放器,通常简称“WMP”。提供了编辑音频和视频文件的功能。用户可以使用该软件导...
- 视频参数检查工具更新:MediaInfo 23.10
-
MediaInfo提供有关视频或音频文件的技术和标签信息。信息示例包括编解码器、比特率、每秒帧数、宽度、高度、频道数、持续时间、标题、作者、字幕语言和章节名称。多种方式可以查看信息(文本、工作表、树和...
- 多媒体管理软件:JRiver Media Center 31.0.68 (64位)
-
JRiverMediaCenter64位是适用于大量库的完整媒体解决方案。它组织、播放和标记所有类型的媒体文件,并对Xbox、PS3、UPnP、DLNA和TiVo进行翻录、刻录。JRiverM...
- 一周热门
- 最近发表
- 标签列表
-
- HTML 教程 (33)
- HTML 简介 (35)
- HTML 实例/测验 (32)
- HTML 测验 (32)
- JavaScript 和 HTML DOM 参考手册 (32)
- HTML 拓展阅读 (30)
- HTML常用标签 (29)
- HTML文本框样式 (31)
- HTML滚动条样式 (34)
- HTML5 浏览器支持 (33)
- HTML5 新元素 (33)
- HTML5 WebSocket (30)
- HTML5 代码规范 (32)
- HTML5 标签 (717)
- HTML5 标签 (已废弃) (75)
- HTML5电子书 (32)
- HTML5开发工具 (34)
- HTML5小游戏源码 (34)
- HTML5模板下载 (30)
- HTTP 状态消息 (33)
- HTTP 方法:GET 对比 POST (33)
- 键盘快捷键 (35)
- 标签 (226)
- HTML button formtarget 属性 (30)
- CSS 水平对齐 (Horizontal Align) (30)