CKTIS / Java
LongAccumulator: konstruktor, aktualizacja i odczyt maksimum
Obliczaj maksimum napływających wartości typu `long` za pomocą `LongAccumulator`. Dobierz element neutralny i sprawdź, co gwarantuje `get()` podczas równoległych aktualizacji.
Wersja: Java SE 21
Składnia
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();W Java SE 21 konstruktor LongAccumulator(LongBinaryOperator,long) z pakietu java.util.concurrent.atomic przyjmuje operator i jego element neutralny, który jest też wartością początkową. java.util.function.LongBinaryOperator przyjmuje dwa prymitywy long i zwraca long. Element neutralny nie może zmieniać wyniku: f(identity, x) == x.
accumulate(long x) dodaje x do obliczenia według operatora, nie zwracając wyniku (void). Przy współbieżnych aktualizacjach klasa może przechowywać wyniki częściowe osobno, aby ograniczyć rywalizację wątków. Kolejność zastosowań operatora nie jest gwarantowana, więc wybierz operację łączną i przemienną. Unikaj efektów ubocznych: przy rywalizacji wątków operator może zostać wywołany ponownie.
Referencja do metody Long::max wybiera większą z dwóch wartości. Dla pełnego zakresu long użyj Long.MIN_VALUE, bo max(Long.MIN_VALUE, x) == x. Wartość 0L jest neutralna tylko dla danych nieujemnych, np. rozmiarów. Jeśli dane mogą być ujemne, 0L nie jest elementem neutralnym i Java SE 21 nie gwarantuje wyniku po użyciu go w tej roli. Przed pierwszą aktualizacją get() zwraca element neutralny; sama wartość Long.MIN_VALUE nie pozwala więc odróżnić braku danych od rzeczywistego maksimum równego tej wartości.
get() łączy wyniki częściowe i zwraca long bez resetowania stanu. Gdy nie ma równoległych aktualizacji, wynik jest dokładny; podczas nich odczyt nie jest atomową migawką i może pominąć część aktualizacji. Do statystyk to wystarcza, ale nie używaj odczytu do synchronizacji wątków. reset() przywraca element neutralny; wywołuj tę metodę tylko wtedy, gdy żaden wątek nie aktualizuje akumulatora.
Przykłady
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());
}
}Wynik
-3 -3 0
Dwa odczyty tego samego akumulatora dają `-3`, ponieważ `get()` nie resetuje stanu. Drugi akumulator zwraca `0`, bo otrzymuje także `0L` jako daną wejściową. W obu akumulatorach elementem neutralnym jest `Long.MIN_VALUE`.
Powiązane lekcje
- Java · Lekcja 31 · Zaawansowany · Wersja: 2