MyBatis-Plus 集成（forge-starter-orm）

MyBatis-Plus 集成模块，提供自动填充、分页、乐观锁等开箱即用功能。

快速开始

1. 引入依赖

<dependency>
    <groupId>com.mdframe.forge</groupId>
    <artifactId>forge-starter-orm</artifactId>
</dependency>

2. 配置 Mapper 扫描包路径

mybatis-plus:
  mapperPackage: com.mdframe.forge.**.mapper

核心功能

自动填充

InjectionMetaObjectHandler 会自动填充以下审计字段：

插入时（`insertFill`）

字段	值
`createTime`	`LocalDateTime.now()`
`updateTime`	`LocalDateTime.now()`
`createBy`	当前登录用户 ID（`SessionHelper.getLoginUser().getUserId()`）
`updateBy`	当前登录用户 ID
`createDept`	当前登录用户所属部门 ID（`loginUser.getOrgIds().get(0)`）

更新时（`updateFill`）

字段	值
`updateTime`	`LocalDateTime.now()`
`updateBy`	当前登录用户 ID（`SessionHelper.getUserId()`）

实体类使用示例

@Data
@TableName("sys_user")
public class User extends BaseEntity {

    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;

    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updateTime;

    @TableField(fill = FieldFill.INSERT)
    private Long createBy;

    @TableField(fill = FieldFill.INSERT_UPDATE)
    private Long updateBy;

    @TableField(fill = FieldFill.INSERT)
    private Long createDept;

    // 业务字段...
    private String username;
    private String phone;
}

提示：继承 BaseEntity 即可享受自动填充功能。

分页插件

自动注册 PaginationInnerInterceptor，支持 MyBatis-Plus 分页查询：

Page<User> page = new Page<>(1, 10);
userMapper.selectPage(page, Wrappers.<User>lambdaQuery()
    .eq(User::getStatus, 1));

乐观锁

自动注册 OptimisticLockerInnerInterceptor，支持乐观锁：

@Version
private Integer version;

分布式 ID 生成器

自动注册集群安全的 Snowflake ID 生成器：

@Bean
public IdentifierGenerator identifierGenerator() {
    return new DefaultIdentifierGenerator(NetUtil.getLocalhost());
}

配置项

mybatis-plus:
  mapperPackage: com.mdframe.forge.**.mapper
  mapperLocations: classpath*:mapper/**/*.xml
  typeAliasesPackage: com.mdframe.forge.**.entity
  global-config:
    db-config:
      id-type: ASSIGN_ID        # Snowflake ID
      logic-delete-field: deleted
      logic-delete-value: 1
      logic-not-delete-value: 0

扩展点

模块支持自动发现其他模块注册的 InnerInterceptor，可通过实现 InnerInterceptor 接口并注册为 Spring Bean 来扩展拦截器。

orm.md 2.8 KB Histórico Em bruto