SpringBoot与mybatis整合实战指南

"这篇文章主要讲解了如何在SpringBoot项目中集成Mybatis的实践步骤，包括引入mybatis-spring-boot-starter依赖、配置数据源、使用注解和XML映射文件等。" 在SpringBoot中集成Mybatis是一个常见的操作，使得我们可以利用Mybatis强大的SQL映射功能来处理数据库操作。下面将详细解释这个过程： 1. 使用mybatis-spring-boot-starter `mybatis-spring-boot-starter`是Mybatis为SpringBoot提供的快速启动器，它简化了Mybatis在SpringBoot项目中的配置。在`pom.xml`中添加如下依赖： ```xml <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>1.0.0</version> </dependency> ``` 这个依赖包含了Mybatis与Spring整合所需的所有组件。 2. 配置数据源 在`application.properties`中，可以设置数据源的相关属性，例如指定初始化数据库时执行的SQL文件： ```properties spring.datasource.schema=import.sql ``` 这会指示SpringBoot在启动时加载`import.sql`文件中的SQL语句，用于初始化数据库结构或数据。 3. 使用注解 在SpringBoot应用类上使用`@MapperScan`注解扫描Mybatis的Mapper接口，例如： ```java @SpringBootApplication @MapperScan("sample.mybatis.mapper") public class SampleMybatisApplication implements CommandLineRunner { // ... } ``` 这样，所有在指定包下的Mapper接口都会被自动注册，可以直接通过@Autowired注入到需要的地方。比如，这里注入了一个名为`CityMapper`的接口： ```java @Autowired private CityMapper cityMapper; ``` 在接口中定义方法，这些方法将对应于Mybatis的SQL映射语句。 4. XML映射文件 Mybatis的SQL映射通常通过XML文件进行配置。创建一个名为`mybatis-config.xml`的配置文件，指定Mybatis的配置以及类型别名： ```xml <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"> <configuration> <typeAliases> <package name="sample.mybatis.domain"/> </typeAliases> <!-- 其他配置 --> </configuration> ``` 在`typeAliases`中指定的包下，Mybatis会自动为所有公共类生成别名，这样在编写Mapper接口时就可以直接使用类名而无需全限定名。 5. 运行示例 在`SampleMybatisApplication`中实现`CommandLineRunner`接口，重写`run`方法，可以在这里调用Mapper接口的方法，例如： ```java @Override public void run(String... args) throws Exception { System.out.println(this.cityMapper.findByState("CA")); } ``` 当应用程序启动时，`run`方法会被调用，执行查询并打印结果。 通过以上步骤，你就成功地在SpringBoot项目中集成了Mybatis，可以开始编写和执行SQL语句了。记得在Mapper接口中定义与XML文件中SQL映射相匹配的方法，并确保配置正确，这样才能正常进行数据库操作。