Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

LongAdder: incrementar, sumar y leer el total

Usa `increment()` para sumar uno, `add(long)` para aplicar una variación y `sum()` para leer el total. Aprende a combinar sumas parciales y a reconocer cuándo la lectura da un resultado exacto.

Versión: Java SE 21

Sintaxis

Java SE 21 — java.util.concurrent.atomic.LongAdder
public LongAdder()
public void increment()
public void add(long x)
public long sum()

LongStream.collect: (left, right) -> left.add(right.sum())

En Java SE 21, java.util.concurrent.atomic.LongAdder mantiene una suma de tipo long que varios hilos pueden actualizar. new LongAdder() empieza en cero. increment() suma uno, igual que add(1L). add(long x) suma x, que puede ser negativo. Ambos métodos devuelven void. sum() devuelve un long sin reiniciar el contador.

En un LongStream.collect(...) paralelo, LongAdder::new crea contenedores nuevos para los resultados parciales. La función acumuladora procesa cada elemento. La función combinadora (left, right) -> left.add(right.sum()) lee la suma parcial de la derecha y la añade al contenedor de la izquierda sin modificar el de la derecha. Esta sobrecarga de collect mantiene separados los contenedores durante la acumulación, así que la ejecución en paralelo no requiere por sí sola LongAdder.

Si hay actualizaciones en curso, sum() no proporciona una instantánea atómica: puede omitir cambios que ocurran durante la lectura. Para obtener un resultado final exacto, lee el contenedor devuelto cuando termine collect, como en el ejemplo. Si gestionas los hilos directamente, usa Thread.join() para esperar a que terminen todos los que actualizan el contador y asegúrate de que ningún otro hilo siga modificándolo.

Ejemplos

import java.util.concurrent.atomic.LongAdder;
import java.util.stream.LongStream;

public class LongAdderDemo {
    public static void main(String[] args) {
        LongAdder total = LongStream.of(1, 4, 1, -2, 3)
                .parallel()
                .collect(LongAdder::new,
                        (partial, delta) -> {
                            if (delta == 1L) {
                                partial.increment();
                            } else {
                                partial.add(delta);
                            }
                        },
                        (left, right) -> left.add(right.sum()));

        System.out.println(total.sum());
    }
}

Resultado

7

Se espera que el programa imprima `7`, porque `1 + 4 + 1 - 2 + 3 = 7`. El resultado no depende de cómo se divida el flujo, y la lectura final se realiza después de que `collect` devuelva el resultado.

Lecciones relacionadas

  • Java · Lección 24 · Avanzado · Versión: 2

Fuentes