Mybatis-Flex：Mybatis-plus的增强版(使用与了解)

Mybatis-Flex是Mybatis的增强版，它在保留Mybatis原有的优秀特性的基础上，进行了一些改进和扩展，以提供更加灵活和强大的功能。下面将详细介绍Mybatis-Flex的主要特点和优势，以及如何将其集成到现有项目中。

传送门：主页太空眼睛.-CSDN博客

一、Mybatis-Flex的主要特点

1. 灵活性：Mybatis-Flex提供了更加灵活的映射和查询功能，允许你使用更加自然的方式编写SQL语句，而无需遵循严格的映射规则。
2. 性能优化：Mybatis-Flex对查询性能进行了优化，通过智能缓存和预编译SQL语句等技术，提高了查询的执行效率。
3. 插件化架构：Mybatis-Flex采用了插件化架构，你可以通过编写插件来自定义SQL的生成和执行过程，从而实现更加灵活的扩展功能。
4. 易于维护：Mybatis-Flex的代码结构清晰，易于维护。同时，它还提供了丰富的文档和示例，方便你快速上手和解决问题。
   二、集成Mybatis-Flex到现有项目
   要将Mybatis-Flex集成到现有项目中，你需要按照以下步骤进行操作：
5. 添加Mybatis-Flex依赖：在项目的构建工具（如Maven或Gradle）中添加Mybatis-Flex的依赖项，以便将相关库引入到项目中。
6. 配置数据源：配置项目的数据源信息，包括数据库连接信息、驱动类等。
7. 配置Mybatis-Flex配置文件：创建一个Mybatis-Flex的配置文件，指定数据源、事务管理器等信息。同时，在该文件中配置你要使用的Mapper接口和映射文件。
8. 编写Mapper接口和映射文件：根据业务需求编写Mapper接口和对应的映射文件。在Mapper接口中声明需要执行的SQL语句，映射文件中定义SQL语句的具体实现。
9. 编写Service和Controller层代码：在Service层中调用Mapper接口执行数据库操作，并在Controller层处理业务逻辑和与前端交互的代码。
10. 运行项目：启动项目，进行测试以确保Mybatis-Flex正常工作。你可以编写单元测试或集成测试来验证功能的正确性。
    三、注意事项
11. 在使用Mybatis-Flex时，请确保你的项目已经正确引入了相关的依赖项。
12. 在编写SQL语句时，请遵循最佳实践和规范，以提高代码的可读性和可维护性。
13. 对于复杂的查询需求，可以利用Mybatis-Flex的插件化架构来自定义SQL的生成和执行过程。
14. 注意监控项目的性能指标，以便及时发现和解决潜在的性能问题。
15. 保持对Mybatis-Flex官方文档的关注，以便及时了解新特性和更新。
    总之，Mybatis-Flex作为Mybatis的增强版，提供了更加灵活和强大的功能。通过将其集成到现有项目中，你可以获得更好的性能、更灵活的查询功能以及更加易于维护的代码结构。在实际应用中，请注意遵循最佳实践和规范，以确保项目的成功实施和维护。

1.引入依赖

<dependencies>
    <dependency>
        <groupId>com.mybatis-flex</groupId>
        <artifactId>mybatis-flex-spring-boot-starter</artifactId>
        <version>1.8.9</version>
    </dependency>
    <dependency>
        <groupId>com.mysql</groupId>
        <artifactId>mysql-connector-j</artifactId>
        <scope>runtime</scope>
    </dependency>
    <dependency>
        <groupId>com.zaxxer</groupId>
        <artifactId>HikariCP</artifactId>
    </dependency>
    <!-- for test only -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

注意： 如果您当前使用的是 SpringBoot v3.x 版本，需要把依赖 mybatis-flex-spring-boot-starter 修改为：mybatis-flex-spring-boot3-starter, 如下代码所示：

<dependencies>
    <dependency>
        <groupId>com.mybatis-flex</groupId>
        <artifactId>mybatis-flex-spring-boot3-starter</artifactId>
        <version>1.8.9</version>
    </dependency>
    <dependency>
        <groupId>com.mysql</groupId>
        <artifactId>mysql-connector-j</artifactId>
        <scope>runtime</scope>
    </dependency>
    <dependency>
        <groupId>com.zaxxer</groupId>
        <artifactId>HikariCP</artifactId>
    </dependency>
    <!-- for test only -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

第 3 步：对 Spring Boot 项目进行配置

在 application.yml 中配置数据源：

# DataSource Config
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/flex_test
    username: root
    password: 12345678

在 Spring Boot 启动类中添加 @MapperScan 注解，扫描 Mapper 文件夹：

@SpringBootApplication
@MapperScan("com.mybatisflex.test.mapper")
public class MybatisFlexTestApplication {

    public static void main(String[] args) {
        SpringApplication.run(MybatisFlexTestApplication.class, args);
    }

}

第 4 步：编写实体类和 Mapper 接口

@Data
@Table("tb_account")
public class Account {

    @Id(keyType = KeyType.Auto)
    private Long id;
    private String userName;
    private Integer age;
    private Date birthday;

}

• 使用 @Table("tb_account") 设置实体类与表名的映射关系
• 使用 @Id(keyType = KeyType.Auto) 标识主键为自增

Mapper 接口继承 BaseMapper 接口：

public interface AccountMapper extends BaseMapper<Account> {

}

---

这部分也可以使用 MyBatis-Flex 的代码生成器来生，功能非常强大的。

---

第 5 步：开始使用

添加测试类，进行功能测试：

import static com.mybatisflex.test.entity.table.AccountTableDef.ACCOUNT;

@SpringBootTest
class MybatisFlexTestApplicationTests {

    @Autowired
    private AccountMapper accountMapper;

    @Test
    void contextLoads() {
        QueryWrapper queryWrapper = QueryWrapper.create()
                .select()
                .where(ACCOUNT.AGE.eq(18));
        Account account = accountMapper.selectOneByQuery(queryWrapper);
        System.out.println(account);
    }

}

控制台输出：

Account(id=1, userName=张三, age=18, birthday=Sat Jan 11 00:00:00 CST 2020)