在Spring Boot中整合MyBatis

第1步：添加依赖：
在pom.xml文件中添加MyBatis和MySQL JDBC驱动的依赖。如果你使用的是Maven，配置如下：

   <dependencies>
       <!-- Spring Boot Starter Data JPA 可能已经包含了 spring-boot-starter-data-jdbc -->
       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-data-jdbc</artifactId>
       </dependency>

       <!-- MyBatis 以及 MyBatis-Spring 的依赖 -->
       <dependency>
           <groupId>org.mybatis.spring.boot</groupId>
           <artifactId>mybatis-spring-boot-starter</artifactId>
           <version>2.2.0</version> <!-- 根据实际情况选择最新版本 -->
       </dependency>

       <!-- MySQL JDBC Driver -->
       <dependency>
           <groupId>mysql</groupId>
           <artifactId>mysql-connector-java</artifactId>
           <scope>runtime</scope>
       </dependency>
   </dependencies>

第2步：配置数据源 DataSource：
在application.properties或application.yml文件中配置数据库连接信息：

   spring.datasource.url=jdbc:mysql://localhost:3306/mydatabase
   spring.datasource.username=root
   spring.datasource.password=mypassword
   spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

第3步：（可选）配置MyBatis全局配置文件：
如果你需要自定义MyBatis的全局配置，可以创建一个mybatis-config.xml并将其放在类路径下，然后在Spring Boot配置中指定该文件的位置：

   mybatis.config-location=classpath:mybatis-config.xml

第4步：编写实体类（POJOs）：

第5步：编写Mapper接口及映射文件：
创建一个StudentsMapper.java接口，并声明对应的方法。
创建一个StudentsMapper.xml 文件放在src/main/resources/mapper/目录下。

第6步：在SpringBoot主类上或者单独的配置类上使用@MapperScan注解来自动扫描并注入Mapper接口。
主类

   @SpringBootApplication
   @MapperScan("com.example.myapp.mapper") // 替换为你的Mapper接口所在的包名
   public class MyAppApplication {
       public static void main(String[] args) {
           SpringApplication.run(MyAppApplication.class, args);
       }
   }

单独的配置类

import org.apache.ibatis.session.SqlSessionFactory;
import org.mybatis.spring.SqlSessionFactoryBean;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.io.support.PathMatchingResourcePatternResolver;

import javax.sql.DataSource;
import java.util.Properties;

@Configuration
@MapperScan(basePackages = "com.example.myapp.mapper") // 指定Mapper接口所在的包名
public class MyBatisConfig {

    @Autowired
    private DataSource dataSource; // 注入数据源

    @Bean
    public SqlSessionFactory sqlSessionFactory() throws Exception {
        SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();
        factoryBean.setDataSource(dataSource);

        // 如果有全局配置文件或映射文件路径需要指定，可以添加如下配置
        factoryBean.setConfigLocation(new ClassPathResource("mybatis-config.xml"));
        factoryBean.setMapperLocations(new PathMatchingResourcePatternResolver().getResources("classpath:mapper/*.xml"));

        // 添加自定义属性等
        Properties properties = new Properties();
        properties.setProperty("mybatis.configuration.mapUnderscoreToCamelCase", "true");
        factoryBean.setConfigurationProperties(properties);

        return factoryBean.getObject();
    }

    // 可选：配置事务管理器
    // @Bean
    // public PlatformTransactionManager transactionManager(SqlSessionFactory sqlSessionFactory) {
    //     return new SqlSessionFactoryTransactionManager(sqlSessionFactory);
    // }
}

@MapperScan注解则会告诉Spring去com.example.myapp.mapper这个包及其子包下查找所有带有@Mapper注解的接口，并将它们注册为Spring Bean。

必须要加 @Mapper 吗？
不是绝对必要，但是，为了更好的可读性和明确性，以及在代码重构时减少错误的可能性，强烈建议在所有的Mapper接口上都使用@Mapper注解。此外，在一些情况下，如单元测试中直接实例化Mapper接口时，@Mapper注解是必须的，因为它可以让Spring通过注解处理器自动处理依赖注入。

如果不使用@Mapper注解，要满足如下2个条件
1、 需要确保不带@Mapper注解的Mapper接口位于@MapperScan指定的包及其子包下。
例如，如果@MapperScan(basePackages = "com.example.project.mapper")，那么所有的非注解式Mapper接口必须在这个包或者其子包内，如com.example.project.mapper.StudentMapper。
2、MyBatis会根据接口的全限定类名来查找对应的XML映射文件。
例如，如果你有一个名为com.example.project.mapper.StudentMapper的Mapper接口，那么其对应的XML映射文件应该如下：

<mapper namespace="com.example.project.mapper.StudentMapper">
    <!-- SQL语句和结果映射定义 -->
    <select id="selectStudentById" resultType="com.example.project.entity.Student">
        SELECT * FROM students WHERE id = #{id}
    </select>
    
    <!-- 其他SQL语句定义... -->
</mapper>

在这个例子中，namespace属性值为com.example.project.mapper.StudentMapper，与Java接口的全限定类名完全一致。通过这种方式，MyBatis能够正确地将XML中的SQL语句和结果映射与Mapper接口的方法对应起来。即使在不使用@Mapper注解的情况下，只要保证接口名称、XML映射文件的命名以及namespace属性的设置遵循上述规则，MyBatis也能正确识别并处理这些接口方法。