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）。

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

核心依赖复制标题链接