// 簡(jiǎn)單查詢，用 Service 的 lambdaQuery
List<User> users = userService.lambdaQuery()
                .eq(User::getStatus, 1)
                .like(User::getName, "張")
                .list();
// 復(fù)雜查詢，用 Mapper + XML 或注解！
// 在 UserMapper.java 中
@Select("SELECT u.*, d.dept_name FROM user u LEFT JOIN dept d ON u.dept_id = d.id WHERE u.id = #{userId}")
UserVO selectUserDetail(@Param("userId") Long userId);

// 【錯(cuò)誤姿勢(shì)】字段名是字符串，容易拼錯(cuò)，編譯器不報(bào)錯(cuò)
userService.lambdaQuery().eq("naem", "張三"); // 運(yùn)行才報(bào)錯(cuò)，哭死！
// 【正確姿勢(shì)】使用方法引用，安全又優(yōu)雅
userService.lambdaQuery().eq(User::getName, "張三"); 
// 編譯不通過，立馬改正！

// 創(chuàng)建分頁(yè)參數(shù)，并指定排序
Page<User> page = new Page<>(1, 20); // 查第1頁(yè)，每頁(yè)20條
page.addOrder(OrderItem.desc("create_time")); // 按創(chuàng)建時(shí)間倒序
// 執(zhí)行分頁(yè)查詢
Page<User> userPage = userService.page(page,
        Wrappers.<User>lambdaQuery()
                .eq(User::getDeptId, 2)
);
// 直接轉(zhuǎn)換為 VO 分頁(yè)對(duì)象，一步到位
Page<UserVO> voPage = userPage.convert(user -> {
    UserVO vo = new UserVO();
    BeanUtils.copyProperties(user, vo); // 使用 Spring 的工具類
    // 或者用 MapStruct 等更專業(yè)的工具
    return vo;
});

// 批量插入，分批提交
List<User> hugeUserList = ... // 一個(gè)巨大的列表
userService.saveBatch(hugeUserList, 1000); // 每1000條批量提交一次
// 批量更新（自己控制事務(wù)）
@Transactional(rollbackFor = Exception.class)
public void batchUpdateStatus(List<Long> ids, Integer status) {
    List<User> updateList = ids.stream().map(id -> {
        User user = new User();
        user.setId(id);
        user.setStatus(status);
        return user;
    }).collect(Collectors.toList());
    userService.updateBatchById(updateList);
}

// 復(fù)雜的 AND-OR 組合查詢
List<User> users = userService.lambdaQuery()
    .eq(User::getStatus, 1)
    .and(wrapper -> wrapper // 這是一個(gè) AND 嵌套
        .like(User::getName, "張")
        .or()
        .like(User::getEmail, "zhang") // name LIKE '%張%' OR email LIKE '%zhang%'
    )
    .between(User::getCreateTime, startTime, endTime)
    .list();
// 【性能技巧】只查需要的字段，避免 SELECT *
List<User> userList = userService.lambdaQuery()
    .select(User::getId, User::getName) // 只查詢 ID 和 Name 字段
    .eq(User::getStatus, 1)
    .list();

@Component
public class MyMetaObjectHandler implements MetaObjectHandler {
    @Override
    public void insertFill(MetaObject metaObject) {
        // 插入時(shí)自動(dòng)填充
        this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now());
        this.strictInsertFill(metaObject, "createBy", String.class, getCurrentUser());
    }
    @Override
    public void updateFill(MetaObject metaObject) {
        // 更新時(shí)自動(dòng)填充
        this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }
}
// 實(shí)體類字段上需要加注解
public class User {
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updateTime;
}

# 在 application.yml 中配置
mybatis-plus:
  global-config:
    db-config:
      logic-delete-field: deleted  # 全局邏輯刪除實(shí)體字段名
      logic-delete-value: 1        # 邏輯已刪除值（默認(rèn)為 1）
      logic-not-delete-value: 0    # 邏輯未刪除值（默認(rèn)為 0）

@Getter
public enum UserStatus {
    ENABLED(1, "啟用"),
    DISABLED(0, "禁用");
    private final int code;
    private final String desc;
    UserStatus(int code, String desc) {
        this.code = code;
        this.desc = desc;
    }
}
// 實(shí)體類中直接使用枚舉類型
public class User {
    private UserStatus status;
}
// 配置枚舉處理器（Spring Boot 基本不用配了，開箱即用）

@Configuration
public class MybatisPlusConfig {
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 租戶插件
        TenantLineInnerInterceptor tenantInterceptor = new TenantLineInnerInterceptor();
        tenantInterceptor.setTenantLineHandler(new TenantLineHandler() {
            @Override
            public Expression getTenantId() {
                // 從當(dāng)前上下文中獲取租戶ID，比如從 JWT Token 中
                return new StringValue(TenantContext.getCurrentTenantId());
            }
            @Override
            public String getTenantIdColumn() {
                return "tenant_id"; // 數(shù)據(jù)庫(kù)中的租戶ID列名
            }
            @Override
            public boolean ignoreTable(String tableName) {
                // 忽略不需要租戶隔離的表，如全局配置表
                return "system_config".equals(tableName);
            }
        });
        interceptor.addInnerInterceptor(tenantInterceptor);
        return interceptor;
    }
}

public class CodeGenerator {
    public static void main(String[] args) {
        AutoGenerator generator = new AutoGenerator();
        // 數(shù)據(jù)源配置
        DataSourceConfig dataSourceConfig = new DataSourceConfig();
        dataSourceConfig.setUrl("jdbc:mysql://localhost:3306/test");
        dataSourceConfig.setDriverName("com.mysql.cj.jdbc.Driver");
        dataSourceConfig.setUsername("root");
        dataSourceConfig.setPassword("123456");
        generator.setDataSource(dataSourceConfig);
        // 全局配置
        GlobalConfig globalConfig = new GlobalConfig();
        globalConfig.setOutputDir(System.getProperty("user.dir") + "/src/main/java");
        globalConfig.setAuthor("大華");
        globalConfig.setOpen(false);
        globalConfig.setSwagger2(true); // 實(shí)體屬性 Swagger2 注解
        generator.setGlobalConfig(globalConfig);
        // 包配置
        PackageConfig packageConfig = new PackageConfig();
        packageConfig.setParent("com.laomao.demo");
        packageConfig.setEntity("domain.entity");
        packageConfig.setMapper("dao.mapper");
        packageConfig.setService("service");
        packageConfig.setServiceImpl("service.impl");
        generator.setPackageInfo(packageConfig);
        generator.execute(); // 執(zhí)行生成
    }
}

@Component
@Slf4j
public class SqlLogInterceptor implements InnerInterceptor {
    @Override
    public void beforeQuery(Executor executor, MappedStatement ms, Object parameter, BoundSql boundSql) {
        long start = System.currentTimeMillis();
        // 將開始時(shí)間存入當(dāng)前線程上下文
    }
    @Override
    public void afterQuery(Executor executor, MappedStatement ms, Object parameter, BoundSql boundSql, List<Object> result) {
        long end = System.currentTimeMillis();
        long cost = end - start;
        if (cost > 1000) { // 超過1秒算慢SQL
            log.warn("慢SQL警告: {}, 執(zhí)行耗時(shí): {}ms", boundSql.getSql(), cost);
            // 可以接入告警系統(tǒng)，通知開發(fā)人員
        }
    }
}

public class User {
    // 指定主鍵類型為 ASSIGN_ID（雪花算法）
    @TableId(type = IdType.ASSIGN_ID)
    private Long id; // 注意是 Long，不是 Integer
    // ...
}

// 實(shí)體類中增加版本號(hào)字段
public class User {
    @Version
    private Integer version;
}
// 更新時(shí)，MP會(huì)自動(dòng)帶上版本號(hào)條件
User user = userService.getById(1L);
user.setName("新名字");
userService.updateById(user); // SQL: UPDATE user SET name=?, version=? WHERE id=? AND version=?

// 在 Mapper 方法上使用復(fù)雜結(jié)果映射
@Select("SELECT u.*, d.name as dept_name FROM user u LEFT JOIN department d ON u.dept_id = d.id WHERE u.id = #{id}")
@Results({
    @Result(column = "id", property = "id"),
    @Result(column = "dept_name", property = "deptName"),
    @Result(column = "id", property = "roles", 
            many = @Many(select = "com.laomao.mapper.RoleMapper.findByUserId"))
})
UserVO findUserWithDept(Long id);

@Service
public class UserService {
    @Transactional(rollbackFor = Exception.class) // 注意：默認(rèn)只回滾 RuntimeException
    public void createUserWithInitData(User user) {
        // 1. 保存用戶基本信息
        userService.save(user);
        // 2. 初始化用戶賬戶
        Account account = new Account();
        account.setUserId(user.getId());
        accountService.save(account);
        // 3. 發(fā)送歡迎消息（如果消息發(fā)送失敗，希望用戶創(chuàng)建也回滾）
        messageService.sendWelcomeMessage(user.getId());
        // 任何一個(gè)步驟出錯(cuò)，所有操作都會(huì)回滾
    }
}