CKTIS / Java
LongAdder: actualizar, leer y poner a cero
Usa `LongAdder` para recopilar estadísticas que actualizan varios hilos. Aprende cuándo la lectura es exacta y por qué `sumThenReset()` no establece un límite atómico entre periodos de medición.
Versión: Java SE 21
Sintaxis
import java.util.concurrent.atomic.LongAdder;
// LongAdder instance methods in Java SE 21:
public void increment()
public void add(long x)
public long sum()
public long sumThenReset()
public void reset()java.util.concurrent.atomic.LongAdder mantiene una suma de tipo long que empieza en cero. Cuando muchos hilos compiten por actualizarla, puede repartir las actualizaciones entre varias variables internas. Es útil para recopilar estadísticas, no para coordinar hilos.
increment() añade 1, al igual que add(1L). add(long x) añade el valor indicado, que también puede ser negativo. Ambos métodos tienen tipo de retorno void. sum() devuelve el total como long sin modificarlo. Si no hay actualizaciones concurrentes, el resultado es exacto. De lo contrario, la lectura no es una instantánea atómica y puede omitir algunas actualizaciones concurrentes.
reset() pone a cero la misma instancia y no devuelve ningún valor. Úsalo solo si sabes que ningún hilo actualizará el contador durante la llamada. Sin actualizaciones concurrentes, sumThenReset() tiene el mismo efecto que llamar a sum() y luego a reset(): devuelve el total anterior como long y pone el contador a cero. No separa los periodos de medición de forma atómica. Si hay actualizaciones durante la llamada, no se garantiza que el resultado sea el último total antes de la puesta a cero.
Ejemplos
import java.util.concurrent.atomic.LongAdder;
public class Main {
public static void main(String[] args) {
LongAdder requests = new LongAdder();
LongAdder bytes = new LongAdder();
for (long size : new long[] {512L, 1024L, 2048L, 3072L, 376L}) {
requests.increment();
bytes.add(size);
}
System.out.println("Requests: " + requests.sum());
System.out.println("Bytes: " + bytes.sum());
System.out.println("Bytes returned by sumThenReset(): " + bytes.sumThenReset());
System.out.println("Bytes after sumThenReset(): " + bytes.sum());
requests.reset();
System.out.println("Requests after reset(): " + requests.sum());
}
}Resultado
Requests: 5 Bytes: 7032 Bytes returned by sumThenReset(): 7032 Bytes after sumThenReset(): 0 Requests after reset(): 0
Un solo hilo cuenta cinco solicitudes y un total de 7032 bytes. `sumThenReset()` devuelve 7032 y pone a cero el contador de bytes; `reset()` pone a cero el contador de solicitudes sin devolver su valor anterior.
Lecciones relacionadas
- Java · Lección 31 · Avanzado · Versión: 2