在SpringBoot集成MyBatis，需要的依赖为：
implementation("org.mybatis.spring.boot:mybatis-spring-boot-starter:2.1.1")
该依赖会：
- 自动检测已有的
DataSource - 使用
DataSource创建并注册一个SqlSessionFactory实例 - 从
SqlSessionFactory中获取并注册一个SqlSessionTemplate的实例 - 自动扫描mapper，与
SqlSessionTemplate连接并注入到Spring context中
基于注解 Link to heading
只需定义一个普通接口，并使用@Mapper注解，然后通过@Insert, @Delete, @Update, @Select等MyBatis提供的注解完成增删改查等操作：
@Mapper
public interface PlayerMapper {
@Insert("insert into player(name, team, join_at) values (#{name}, #{team}, #{joinAt})")
@Options(useGeneratedKeys = true, keyProperty = "id")
int insert(Player player);
@Delete("delete from player where id = #{id}")
int delete(@Param("id") Integer id);
@Update("update player set name = #{name}, team = #{team}, join_at = #{joinAt} where id = #{id}")
int update(Player player);
@Select("select id, name, team, join_at from player where id = #{id}")
Player findById(@Param("id") Integer id);
}
注意：
insert的时候希望能返回自动生成的主键ID，需要使用@Options(useGeneratedKeys = true, keyProperty = "id")，其中，keyProperty表示数据库对应实体的ID属性。
然后在需要使用的地方注入PlayerMapper即可。
示例代码见：springboot-mybatis-annotation
基于XML配置 Link to heading
既需要定义使用@Mapper注解的接口类，也需要基于XML的mapper文件。
@Mapper
public interface PlayerMapper {
int insert(Player player);
int delete(@Param("id") Integer id);
int update(Player player);
Player findById(@Param("id") Integer id);
}
<mapper namespace="org.nkcoder.mybatis.xml.mapper.PlayerMapper">
<sql id="columns">id, name, team, join_at</sql>
<insert id="insert" useGeneratedKeys="true" keyProperty="id" parameterType="Player">
insert into player (`name`, `team`, `join_at`)
values (#{name}, #{team}, #{joinAt})
</insert>
<delete id="delete">
delete
from player
where id = #{id}
</delete>
</mapper>
其中，
namespace表示对应的mapper接口，接口中的方法签名与XML文件语句块的id要相同。对于数据库自增ID，插入时如需在对应实体类返回ID，需添加useGeneratedKeys="true" keyProperty="id"。
另外，需要增加MyBatis的相关配置：
mybatis:
configuration:
map-underscore-to-camel-case: true
default-fetch-size: 100
default-statement-timeout: 30
mapper-locations: classpath:mybatis/mapper/*.xml
type-aliases-package: org.nkcoder.mybatis.xml.entity;
map-underscore-to-camel-case: 数据库字段到实体属性映射规则，即下划线到驼峰mapper-locations: 指定mapper的xml文件位置type-aliases-package: 类型别名的package，mapper的xml文件中，参数或返回类型不用使用全路径类名
示例代码见：springboot-mybatis-xml
测试 Link to heading
测试的依赖为：
testImplementation('org.mybatis.spring.boot:mybatis-spring-boot-starter-test:2.1.1') {
exclude group: 'org.junit.vintage', module: 'junit-vintage-engine'
}
runtime 'com.h2database:h2'
它提供了@MybatisTest注解，默认配置：
SqlSessionFactory、SqlSessionTemplate以及Mapper接口- 嵌入式的内存数据库
- 开启事务，测试结束回滚
@ExtendWith(SpringExtension.class)
@MybatisTest
@AutoConfigureTestDatabase
public class PlayerMapperTest {
@Autowired
private PlayerMapper playerMapper;
@Test
public void shouldInsertPlayer() {
Player player = new Player("dfa", "LA", LocalDate.now());
int rowInserted = playerMapper.insert(player);
assertThat(rowInserted).isEqualTo(1);
assertThat(player.getId()).isGreaterThanOrEqualTo(1);
}
// other tests
}
完整的示例代码见项目：github-springboot-mybatis-annotation以及github-springboot-mybatis-xml.