tk.mybatis如何扩展自己的通用mapper

tk.mybatis是一个基于MyBatis的轻量级通用Mapper框架，可以帮助开发者快速开发通用的数据库操作，省去大部分重复编写CRUD方法的工作。如果需要扩展自己的通用Mapper，我们需要遵循以下步骤：

1. 自定义接口及Mapper文件

我们可以通过继承通用Mapper提供的BaseMapper接口，再定义自己的Mapper接口，例如UserMapper，可以按照如下方式：

public interface UserMapper extends BaseMapper<User> {
    // 自定义方法
}

同时也需要针对该Mapper定义对应的Mapper文件UserMapper.xml，并将其与UserMapper接口关联：

<mapper namespace="com.example.mapper.UserMapper">

</mapper>

1. 添加自定义SQL语句

在该Mapper文件中，我们可以添加自己的SQL语句来满足特殊的需求。举个例子，假设我们需要按照用户ID批量删除用户，则可以添加如下SQL语句：

<delete id="deleteByIdList" parameterType="java.util.List">
    delete from user where id in
    <foreach collection="list" item="item" open="(" separator="," close=")">
        #{item}
    </foreach>
</delete>

其中，deleteByIdList是该SQL的唯一ID，parameterType指定该SQL的参数类型，这里为List类型。利用foreach标签可以遍历ID列表并将其作为SQL语句参数，完成批量删除操作。

1. 绑定自定义SQL语句到Mapper方法

接下来，我们需要将自定义的SQL语句与Mapper方法进行绑定，以对外提供扩展方法。假设我们使用上述的deleteByIdList语句，可以在UserMapper接口中添加如下方法：

public interface UserMapper extends BaseMapper<User> {
    // 自定义方法
    void deleteByIdList(List<Integer> idList);
}

同时在UserMapper.xml文件中对该方法进行SQL语句的关联：

<!--绑定自定义SQL到Mapper方法-->
<select id="deleteByIdList" parameterType="java.util.List" statementType="STATEMENT">
    <include refid="com.example.mapper.UserMapper.deleteByIdList"/>
</select>

此处使用include标签引用UserMapper.deleteByIdList方法，并将其关联到SQL语句的ID deleteByIdList中。需要注意的是，由于该SQL语句为删除操作，因此需要指定statementType为STATEMENT。

绑定后我们可以在需要使用批量删除的地方直接使用该方法了：

@Autowired
private UserMapper userMapper;

@Test
public void testDeleteByIdList() {
    List<Integer> idList = Arrays.asList(1, 2, 3, 4, 5);
    userMapper.deleteByIdList(idList);
}

1. 注册自定义Mapper

最后一步是将我们自定义的Mapper注册到tk.mybatis的Mapper扫描器中，以便框架能够自动扫描并管理它们。我们需要在MyBatis配置文件中配置MapperScan注解，指定自己的Mapper接口包路径，例如：

<mybatis-spring:scan base-package="com.example.mapper" />

这样就完成了自定义Mapper的扩展。除了批量删除之外，我们可以添加更多自定义的SQL语句和Mapper方法，根据业务需要进行扩展。

除了以上步骤，我们也可以利用MyBatis的拦截器机制来扩展通用Mapper。例如，可以利用PageHelper插件为通用Mapper添加分页功能。