Spring Boot 整合 MyBatis

最近项目缘由可能会继续开始使用MyBatis，已经习惯于spring-data的风格，再回头看xml的映射配置总以为不是特别舒服，接口定义与映射离散在不一样文件中，使得阅读起来并非特别方便。

Spring中整合MyBatis就很少说了，最近大量使用Spring Boot，所以整理一下Spring Boot中整合MyBatis的步骤。搜了一下Spring Boot整合MyBatis的文章，方法都比较老，比较繁琐。查了一下文档，实际已经支持较为简单的整合与使用。下面就来详细介绍如何在Spring Boot中整合MyBatis，并经过注解方式实现映射。

整合MyBatis

• 新建Spring Boot项目，或以Chapter1为基础来操做

• pom.xml中引入依赖

  • 这里用到spring-boot-starter基础和spring-boot-starter-test用来作单元测试验证数据访问

  • 引入链接mysql的必要依赖mysql-connector-java

  • 引入整合MyBatis的核心依赖mybatis-spring-boot-starter

  • 这里不引入spring-boot-starter-jdbc依赖，是因为mybatis-spring-boot-starter中已经包含了此依赖

<parent>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-parent</artifactId>
	<version>1.3.2.RELEASE</version>
	<relativePath/> <!-- lookup parent from repository -->
</parent>

<dependencies>

	<dependency>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter</artifactId>
	</dependency>

	<dependency>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-test</artifactId>
		<scope>test</scope>
	</dependency>

	<dependency>
		<groupId>org.mybatis.spring.boot</groupId>
		<artifactId>mybatis-spring-boot-starter</artifactId>
		<version>1.1.1</version>
	</dependency>

	<dependency>
		<groupId>mysql</groupId>
		<artifactId>mysql-connector-java</artifactId>
		<version>5.1.21</version>
	</dependency>

</dependencies>

• 同以前介绍的使用jdbc和spring-data链接数据库同样，在application.properties中配置mysql的链接配置

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

同其余Spring Boot工程同样，简单且简洁的的完成了基本配置，下面看看如何在这个基础下轻松方便的使用MyBatis访问数据库。

使用MyBatis

• 在Mysql中建立User表，包含id(BIGINT)、name(INT)、age(VARCHAR)字段。同时，建立映射对象User

public class User {

    private Long id;
    private String name;
    private Integer age;

    // 省略getter和setter

}

• 建立User映射的操做UserMapper，为了后续单元测试验证，实现插入和查询操做

@Mapper
public interface UserMapper {

    @Select("SELECT * FROM USER WHERE NAME = #{name}")
    User findByName(@Param("name") String name);

    @Insert("INSERT INTO USER(NAME, AGE) VALUES(#{name}, #{age})")
    int insert(@Param("name") String name, @Param("age") Integer age);

}

• 建立Spring Boot主类

@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }

}

• 建立单元测试

  • 测试逻辑：插入一条name=AAA，age=20的记录，而后根据name=AAA查询，并判断age是否为20
  • 测试结束回滚数据，保证测试单元每次运行的数据环境独立

@RunWith(SpringJUnit4ClassRunner.class)
@SpringApplicationConfiguration(classes = Application.class)
public class ApplicationTests {

    @Autowired
    private UserMapper userMapper;

    @Test
    @Rollback
    public void findByName() throws Exception {
        userMapper.insert("AAA", 20);
        User u = userMapper.findByName("AAA");
        Assert.assertEquals(20, u.getAge().intValue());
    }

}