// 传统MyBatis：需要编写复杂的XML <resultMap> 和 JOIN SQL
// 在xbatis中，只需一个注解：

@Data
@ResultEntity(SysUser.class)
public class UserDetailVO {
    private Integer id;
    private String userName;
    
    // 声明式关联查询：根据 user.roleId 关联查询 role 表
    @Fetch(source = SysUser.class, property = "roleId", 
           target = SysRole.class, targetProperty = "id")
    private SysRole role; // 一对一关联
    private List<SysPermission> permissions; // 一对多关联
}

// 使用链式API查询，自动完成结果映射
List<UserDetailVO> list = QueryChain.of(userMapper)
        .eq(SysUser::getStatus, 1)
        .returnType(UserDetailVO.class)
        .list();

// 链式调用，逻辑清晰
List<SysUser> users = QueryChain.of(userMapper)
        .eq(SysUser::getTenantId, "T001")
        .like(SysUser::getUserName, "张")
        .between(SysUser::getCreateTime, startDate, endDate)
        .orderByDesc(SysUser::getCreateTime)
        .paging(Pager.of(1, 20)) // 内置分页
        .list();

@Data
@Table("sys_user")
public class SysUser {
    @TableId
    private Long id;
    
    @LogicDelete // 逻辑删除
    private Integer isDeleted;
    
    @Version // 乐观锁
    private Integer version;
    
    @TenantId // 多租户隔离
    private String tenantId;
    
    @OnInsert // 插入时自动填充
    private LocalDateTime createTime;
    
    @OnUpdate // 更新时自动填充
    private LocalDateTime updateTime;
}
// 配置后，所有查询自动附带 tenant_id=? 条件，删除自动转为更新 is_deleted 字段

// 方式1：使用xbatis的链式API（适用于95%场景）
List<SysUser> list = QueryChain.of(userMapper).eq(...).list();

// 方式2：直接执行原生SQL（应对5%的极端复杂场景）
List<SysUser> list = userMapper.selectList(
    "SELECT * FROM sys_user WHERE ... /* 任意复杂SQL */", 
    params
);

<dependency>
    <groupId>cn.xbatis</groupId>
    <artifactId>xbatis-spring-boot-starter</artifactId>
    <version>1.9.9</version>
</dependency>

@Data
@Table("sys_user") // 注解声明表名
public class User {
    @TableId // 注解声明主键
    private Long id;
    private String name;
    private Integer age;
}

// Mapper接口只需简单继承
public interface UserMapper extends MybatisMapper<User> {
    // 无需任何方法，已拥有完整CRUD能力
}

@Autowired
private UserMapper userMapper;

public void demo() {
    // 1. 插入
    User user = new User(null, "张三", 25);
    userMapper.insert(user);
    
    // 2. 查询 (条件自动过滤null)
    List<User> list = QueryChain.of(userMapper)
            .eq(User::getName, "张三")
            .gt(User::getAge, 20)
            .list();
    
    // 3. 更新
    UpdateChain.of(userMapper)
            .eq(User::getId, 1L)
            .set(User::getAge, 26)
            .execute();
}