原子更新

通过 first/multi/upsertOne 选择目标范围，并显式配置文档更新或聚合管道更新。

首先选择更新范围和表达式

text

atomicUpdate()
  -> first() / multi() / upsertOne()
  -> document() / pipeline()
  -> update operations
  -> execute()

文档更新

java

Mono<UpdateResult> updated = dsl
    .executeEntity(User.class, MongoTemplateName.FRONT)
    .fields(pair("id", userId))
    .end()
    .atomicUpdate()
    .first()
    .document()
    .inc("loginCount", 1)
    .set("lastLoginAt", Instant.now())
    .execute();

• inc, set, unset, push, addToSet, pull

• 直接添加 Driver 更新： driverUpdate(Bson)

• setOnInsert(...) 在 upsertOne().document() 中使用

单文档 upsert

java

.atomicUpdate()
.upsertOne()
.document()
.set("status", "ACTIVE")
.setOnInsert("createdAt", Instant.now())
.execute();

管道更新

java

.atomicUpdate()
.first()
.pipeline()
.set("updatedAt", "$$NOW")
.inc("loginCount", 1)
.nextStage()
.unset("legacyField")
.stage(Aggregates.set(new Field<>("normalized", ...)))
.execute();

nextStage() 将当前待处理的 $set 刷新为一个阶段。Driver-native 管道阶段通过 stage(Bson) 直接添加。

审计 / 生命周期

atomicUpdate 不经过实体保存生命周期

由于未调用 MongoExecutionContext.beforePersist/afterPersist，即使在 Spring 适配器中连接了反应式审计，也不要自动期待 atomic update 的 updatedAt 等，需显式包含在更新中。