Skip to content

使用 MyBatis 原生功能

我们使用 MyBatis-Flex 作为 MyBatis 的增强框架进行代码开发,并不会影响原有的 MyBatis 的任何功能。

使用 @Select 等 MyBatis 原生注解

MyBatis 提供了 @Insert@Delete@Update@Select 4 个注解,用于对 Mapper 的方法进行配置,用于原生编写原生 SQL 进行增删改查, 在 MyBatis-Flex 我们一样可以使用这些注解。例如:

java
public interface MyAccountMapper extends BaseMapper<Account> {

    @Select("select * from tb_account where id = #{id}")
    Account selectById(@Param("id") Object id);
}

@Insert@Delete@Update 等注解也是一样的,也就是说,原有的 MyBatis 功能如何使用,在 MyBatis-Flex 就如何使用。

@InsertProvider@DeleteProvider@UpdateProvider@SelectProvider 等还是和原生 MyBatis 一样的用法。

使用 xml 的方式

在开始使用 xml 之前,我们需要添加如下配置,告知 mybatis 的 xml 存放路径。

yaml
mybatis-flex:
  mapper-locations:
    - classpath*:/mapper/*.xml

配置完成后,我们就可以编写自己的 xml 和 mapper 代码了,如下所示:

mapper:

java
public interface MyAccountMapper extends BaseMapper<Account> {
    Account selectByName(@Param("name") String name);
}

xml:

xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="com.test.mapper.MyAccountMapper">

    <!-- selectByName -->
    <select id="selectByName" resultType="com.test.model.Account">
        select * from `tb_account` where `user_name` = #{name}
    </select>

</mapper>

XML 分页^ v1.5.5

XML 分页是 MyBatis-Flex 在 v1.5.5 开始提供的一个 XML 分页解决方案,方便用户在使用 XML 时,对数据进行分页查询。

示例代码如下:

java
QueryWrapper qw = QueryWrapper.create()
    .where(Account::getAge).eq(18)
    .and(Account::getId).ge(0);

Page<Account> accountPage = ccountMapper
    .xmlPaginate("selectByName", Page.of(1, 10), qw);

参数 selectByName 指的是在 XML 里定义的 select 节点的 id 的名称。selectByName 也可以全写为: com.mybatisflex.test.mapper.AccountMapper.selectByName

此时,需要也在 XML 里定义名称为 selectByName_COUNT 的 select 节点,用于查询数据总量。

XML 代码如下:

xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="com.mybatisflex.test.mapper.AccountMapper">

    <!-- selectByName -->
    <select id="selectByName" resultType="com.mybatisflex.test.model.Account">
        select * from `tb_account` ${qwSql} limit ${pageOffset}, ${pageSize}
    </select>

    <select id="selectByName_COUNT" resultType="long">
        select count(*) from `tb_account` ${qwSql}
    </select>

</mapper>

其执行的 SQL 如下:

sql
-- 查询数据量
select count(*) from `tb_account`  WHERE `age` = 18 AND `id` >= 0

-- 查询数据
select * from `tb_account`  WHERE `age` = 18 AND `id` >= 0 limit 0, 10

XML 参数解释:

  • ${qwSql}: 传入的 QueryWrapper 生成的 where 部分的 SQL,带有 "where" 关键字
  • ${pageOffset}: sql offset 的值
  • ${pageSize}: 需要查询的数据量
  • ${pageNumber}: 当前的页码
  • ${dbType}: 当前用户配置的数据库类型,用户切换数据源也有可能造成数据库类型发生变化。我们可以通过不同的 dbType 来编写不同的 SQL,以适配不同的数据库类型。

其他自定义参数:

java
QueryWrapper qw = QueryWrapper.create()
    .where(Account::getAge).eq(18)
    .and(Account::getId).ge(0);

//设置其他参数
Map<String,Object> otherParams = new HashMap<>();
otherParams.put("otherName", "michael");

Page<Account> accountPage = ccountMapper
    .xmlPaginate("selectByName", Page.of(1, 10), qw, otherParams);

此时,我们在 XML 中可以直接使用自定义的参数,例如:

xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="com.mybatisflex.test.mapper.AccountMapper">

    <!-- selectByName -->
    <select id="selectByName" resultType="com.mybatisflex.test.model.Account">
        select * from `tb_account` ${qwSql}
        and user_name = #{otherName}
        limit ${pageOffset}, ${pageSize}
    </select>

    <select id="selectByName_COUNT" resultType="long">
        select count(*) from `tb_account` ${qwSql}
        and user_name = #{otherName}
    </select>

</mapper>