MyBatis-Flex多表关联查询指南分享

// 1. 查询账户及其书籍（1对多）
QueryWrapper query = QueryWrapper.create()
    .select() // 查询主表（Account）的所有字段
    .from(Account.class)
    // 使用 leftJoin 或 innerJoin 定义关联关系（注意：这只是定义关系，不生成SQL JOIN）
    .leftJoin(Book.class).on(Account::getId).eq(Book::getAccountId))
    // 添加查询条件
    .where(Account::getUserName).like("张三")
    .and(Book::getPublishDate).ge(LocalDate.now().minusYears(1));

// 执行查询
// 注意：这里返回的仍然是 List<Account>，但MyBatis-Flex会通过额外查询自动填充其Book列表
List<Account> accounts = accountMapper.selectListByQuery(query);

public class Account {
    private Long id;
    private String userName;
    
    // 关键：使用 @Relation 注解定义一对多关系
    @Relation(
        value = RelationType.OneToMany, // 关联类型
        targetField = "accountId" // 目标表（Book）中的关联字段
    )
    private List<Book> books;
    // ... getters and setters
}

public class Book {
    private Long id;
    private String title;
    private Long accountId; // 这个字段与 Account.id 关联
    // ... getters and setters
}

// 无需在 QueryWrapper 中写 join，直接查
QueryWrapper query = QueryWrapper.create()
    .where(Account::getUserName).eq("张三");
    
List<Account> accounts = accountMapper.selectListByQuery(query);
// 此时，每个 accounts 中的 Account 对象，其 books 属性已被自动填充

public class Book {
    private Long id;
    private String title;
    private Long accountId;
    
    // 关键：使用 @Relation 注解定义多对一关系
    @Relation(
        value = RelationType.ManyToOne, // 关联类型
        targetField = "accountId", // 当前表（Book）中的关联字段
        // 指定目标表的关联字段，默认为 id，可省略
        targetFieldBind = "id" 
    )
    private Account account;
    // ... getters and setters
}

List<Book> books = bookMapper.selectAll();
// 每个 Book 对象的 account 属性已被自动填充

public class Student {
    private Long id;
    private String name;
    
    @Relation(
        value = RelationType.ManyToMany,
        // 中间表实体类
        targetTable = "tb_student_course",
        // 当前对象在中间表中的字段
        selfField = "id",
        // 当前对象在中间表中的字段（selfField）对应的中间表字段
        selfTargetField = "student_id",
        // 目标对象在中间表中的字段（targetField）对应的中间表字段
        targetTargetField = "course_id",
        // 目标表实体类
        targetTableField = "tb_course",
        // 目标对象的关联字段（通常是id）
        targetField = "id"
    )
    private List<Course> courses;
}

QueryWrapper query = QueryWrapper.create()
    .select()
    .from(Account.class)
    // 定义关联关系
    .leftJoin(Book.class).on(Account::getId).eq(Book::getAccountId))
    // 主表条件
    .where(Account::getUserName).like("张")
    // 关联表条件！！！
    .and(Book::getPrice).gt(new BigDecimal("50.00"))
    .and(Book::getStatus).eq(1);

List<Account> accounts = accountMapper.selectListByQuery(query);

public class Account {
    @Relation(
        value = RelationType.OneToMany,
        targetField = "accountId",
        // 额外条件：只查询状态为已发布的书籍
        extraCondition = "status = 1 and price > 50"
    )
    private List<Book> publishedExpensiveBooks;
}