Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

LongAccumulator — współbieżna agregacja wartości long

LongAccumulator agreguje wartości long według podanej funkcji. Obsługuje współbieżne aktualizacje, lecz get() nie zapewnia atomowego obrazu stanu podczas zapisów.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

LongAccumulator(LongBinaryOperator accumulatorFunction, long identity)
void accumulate(long x)
long get()

LongAccumulator z pakietu java.util.concurrent.atomic służy do współbieżnej agregacji wartości long, na przykład statystyk, a nie do sterowania synchronizacją. Wewnętrznie może rozdzielać aktualizacje między wiele zmiennych, ograniczając rywalizację kosztem pamięci.

Konstruktor przyjmuje funkcję LongBinaryOperator i jej element neutralny. Funkcja powinna być łączna, przemienna i pozbawiona efektów ubocznych: kolejność nie jest gwarantowana, a obliczenie może zostać powtórzone. Dla Long::max elementem neutralnym jest Long.MIN_VALUE.

LongAccumulator.accumulate(long x) uwzględnia argument w agregacji i zwraca void. LongAccumulator.get() zwraca wynik typu long, ale nie jest atomowym obrazem stanu: może nie uwzględnić równoczesnych aktualizacji. Bez równoczesnych zapisów wynik jest dokładny.

Przykłady

import java.util.concurrent.atomic.LongAccumulator;

public class Main {
    public static void main(String[] args) throws InterruptedException {
        LongAccumulator maximum =
                new LongAccumulator(Long::max, Long.MIN_VALUE);

        Thread first = new Thread(() -> {
            maximum.accumulate(-8L);
            maximum.accumulate(12L);
        });
        Thread second = new Thread(() -> {
            maximum.accumulate(7L);
            maximum.accumulate(-3L);
        });

        first.start();
        second.start();
        first.join();
        second.join();

        System.out.println(maximum.get());
    }
}

Wynik

12

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła