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.