JavaEE开发之SpringBoot整合MyBatis以及Thymeleaf模板引擎-白红宇

上篇博客我们聊了《JavaEE开发之SpringBoot工程的创建、运行与配置》，从上篇博客的内容我们不难看出SpringBoot的便捷。本篇博客我们继续在上篇博客的基础上来看一下SpringBoot是如何引入和使用MyBatis和Thymeleaf的。在之前的博客中我们提到过Hibernate，今天博客所引入的Mybatis所扮演的角色与Hibernate类似，都是一套ORM框架，主要负责持久化的，也是将数据库中的数据直接映射为Model的框架。

而Thymeleaf就是一个模板引擎了，与之前我们聊得PHP中的Smarty模板引擎类似。如果你们的Web工程是前后端分离的，那么就用不着Thymeleaf等模板引擎了。本篇博客要做的事情就是在SpringBoot工程中引入MyBatis，然后通过MyBatis所提供的映射方法以及注解来读取数据库中的信息。然后使用Thymeleaf模板在前端进行数据的展示。

我们之前在聊Swift开发服务端的内容，也就是Perfect框架时，用到了MySQL相关的东西。本篇博客我们就使用Perfect框架之前所操作的数据库就行了。关于Swift的Perfect框架的相关内容，请移步于《Swift中的服务端框架---Perfect》系列博客。因为之前聊过MySQL相关的东西了，本篇博客就不做过多赘述了。关于MySQL的安装，请参见之前发布的博客《macOS Sierra安装Apache2.4+PHP7.0+MySQL5.7.16》。本篇博客，我们就把重点放到Spring Boot中的MyBatis和Thymeleaf上。

一、MyBatis的引入与使用

1.配置pom文件

首先我们来看一下如何在Spring Boot中引入MyBatis。首先我们在http://mvnrepository.com/中找到Mybatis Spring Boot Starter相关的Mvn仓库连接。如下所示，从下方截图中，我们不难看出，目前MyBatis Spring Boot Starter的最新版本是1.2.0。不过本篇博客中我们使用的是1.1.1版本，因为我引入1.2.0后，我的SpringBoot工程根本启动不了，于是换成1.1.1版本就OK了。

JavaEE开发之SpringBoot整合MyBatis以及Thymeleaf模板引擎

在pom.xml添加上下方的配置项，引入mybatis-spring-boot-starter和mysql-connector-java相关配置。mysql-connector-java顾明思议，就是连接MySQL数据库使用的依赖包。pom.xml中的配置如下。


            
     
     
      org.mybatis.spring.boot
      
     
      mybatis-spring-boot-starter
      
     
      1.1.1
             
                    
            
     
     
      mysql
      
     
      mysql-connector-java
      
     
      5.1.38

2、配置MySQL数据库连接

因为我们使用的是Spring Boot引入的MyBatis, Mybatis Spring Boot Starter会为我们做好多自动化的配置，比如SqlSessionFactory的创建等等。需要我们做的就是在application.properties文件中进行数据库连接的相关配置即可。下方就是我们在配置文件中添加的连接数据库的相关信息。主要配置了数据库连接的路径，数据库的用户名以及密码，数据库的驱动。

#Config MySQL Connect Infospring.datasource.url=jdbc:mysql://127.0.0.1:3306/perfect_notespring.datasource.username=rootspring.datasource.password=admin!@#spring.datasource.driver-class-name=com.mysql.jdbc.Driver

3、创建Model类

接下来我们就来创建数据库中的相应数据所要映射的数据Model类。接下来我们就来操作perfect_note数据库中的content表，如下所示。下方数据库及数据库中的数据是我们之前在聊Perfect框架时所使用的数据，本篇博客我们依然对该数据进行操作。

根据上述cotent表中的字段，我们来创建该表所对应的model类。下方这个Content类就是我们所创建的content表所对应的Model。具体如下所示。

4.创建映射接口

接下来我们来创建数据库表与Model直接的映射接口。在该接口中提供了数据与Model直接的映射关系，并且提供了相关的SQL操作。下方的ContentMapper接口就是我们创建的content表与ContentModel之间的映射关系。并且在该接口中的方法所对应的注解中，提供了相应的SQL操作。

在ContentMapper接口的query方法中，该方法所对应的SQL语句是“select * from content”，也就是查询所有content中的数据。@Results注解提供了数据库表的字段与Model的属性的映射关系。下方指定了表字段"id"与"contentId"对应，字段名"create_time"与“createTime”属性相对应，而未指定的就是字段名与属性名一致。

queryById就是带有条件的查询方法了。其参数就是查询的条件。通过@Param注解进行条件与参数的绑定。具体代码如下所示。

5、创建测试用的Controller

为了简便期间，我们就不创建DAO层了，就直接在Controller中来调用上述接口中的方法即可。下方这个MyBatisTestController就是我们创建的用来测试上述操作的测试控制器。当然我们将该控制器声明为@RestController以便我们对其进行测试。然后使用@Autowired注解注入ContentMapper类型的对象，我们可以通过该对象来操作上述接口中所对应的方法。queryContentById方法，对应的是contentMapper中的queryById方法，queryAll方法对应的是Mapper中的query方法，具体代码如下所示。

下方我们直接将获取到的Model或者Model数组进行返回，在Spring Boot中，直接返回的Model会被映射成相应的JSON格式的数据的，这个稍后我们会直观的看到。

6、访问上述路由

我们先访问/queryContentById这个路由，再访问这个路由时，我们要提供一个参数contentId。也就是用来查询数据的条件。下方截图中的结果就是我们对contentId=6的条件查询的结果。

接下来我们来查询一下所有的数据，也就是访问queryAll路由。具体结果如下所示。

二、Thymeleaf模板的引入与使用

上面引入MyBatis算是妥了，以后的博客中还会继续对MyBatis的相关东西进行介绍。接下来我们就引入Thymeleaf模板，然后显示我们使用MyBatis读取到的相关数据。下方我们就来看一下在Spring Boot中是如何整合Thymeleaf模板的

1、配置pom.xml文件

在pom.xml中添加Thymeleaf在Spring Boot中相关的库，具体如下所示：


            
     
     
      org.springframework.boot
      
     
      spring-boot-starter-thymeleaf
      
     
      1.5.2.RELEASE

2、创建模板使用的Controller

紧接着，我们就来创建模板所对应的Controller，如下所示。下方我们依然使用注入的ContentMapper对象来获取数据。然后将获取的数据添加到model对象中，在添加时，我们会为该数据对象指定一个参数名称，如下方的"contents"。然后返回模板页面即可，下方的“display”就是我们模板页面所在的文件名称。

3、创建模板页面

然后我们就该创建模板页面了，也就是此处的display.html。下方就是display.html页面的所有内容。其中我们为数据的显示添加了一些css样式，并使用CDN引入了目前最新版本的Bootstrap。下方带有“th:”前缀的属性就是Thymeleaf模板的标签。

首先使用“th:if="${not #lists.isEmpty(contents)}"”来判断contents属性所对应的值是否为空，如果不为空，则执行标签中的内容。然后使用th:if="${not #lists.isEmpty(contents)}"来遍历contents中的内容，类似于while循环。通过th:each="content:${contents}"取出每一项的数据。通过th:text="${content.contentId}"取出某个属性的值。具体内容如下所示。


    
    
    
    Content    
            
      
      
       CotentId
      
 
      
       Title
      
 
      
       Cotent
      
 
      
       UserId
      
 
      
       CreateTime

4、访问上述路由

创建完展示用的模板后，接下来我们要做的事情就是要对其进行访问了。下方截图就是我们最终的访问结果。

本篇博客就先到这儿吧，以后还会使用到MyBatis的其他内容，到时候再细说。

本篇博客所涉及代码的github地址：https://github.com/lizelu/SpringBootProject