探索MyBatis-Plus的高阶用法

引言

MyBatis-Plus 是 MyBatis 的增强工具包，提供了许多方便快捷的功能来简化开发，提高效率。除了基本的 CRUD 操作外，MyBatis-Plus 还提供了一些高级功能，本文将探讨 MyBatis-Plus 的高阶用法，帮助开发者更好地利用该工具包。

1. 动态表名和字段

MyBatis-Plus 支持动态表名和字段，这在一些特殊场景下非常有用，比如多租户系统或者动态数据源切换。通过注解 @TableName 和 @TableField 可以动态指定表名和字段名。

@TableName("user_${dynamicValue}")
public class User {@TableField(value = "name_${dynamicValue}")private String name;
}

2. 自定义全局操作

MyBatis-Plus 允许自定义全局操作，比如自定义全局的查询条件、插入前操作、更新前操作等。通过实现 com.baomidou.mybatisplus.core.injector.ISqlInjector 接口可以实现自定义 SQL 注入器，通过实现 com.baomidou.mybatisplus.core.handlers.MetaObjectHandler 接口可以实现字段自动填充等。

@Component
public class CustomMetaObjectHandler implements MetaObjectHandler {@Overridepublic void insertFill(MetaObject metaObject) {this.strictInsertFill(metaObject, "createTime", LocalDateTime::now, LocalDateTime.class);}@Overridepublic void updateFill(MetaObject metaObject) {this.strictUpdateFill(metaObject, "updateTime", LocalDateTime::now, LocalDateTime.class);}
}

3. 自动分页

MyBatis-Plus 提供了自动分页的功能，可以自动根据查询条件进行分页，无需手动编写分页 SQL。只需在查询条件中添加分页参数即可。

Page<User> page = new Page<>(1, 10);
userMapper.selectPage(page, null);

4. 逻辑删除

MyBatis-Plus 支持逻辑删除，通过注解 @TableLogic 可以指定逻辑删除字段，并在查询时自动过滤掉已被逻辑删除的记录。

@Configuration
@MapperScan("com.example.mapper")
public class MybatisPlusConfig {@Beanpublic MybatisPlusInterceptor mybatisPlusInterceptor() {MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();interceptor.addInnerInterceptor(new LogicSqlInjector());interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));return interceptor;}@Beanpublic ISqlInjector sqlInjector() {return new LogicSqlInjector();}
}

@TableLogic
@TableField(value = "is_deleted")
private Integer deleted;

// 执行逻辑删除
userMapper.deleteById(userId);// 查询用户列表，自动过滤已被逻辑删除的记录
List<User> userList = userMapper.selectList(null);

5. 实现多租户系统

在多租户系统中，不同的租户需要访问不同的数据，但数据结构相同。通过动态表名可以很方便地实现多租户数据的隔离存储。

@TableName("user_${tenantId}")
public class User {@TableField(value = "name")private String name;
}

根据不同的租户（tenantId），用户数据将存储在不同的表中，实现了多租户数据的隔离存储。

6. 动态数据源切换

在一些特殊的场景中，需要根据不同的条件切换数据源。通过动态表名和字段可以很方便地实现动态数据源切换。

@TableName("user_${dataSource}")
public class User {@TableField(value = "name_${dynamicValue}")private String name;
}

7. 数据权限控制

在一些需要进行数据权限控制的系统中，不同的用户可能只能访问部分数据。通过动态表名和字段可以很方便地实现数据权限控制。

@TableName("user_${roleId}")
public class User {@TableField(value = "name_${dynamicValue}")private String name;
}

根据不同的用户角色（roleId），用户数据将存储在不同的表中，并且字段名也会动态变化，实现数据权限控制的需求。

8. 分表分库

在数据量较大的系统中，为了提高性能和扩展性，可能会采用分表分库的方式来存储数据。通过动态表名和字段可以很方便地实现分表分库。

@TableName("user_${shardingValue}")
public class User {@TableId(type = IdType.AUTO)private Long id;private String username;private Integer age;// 其他字段...
}

分库分表策略配置

@Configuration
public class MybatisPlusConfig {@Beanpublic MybatisPlusInterceptor mybatisPlusInterceptor() {MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();// 配置分页插件interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));// 配置分片插件interceptor.addInnerInterceptor(new DynamicTableNameInnerInterceptor());return interceptor;}@Beanpublic DynamicTableNameInnerInterceptor dynamicTableNameInnerInterceptor() {return new DynamicTableNameInnerInterceptor();}
}

分库分表策略实现

public class DynamicTableNameInnerInterceptor extends InnerInterceptor {@Overridepublic void beforeQuery(Executor executor, MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql) throws SQLException {if (parameter instanceof Map) {Map<?, ?> paramMap = (Map<?, ?>) parameter;ShardingValue shardingValue = (ShardingValue) paramMap.get("shardingValue");if (shardingValue != null) {String tableName = "user_" + shardingValue.getValue() % 2; // 根据分片值计算表名String sql = boundSql.getSql().replaceFirst("user", tableName); // 替换原始 SQL 中的表名ReflectionUtils.setField(boundSql, "sql", sql); // 修改 BoundSql 中的 SQL}}}
}

9. 动态 SQL

在一些复杂的业务场景中，可能需要根据不同的条件动态生成 SQL，比如动态拼接 WHERE 子句、动态排序等。MyBatis-Plus 提供了方便的 API 来实现动态 SQL。

QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.eq("status", status);
if (StringUtils.isNotBlank(keyword)) {wrapper.like("name", keyword);
}
wrapper.orderByDesc("create_time");
List<User> userList = userMapper.selectList(wrapper);

10. 乐观锁

在并发场景下，为了保证数据的一致性，可能会使用乐观锁机制来控制并发访问。MyBatis-Plus 提供了乐观锁的支持，通过 @Version 注解标注实体类中的版本字段即可实现乐观锁功能。

@Version
@TableField(value = "version")
private Integer version;

11. 逻辑分页

在一些特殊的场景中，可能需要进行复杂的分页操作，比如根据某个字段的范围进行分页查询。MyBatis-Plus 提供了逻辑分页的功能，通过 last() 方法可以实现自定义的分页逻辑。根据年龄大于等于 18 并按照创建时间降序排列的条件进行分页查询

IPage<User> page = new Page<>(1, 10);
userMapper.selectPage(page, Wrappers.<User>lambdaQuery().ge(User::getAge, 18).orderByDesc(User::getCreateTime).last("limit 10"));

12. 代码生成器

public class CodeGenerator {public static void main(String[] args) {AutoGenerator generator = new AutoGenerator();// 配置数据源、包配置、策略配置等generator.execute();}
}