SpringBoot整合Mybatis实战教程

"这篇文档是关于如何在Spring Boot项目中集成MyBatis的教程，其中使用了Thymeleaf作为模板引擎。" 在Spring Boot应用中整合MyBatis框架可以帮助我们构建高效、灵活的数据库操作层。以下是整合过程的关键步骤和相关知识点： ### 1. 创建项目 首先，我们需要一个基于Spring Boot的新项目。通过Spring Initializr或IDE中的相关功能，我们可以选择Spring Boot的起步依赖，包括`Web`和`Mybatis`。这将为我们生成一个包含基本结构的项目。 ### 2. 添加依赖 在`pom.xml`文件中，我们需要引入Spring Boot对MyBatis的支持以及相关的依赖。例如，添加以下内容： ```xml <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>2.2.2</version> </dependency> ``` 同时，确保`spring-boot-starter-web`和`spring-boot-starter-thymeleaf`也已添加，以便使用Thymeleaf模板引擎。 ### 3. 配置文件 在`application.properties`或`application.yml`中，我们需要配置数据源和MyBatis的相关属性。例如： ```properties # application.properties 示例 spring.datasource.url=jdbc:mysql://localhost:3306/test spring.datasource.username=root spring.datasource.password=root spring.datasource.driver-class-name=com.mysql.jdbc.Driver mybatis.mapper-locations=classpath:mapper/*.xml mybatis.type-aliases-package=com.example.entity ``` 这里，我们设置了数据库连接的URL、用户名、密码和驱动类名，以及MyBatis的映射器文件位置和类型别名包。 ### 4. 定义实体类（Entities） 创建与数据库表对应的Java实体类。例如： ```java package com.example.entity; public class User { private Long id; private String name; // 省略getter和setter方法 } ``` ### 5. 编写Mapper接口 定义一个Mapper接口，继承自`Mapper`基类，并指定实体类： ```java package com.example.mapper; import com.example.entity.User; import org.apache.ibatis.annotations.Select; import org.springframework.stereotype.Repository; @Repository public interface UserMapper extends Mapper<User> { @Select("SELECT * FROM user WHERE id = #{id}") User getUserById(Long id); } ``` 这里，我们定义了一个查询用户的方法，并使用注解`@Select`来指定SQL语句。 ### 6. 映射文件（Mapper XML） 创建对应的XML映射文件`userMapper.xml`，位于`src/main/resources/mapper`目录下，定义SQL语句： ```xml <mapper namespace="com.example.mapper.UserMapper"> <select id="getUserById" resultType="com.example.entity.User"> SELECT * FROM user WHERE id = #{id} </select> </mapper> ``` 确保命名空间与Mapper接口完全一致。 ### 7. Service和Controller 创建服务层（Service）和控制器（Controller）以处理业务逻辑和HTTP请求。在Service中注入Mapper，然后调用其方法。在Controller中，使用Thymeleaf模板引擎来展示结果。 ### 8. 测试 完成上述步骤后，项目应该能够正常启动。通过编写单元测试或使用`curl`命令测试API，确保数据库操作正常工作。 整合Spring Boot和MyBatis提供了简洁的配置和强大的数据库操作能力，结合Thymeleaf模板引擎，可以快速构建出健壮的Web应用。这个教程涵盖了从项目初始化到整合MyBatis的全过程，对于初学者来说是一个很好的实践示例。