Actualización atómica

Selecciona el rango objetivo con first/multi/upsertOne y configura explícitamente la actualización del documento o el pipeline de agregación.

Primero selecciona el rango y la expresión de actualización.

text

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

Actualización de documento

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

• Agrega la actualización del controlador tal cual: driverUpdate(Bson)

• setOnInsert(...) se usa en upsertOne().document()

Upsert de un solo documento

java

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

Actualización de pipeline

java

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

nextStage() vacía el $set pendiente actual en una sola etapa. La etapa del pipeline nativo del controlador se agrega directamente con stage(Bson).

Auditoría / ciclo de vida

atomicUpdate no pasa por el ciclo de vida de guardado de la entidad.

Dado que MongoExecutionContext.beforePersist/afterPersist no se llama, no se debe esperar automáticamente que updatedAt y otros se incluyan en la actualización, incluso si se conecta la auditoría reactiva en el adaptador de Spring.