MyBatis Plus

continew-starter-data-mp 是数据访问模块针对 MyBatis Plus 框架的增强实现。

引入依赖复制标题链接

<dependency>
    <groupId>top.continew.starter</groupId>
    <artifactId>continew-starter-data-mp</artifactId>
</dependency>

模块会传递引入 com.baomidou:mybatis-plus-spring-boot3-starter、com.baomidou:mybatis-plus-jsqlparser 与 p6spy:p6spy；me.ahoo.cosid:cosid-spring-boot-starter 为 optional，仅当 ID 生成器类型选择 COSID 时需要自行引入（见 continew-starter-data-mp/pom.xml）。

配置复制标题链接

扩展配置项前缀为 mybatis-plus.extension，属性类为 top.continew.starter.data.autoconfigure.MyBatisPlusExtensionProperties：

# MyBatis Plus 扩展配置
mybatis-plus:
  extension:
    enabled: true
    # ID 生成器配置
    id-generator:
      type: COSID
    # 分页插件配置
    pagination:
      enabled: true
      db-type: MYSQL
    # 乐观锁插件
    optimistic-locker-enabled: true
  # Mapper XML 文件目录配置
  mapper-locations: classpath*:/mapper/**/*Mapper.xml
  # 类型别名扫描包配置
  type-aliases-package: ${application.base-package}.**.model

启用扩展时，模块还会通过 default-data-mybatis-plus.yml 提供一组样板化默认配置（如需修改，在 application.yml 中同名覆盖即可）：

mybatis-plus:
  # 启动时是否检查 MyBatis XML 文件的存在（默认 false 不检查）
  check-config-location: true
  configuration:
    # 开启自动驼峰命名规则映射
    map-underscore-to-camel-case: true
    # 自动映射时未知列/属性处理策略：NONE 不处理；WARNING 打印警告；FAILING 抛出异常
    auto-mapping-unknown-column-behavior: NONE
    # 关闭 MyBatis 自带日志，统一使用 P6Spy 输出 SQL
    log-impl: org.apache.ibatis.logging.nologging.NoLoggingImpl

通用查询注解复制标题链接

在查询条件类的字段上标注 @Query 注解，即可通过 QueryWrapperHelper.build(query) 构建查询条件，免去手写 QueryWrapper 拼接：

@Data
public class DeptQuery implements Serializable {

    @Serial
    private static final long serialVersionUID = 1L;

    /**
     * 部门名称
     */
    private String name;

    /**
     * 状态
     */
    private Integer status;
}

// 手动拼接查询条件
LambdaQueryWrapper<DeptDO> queryWrapper = new LambdaQueryWrapper<>();
queryWrapper.like(StrUtil.isNotBlank(query.getName()), DeptDO::getName, query.getName());
queryWrapper.eq(null != query.getStatus(), DeptDO::getStatus, query.getStatus());

@Query 注解属性（top.continew.starter.data.annotation.Query）：

查询类型枚举 top.continew.starter.data.enums.QueryType：

通用 Mapper 与 Service复制标题链接

继承模块提供的 BaseMapper（top.continew.starter.data.mapper.BaseMapper）与 IService / ServiceImpl，在 MyBatis Plus 默认能力之上额外获得批量与链式方法：

public interface DemoMapper extends BaseMapper<DemoDO> {
}

public interface DemoService extends IService<DemoDO> {
}

@Service
public class DemoServiceImpl extends ServiceImpl<DemoMapper, DemoDO> implements DemoService {
}

BaseMapper 扩展方法（BaseMapper.java:46-113）：insertBatch（批量插入）、updateBatchById（批量更新）、query / lambdaQuery（链式查询）、update / lambdaUpdate（链式更新）、currentEntityClass（获取实体类 Class）。

插件与扩展能力复制标题链接

• 拦截器自动注入：Spring 容器中所有 InnerInterceptor Bean 会自动注入 MybatisPlusInterceptor，再依次追加分页、乐观锁、防全表更新删除插件（见 MybatisPlusAutoConfiguration.java:79-103）。
• BaseEnum 枚举支持：通过 MybatisPlusPropertiesCustomizer 将默认枚举 TypeHandler 设置为 CompositeBaseEnumTypeHandler，实现 BaseEnum 接口的枚举按 getValue() 值入库，无需逐个标注（MybatisPlusAutoConfiguration.java:68-72）。
• P6Spy SQL 分析：内置 spy.properties，默认输出 SQL 到控制台、记录超过 2 秒的慢 SQL（outagedetectioninterval=2），并排除 SELECT 1 等心跳语句；配合 log-impl: NoLoggingImpl 可避免 MyBatis 日志与 P6Spy 重复输出。
• ID 生成器：type 为 COSID 时需自行引入 cosid-spring-boot-starter；为 CUSTOM 时必须自行提供 IdentifierGenerator Bean，否则启动时报 NoSuchBeanDefinitionException（MyBatisPlusIdGeneratorConfiguration.java:84-109）。

2.13 → 4.0 升级须知复制标题链接

本模块传递的 CosId 版本已随 3.0.0 升至 4.0.2。type: COSID 的装配行为不变（仍注入内置共享 Bean __share__SnowflakeId 生成分布式 ID），使用方须知集中在机器号分配：

• 容器部署建议配置固定 instance-id：CosId 4.0 起会检测容器环境，未配置 cosid.machine.instance-id 时输出 WARN 并建议在容器内配置 cosid.machine.instance-id: ${HOSTNAME} 与 cosid.machine.stable: true，避免每次重启占用新的机器号（10bit 机器号上限 1024）。虚拟机部署不受影响，默认行为（进程 ID 参与实例标识）与 2.x 一致。
• provider API 编码形态：IdGeneratorProvider.get(String)/getRequired(String) 的返回类型从 IdGenerator 收窄为父接口 StringIdGenerator，链式调用 generateAsString() 与 getShare() 不受影响，但不要再把返回值赋回 IdGenerator 类型变量后调用 generate()，该写法 4.0 编译不过。

机器号分配机制本身由 CosId starter 承担，本模块无相关配置键。开启机器号守护（cosid.machine.guarder.enabled: true）的系统升级后无需清理 Redis 中的机器号记录。

@MapperScan("top.continew.admin.**.mapper")
@SpringBootApplication
public class ExampleApplication {
    public static void main(String[] args) {
        SpringApplication.run(ExampleApplication.class, args);
    }
}

4.0 → 4.1 升级须知复制标题链接

本模块传递的 CosId 版本已随 3.1.0 升至 4.1.1。type: COSID 的装配行为不变（仍注入内置共享 Bean __share__SnowflakeId 生成分布式 ID）。

• segment 生成器并发跳段缺陷已修复：CosId 4.0.2 引入的缺陷在并发取号时会让部分号段的 ID 永不发放（浪费但不重复，CosId #1299），4.1.0 已修复。使用 segment 生成器的项目随本次升级获得修复，无需调整配置。
• 存储模块不再传递 Guava：自行引入 cosid-jdbc、cosid-spring-redis 或 cosid-mongo 的项目，4.1.0 起这些模块不再传递 Guava（CosId #1271），代码用到 Guava 的需自行声明 com.google.guava:guava；cosid-zookeeper 经 Apache Curator 仍会带入 Guava。
• 预取 worker 停机钩子在 starter 下默认关闭：cosid.segment.chain.prefetch-worker.shutdown-hook 在 starter 下自 4.1.1 默认变为 false（CosId #1302），停机时预取 worker 改由 Spring lifecycle 在 web server 排空后停止，需提前停止的容器化部署可设回 true。

核心依赖复制标题链接