分享一些Mybatis-Plus的核心功能

// Mapper 接口（无需写任何方法）
public interface UserMapper extends BaseMapper<User> {
}

// 调用示例（Service 层）
@Service
public class UserService {
    @Autowired
    private UserMapper userMapper;

    public void addUser(User user) {
        userMapper.insert(user); // 直接使用 BaseMapper 方法
    }
}

// Service 接口
public interface UserService extends IService<User> {
}

// Service 实现类
@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
    // 无需重写基础 CRUD，直接使用父类方法
}

// 调用示例
@Controller
public class UserController {
    @Autowired
    private UserService userService;

    public IPage<User> getUserPage(Integer pageNum, Integer pageSize) {
        // 分页查询：第1页，每页10条
        return userService.page(new Page<>(pageNum, pageSize), null);
    }
}

// 场景：根据前端传入的参数（可能为 null）动态筛选
public List<User> queryUser(String userName, Integer age, Integer status) {
    LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<User>()
            // 只有 userName 不为 null 且不为空，才拼接模糊查询
            .like(StringUtils.hasText(userName), User::getUserName, userName)
            // 只有 age 不为 null，才拼接 age >= age
            .ge(age != null, User::getAge, age)
            // 只有 status 不为 null，才拼接 status = status
            .eq(status != null, User::getStatus, status)
            // 固定条件：未删除（逻辑删除）
            .eq(User::getIsDeleted, 0)
            // 排序：按创建时间降序
            .orderByDesc(User::getCreateTime);
    return userService.list(queryWrapper);
}

// 条件：(age > 18 且 user_name 含"张") 或 (age < 10 且 user_name 含"李")
queryWrapper.and(w -> w.gt(User::getAge,18).like(User::getUserName,"张"))
            .or(w -> w.lt(User::getAge,10).like(User::getUserName,"李"));

// 场景：分页查询年龄>18的用户，第1页，每页10条
public IPage<User> getUserPage(Integer pageNum, Integer pageSize) {
    // 1. 构建分页对象（pageNum：页码，pageSize：每页条数）
    Page<User> page = new Page<>(pageNum, pageSize);
    
    // 2. 构建查询条件
    LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<User>()
            .gt(User::getAge, 18)
            .eq(User::getIsDeleted, 0);
    
    // 3. 分页查询（Service 层 page 方法）
    IPage<User> userPage = userService.page(page, queryWrapper);
    
    // 4. 分页结果解析
    long total = userPage.getTotal(); // 总记录数
    long pages = userPage.getPages(); // 总页数
    List<User> records = userPage.getRecords(); // 当前页数据
    return userPage;
}

// Mapper 接口
public interface UserMapper extends BaseMapper<User> {
    // 自定义分页：多表联查（用户+部门）
    IPage<UserVO> selectUserWithDept(Page<User> page, @Param("query") UserQueryDTO query);
}

// XML 文件（无需写 LIMIT，MP 自动拼接）
<select id="selectUserWithDept" resultType="com.example.vo.UserVO">
    SELECT u.id, u.user_name, d.dept_name 
    FROM t_user u
    LEFT JOIN t_dept d ON u.dept_id = d.id
    WHERE u.is_deleted = 0
    <if test="query.userName != null">
        AND u.user_name LIKE CONCAT('%', #{query.userName}, '%')
    </if>
</select>

// 调用示例
public IPage<UserVO> queryUserWithDept(Integer pageNum, Integer pageSize, UserQueryDTO query) {
    return userMapper.selectUserWithDept(new Page<>(pageNum, pageSize), query);
}

Page<User> page = new Page<>(pageNum, pageSize, false); // 第三个参数：是否查询总数（默认 true）

mybatis-plus:
  global-config:
    db-config:
      logic-delete-field: isDeleted # 全局逻辑删除字段名（实体类属性名）
      logic-delete-value: 1 # 已删除值（数据库存储值）
      logic-not-delete-value: 0 # 未删除值（数据库存储值）

@Data
@TableName("t_user")
public class User {
    // 逻辑删除字段（全局配置后，@TableLogic 可省略，若字段名与全局配置不一致需显式指定）
    @TableLogic
    private Integer isDeleted;
}

@Data
@TableName("t_user")
public class User {
    // 插入时填充（仅新增时设置）
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
    
    // 插入+更新时填充（新增和修改时都设置）
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updateTime;
}

@Component // 必须交给 Spring 管理
public class MyMetaObjectHandler implements MetaObjectHandler {
    // 插入时填充
    @Override
    public void insertFill(MetaObject metaObject) {
        // 严格填充：只有字段为 null 时才填充（避免覆盖手动设置的值）
        strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now());
        strictInsertFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }
    
    // 更新时填充
    @Override
    public void updateFill(MetaObject metaObject) {
        strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }
}

mybatis-plus:
  global-config:
    db-config:
      id-type: AUTO # 单库场景（MySQL 自增）
      # id-type: ASSIGN_ID # 分布式场景（雪花算法，生成 19 位 Long 型 ID）

@Data
@TableName("t_user")
public class User {
    // 乐观锁版本号字段（必须加 @Version 注解）
    @Version
    private Integer version; // 数据库字段默认值 0
}

@Configuration
public class MyBatisPlusConfig {
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 乐观锁插件
        interceptor.addInnerInterceptor(new OptimisticLockerInnerInterceptor());
        return interceptor;
    }
}

// 并发更新用户信息
public boolean updateUser(UserUpdateDTO dto) {
    // 1. 查询当前用户（获取最新版本号）
    User user = userService.getById(dto.getId());
    if (user == null) {
        throw new RuntimeException("用户不存在");
    }
    
    // 2. 校验版本号（前端需传入当前版本号，避免并发覆盖）
    if (!user.getVersion().equals(dto.getVersion())) {
        throw new RuntimeException("数据已被修改，请刷新后重试");
    }
    
    // 3. 更新数据（MP 自动拼接 version 条件）
    BeanUtils.copyProperties(dto, user);
    return userService.updateById(user);
}

UPDATE t_user 
SET user_name = '李四', version = 1 
WHERE id = 1 AND version = 0;