Under-Utils
stable 1.0.4 1.0.5-SNAPSHOT
starter

MyBatis Starter

under-utils-mybatis-starter

自动装配 MyBatis-Plus interceptor 和默认审计字段填充处理器。

依赖

under-utils-mybatis-starter Maven 坐标 
<dependency>
    <groupId>io.github.yexianglun-d</groupId>
    <artifactId>under-utils-mybatis-starter</artifactId>
    <version>1.0.4</version>
</dependency>

适用场景

想零配置接入 Under-Utils MyBatis 能力的 Spring Boot 项目。

能力边界

文档来源 under-utils-mybatis-starter/README.md
API 入口 查看 MyBatis Starter 相关 API
设计约束 保留失败语义、配置 key 和 public API 兼容性说明，不以营销描述替代真实边界。
独立 starter 该能力来自当前模块 README 或 API Review，页面下方同步展示原始 README 内容。
ConditionalOnMissingBean 退让 该能力来自当前模块 README 或 API Review，页面下方同步展示原始 README 内容。
under.utils.mybatis 配置 该能力来自当前模块 README 或 API Review，页面下方同步展示原始 README 内容。

README 同步内容

来源：under-utils-mybatis-starter/README.md，构建时自动读取并渲染。

Spring Boot 自动装配模块，为 MyBatis-Plus 项目提供分页插件、乐观锁、防全表更新删除和审计字段填充的默认 Bean。

本 starter 假设业务项目已经引入并配置 MyBatis-Plus、数据源和 mapper 扫描。它只负责 Under-Utils MyBatis 能力的自动装配，不接管数据源、事务或 mapper 扫描。

依赖

<dependency>
    <groupId>io.github.yexianglun-d</groupId>
    <artifactId>under-utils-mybatis-starter</artifactId>
    <version>1.0.4</version>
</dependency>

默认装配

默认创建：

  • MybatisPlusInterceptor：分页、乐观锁、防全表更新删除。
  • DefaultMetaObjectHandler：创建/更新时间、创建/更新人和逻辑删除默认值填充。

所有 Bean 都会在业务项目已经声明同类型 Bean 时退让。

配置

under:
  utils:
    mybatis:
      enabled: true
      interceptor:
        enabled: true
        db-type: mysql
      audit:
        enabled: true
        create-time-field: createTime
        update-time-field: updateTime
        create-by-field: createBy
        update-by-field: updateBy
        deleted-field: deleted
        not-deleted-value: 0
        fill-deleted: true

如果需要接入当前用户 ID，业务项目声明 AuditorProvider：

@Bean
public AuditorProvider auditorProvider() {
    return () -> 1001L;
}

多数据源项目通常需要为每个 SqlSessionFactory 单独配置 interceptor，不建议依赖全局默认 Bean。此时可以关闭本 starter 的 interceptor 自动装配：

under:
  utils:
    mybatis:
      interceptor:
        enabled: false