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

CKTIS / Java

LongAccumulator: construcción, actualización y lectura del máximo

Mantén el máximo de valores `long` con `LongAccumulator`, elige un elemento neutro adecuado y entiende qué puede devolver `get()` cuando hay actualizaciones concurrentes.

Versión: Java SE 21

Sintaxis

import java.util.concurrent.atomic.LongAccumulator;
import java.util.function.LongBinaryOperator;

// API signatures
public LongAccumulator(LongBinaryOperator accumulatorFunction, long identity)
public void accumulate(long x)
public long get()

// Running maximum over the full long range
LongAccumulator maximum = new LongAccumulator(Long::max, Long.MIN_VALUE);
maximum.accumulate(-7L);
long currentMaximum = maximum.get();

En Java SE 21, el constructor LongAccumulator(LongBinaryOperator,long) del paquete java.util.concurrent.atomic recibe un operador y su elemento neutro, que también es el valor inicial. Un java.util.function.LongBinaryOperator recibe dos valores primitivos long y devuelve un long. El elemento neutro deja intacta la entrada: f(identity, x) == x.

accumulate(long x) incorpora x al cálculo mediante el operador y no devuelve ningún valor (void). El acumulador puede guardar resultados parciales por separado para reducir la contención entre hilos. Como no se garantiza el orden de acumulación, utiliza un operador asociativo y conmutativo. Evita los efectos secundarios: la contención puede hacer que se vuelva a invocar el operador.

La referencia a método Long::max elige el mayor de dos valores. Para todo el rango de long, usa Long.MIN_VALUE, porque max(Long.MIN_VALUE, x) == x. 0L solo es neutro para entradas no negativas, como los tamaños. Si puede haber entradas negativas, 0L no es un elemento neutro y Java SE 21 no garantiza el resultado si lo usas como tal. Antes de la primera actualización, get() devuelve el elemento neutro, por lo que Long.MIN_VALUE no basta para distinguir la ausencia de entradas de un máximo real igual a ese valor.

get() combina los resultados parciales y devuelve un long sin reiniciar el estado. Sin actualizaciones concurrentes el resultado es exacto; si las hay, no es una instantánea atómica y puede omitir algunas actualizaciones. Usa la clase para obtener estadísticas, no para coordinar hilos. reset() restaura el elemento neutro; llámalo solo cuando ningún hilo esté actualizando el acumulador.

Ejemplos

import java.util.concurrent.atomic.LongAccumulator;

public class Main {
    public static void main(String[] args) {
        LongAccumulator fullRange = new LongAccumulator(Long::max, Long.MIN_VALUE);
        LongAccumulator withZero = new LongAccumulator(Long::max, Long.MIN_VALUE);
        withZero.accumulate(0L);

        for (long value : new long[] {-7L, -3L, -12L}) {
            fullRange.accumulate(value);
            withZero.accumulate(value);
        }

        System.out.println(fullRange.get());
        System.out.println(fullRange.get());
        System.out.println(withZero.get());
    }
}

Resultado

-3
-3
0

Dos lecturas del mismo acumulador dan `-3` porque `get()` no reinicia el estado. El segundo acumulador devuelve `0` porque también recibe `0L` como entrada. Ambos usan `Long.MIN_VALUE` como elemento neutro.

Lecciones relacionadas

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

Fuentes