MyBatis-Mate: Advanced Features and Usage Guide for MyBatis-Plus in Java Backend Development

MyBatis-Mate is an official extension for MyBatis‑Plus that provides enterprise‑grade features such as dictionary binding, field encryption, data masking, dynamic DDL generation, multi‑datasource sharding, data‑scope filtering and SQL performance logging.

To use it, add the starter dependency:

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-mate-starter</artifactId>
    <version>1.0.8</version>
</dependency>

Key capabilities include:

Dictionary binding with @FieldDict to map code values to text.

Field encryption via @FieldEncrypt (e.g., PBEWithMD5AndDES).

Data masking using @FieldSensitive with built‑in SensitiveType strategies.

Automatic DDL maintenance through IDdl implementations for MySQL and PostgreSQL.

Dynamic multi‑datasource sharding and master‑slave switching using @Sharding and custom strategies.

Distributed transaction logging with a configurable PerformanceInterceptor.

Data‑scope filtering via @DataScope and a custom IDataScopeProvider.

Example of a mapper using dictionary binding and encryption:

@Mapper
public interface UserMapper extends BaseMapper<User> {
    @FieldDict(type = "user_sex", target = "sexText")
    @FieldEncrypt(algorithm = Algorithm.PBEWithMD5AndDES)
    User selectById(Long id);
}

Configuration in application.yml can enable health checks, primary datasource selection and define datasource groups for sharding.

Overall, MyBatis‑Mate streamlines backend development by reducing boilerplate and providing ready‑to‑use data handling utilities.