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