SpringBoot 实战 (十二) | 整合 thymeleaf

迈不过友情╰ 2022-03-16 01:52 214阅读 0赞

> 微信公众号：一个优秀的废人  
> 如有问题或建议，请后台留言，我会尽力解决你的问题。

#### 前言 ####

如题，今天介绍 Thymeleaf ，并整合 Thymeleaf 开发一个简陋版的学生信息管理系统。

SpringBoot 提供了大量模板引擎，包含 Freemarker、Groovy、Thymeleaf、Velocity 以及 Mustache，SpringBoot 中推荐使用 Thymeleaf 作为模板引擎，因为 Thymeleaf 提供了完美的 SpringMVC 支持。Thymeleaf 是新一代 Java 模板引擎，在 Spring 4 后推荐使用。

#### 什么是模板引擎？ ####

Thymeleaf 是一种模板语言。那模板语言或模板引擎是什么？常见的模板语言都包含以下几个概念：数据（Data）、模板（Template）、模板引擎（Template Engine）和结果文档（Result Documents）。

*  数据  
    数据是信息的表现形式和载体，可以是符号、文字、数字、语音、图像、视频等。数据和信息是不可分离的，数据是信息的表达，信息是数据的内涵。数据本身没有意义，数据只有对实体行为产生影响时才成为信息。
 *  模板  
    模板，是一个蓝图，即一个与类型无关的类。编译器在使用模板时，会根据模板实参对模板进行实例化，得到一个与类型相关的类。
 *  模板引擎  
    模板引擎（这里特指用于Web开发的模板引擎）是为了使用户界面与业务数据（内容）分离而产生的，它可以生成特定格式的文档，用于网站的模板引擎就会生成一个标准的HTML文档。
 *  结果文档  
    一种特定格式的文档，比如用于网站的模板引擎就会生成一个标准的HTML文档。

模板语言用途广泛，常见的用途如下：

*  页面渲染
 *  文档生成
 *  代码生成
 *  所有 “数据+模板=文本” 的应用场景

#### Thymeleaf 简介 ####

Thymeleaf 是一个 Java 类库，它是一个 xml/xhtml/html5 的模板引擎，可以作为 MVC 的 web 应用的 View 层。

Thymeleaf 还提供了额外的模块与 SpringMVC 集成，所以我们可以使用 Thymeleaf 完全替代 JSP 。

#### Thymeleaf 语法 ####

博客资料：[http://www.cnblogs.com/nuoyiamy/p/5591559.html][http_www.cnblogs.com_nuoyiamy_p_5591559.html]  
官方文档：[http://www.thymeleaf.org/documentation.html][http_www.thymeleaf.org_documentation.html]

#### SpringBoot 整合 Thymeleaf ####

下面使用 SpringBoot 整合 Thymeleaf 开发一个简陋版的学生信息管理系统。

1、准备工作

*  IDEA
 *  JDK1.8
 *  SpringBoot2.1.3

2、pom.xml 主要依赖

<dependencies>
            
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-data-jpa</artifactId>
            </dependency>
            
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-thymeleaf</artifactId>
            </dependency>
            
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
            
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <scope>runtime</scope>
            </dependency>
    </dependencies>

3、application.yaml 文件配置

spring:
      # 数据库相关
      datasource:
        driver-class-name: com.mysql.cj.jdbc.Driver
        url: jdbc:mysql://127.0.0.1:3306/test?useUnicode=true&characterEncoding=utf8&serverTimezone=UTC&useSSL=true
        username: root
        password: 123456
      # jpa 相关
      jpa:
        hibernate:
          ddl-auto: update   # ddl-auto: 第一次启动项目设为 create 表示每次都重新建表，之后设置为 update
        show-sql: true

4、实体类

@Data
    @Entity
    @AllArgsConstructor
    @NoArgsConstructor
    public class Student { 
    
        @Id
        @GeneratedValue
        /** * 主键 */
        private Long id;
    
        /** * 主键 */
        private Long studentId;
    
        /** * 姓名 */
        private String name;
    
        /** * 年龄 */
        private Integer age;
    
        /** * 专业 */
        private String major;
    
        /** * 宿舍 */
        private String dormitory;
    
        /** * 籍贯 */
        private String city;
    
        /*@Temporal(TemporalType.TIMESTAMP)//将时间戳，转换成年月日时分秒的日期格式 @Column(name = "create_time",insertable = false, updatable=false, columnDefinition = "timestamp default current_timestamp comment '注册时间'") private Date createDate; @Temporal(TemporalType.TIMESTAMP)//将时间戳，转换成年月日时分秒的日期格式 @Column(name = "update_time",insertable = false, updatable=true, columnDefinition = "timestamp default current_timestamp comment '修改时间'") private Date updateDate;*/
    
    }

5、dao 层

@Repository
    public interface StudentRepository extends JpaRepository<Student, Long> { 
    }

6、service 层

public interface StudentService { 
    
        List<Student> findStudentList();
    
        Student findStudentById(Long id);
    
        Student saveStudent(Student student);
    
        Student updateStudent(Student student);
    
        void deleteStudentById(Long id);
    
    }

实现类：

@Service
    public class StudentServiceImpl implements StudentService { 
    
        @Autowired
        private StudentRepository studentRepository;
    
        /** * 查询所有学生信息列表 * @return */
        @Override
        public List<Student> findStudentList() { 
            Sort sort = new Sort(Direction.ASC,"id");
            return studentRepository.findAll(sort);
        }
    
        /** * 根据 id 查询单个学生信息 * @param id * @return */
        @Override
        public Student findStudentById(Long id) { 
            return studentRepository.findById(id).get();
        }
    
        /** * 保存学生信息 * @param student * @return */
        @Override
        public Student saveStudent(Student student) { 
            return studentRepository.save(student);
        }
    
        /** * 更新学生信息 * @param student * @return */
        @Override
        public Student updateStudent(Student student) { 
            return studentRepository.save(student);
        }
    
        /** * 根据 id 删除学生信息 * @param id * @return */
        @Override
        public void deleteStudentById(Long id) { 
            studentRepository.deleteById(id);
        }
    }

7、controller 层 (Thymeleaf) 使用

controller 层将 view 指向 Thymeleaf：

@Controller
    @RequestMapping("/student")
    public class StudentController { 
    
        @Autowired
        private StudentService studentService;
    
        /** * 获取学生信息列表 * @param map * @return */
        @GetMapping("/list")
        public String findStudentList(ModelMap map) { 
            map.addAttribute("studentList",studentService.findStudentList());
            return "studentList";
        }
    
        /** * 获取保存 student 表单 */
        @GetMapping(value = "/create")
        public String createStudentForm(ModelMap map) { 
            map.addAttribute("student", new Student());
            map.addAttribute("action", "create");
            return "studentForm";
        }
    
        /** * 保存学生信息 * @param student * @return */
        @PostMapping(value = "/create")
        public String saveStudent(@ModelAttribute Student student) { 
            studentService.saveStudent(student);
            return "redirect:/student/list";
        }
    
        /** * 根据 id 获取 student 表单，编辑后提交更新 * @param id * @param map * @return */
        @GetMapping(value = "/update/{id}")
        public String edit(@PathVariable Long id, ModelMap map) { 
            map.addAttribute("student", studentService.findStudentById(id));
            map.addAttribute("action", "update");
            return "studentForm";
        }
    
        /** * 更新学生信息 * @param student * @return */
        @PostMapping(value = "/update")
        public String updateStudent(@ModelAttribute Student student) { 
            studentService.updateStudent(student);
            return "redirect:/student/list";
        }
    
        /** * 删除学生信息 * @param id * @return */
        @GetMapping(value = "/delete/{id}")
        public String deleteStudentById(@PathVariable Long id) { 
            studentService.deleteStudentById(id);
            return "redirect:/student/list";
        }
    }

简单说下，ModelMap 对象来进行数据绑定到视图。return 字符串，该字符串对应的目录在 resources/templates 下的模板名字。 @ModelAttribute 注解是用来获取页面 Form 表单提交的数据，并绑定到 Student 数据对象。

8、studentForm 表单

定义了一个 Form 表单用于注册或修改学生信息。

9、studentList 学生列表

用于展示学生信息：

<table class="table table-hover table-condensed">
            <legend>
                <strong>学生信息列表</strong>
            </legend>
            <thead>
            <tr>
                <th>学号</th>
                <th>姓名</th>
                <th>年龄</th>
                <th>专业</th>
                <th>宿舍</th>
                <th>籍贯</th>
                <th>管理</th>
            </tr>
            </thead>
            <tbody>
            <tr th:each="student : ${studentList}">
                <th scope="row" th:text="${student.studentId}"></th>
                <td><a th:href="@{/student/update/{studentId}(studentId=${student.id})}" th:text="${student.name}"></a></td>
                <td th:text="${student.age}"></td>
                <td th:text="${student.major}"></td>
                <td th:text="${student.dormitory}"></td>
                <td th:text="${student.city}"></td>
                <td><a class="btn btn-danger" th:href="@{/student/delete/{studentId}(studentId=${student.id})}">删除</a></td>
            </tr>
            </tbody>
        </table>

#### 页面效果 ####

列表页面：点击按钮可注册学生信息

![初始页面][1240]

![注册/修改学生信息页面][1240 1]

有数据的列表页面：点击名字跳到注册/修改页面可修改学生信息，点击删除可删除学生信息

![列表页面][1240 2]

#### 后语 ####

如果本文对你哪怕有一丁点帮助，请帮忙点好看。你的好看是我坚持写作的动力。

另外，关注之后在发送 **1024** 可领取免费学习资料。资料内容详情请看这篇旧文：[Python、C++、Java、Linux、Go、前端、算法资料分享][Python_C_Java_Linux_Go]

![1240 3][]

[http_www.cnblogs.com_nuoyiamy_p_5591559.html]: http://www.cnblogs.com/nuoyiamy/p/5591559.html
[http_www.thymeleaf.org_documentation.html]: http://www.thymeleaf.org/documentation.html
[1240]: /images/20220316/b114aaca8f96445e8cad6fc82cdcf957.png
[1240 1]: /images/20220316/bbf3676caede41189b20c6e0eed0f1ea.png
[1240 2]: /images/20220316/4689e577477d46cbbf412c0120604e59.png
[Python_C_Java_Linux_Go]: https://www.jianshu.com/p/ed43dc8aa11e
[1240 3]: /images/20220316/db7a5f165be94018a4c67e8c8c57b310.png