CKTIS / Java
LongAdder — współbieżne zliczanie i sumowanie
LongAdder gromadzi sumę typu long aktualizowaną przez wiele wątków. Nadaje się do statystyk, ale sum() nie daje atomowego obrazu stanu, a zerowanie wymaga kontroli nad współbieżnymi aktualizacjami.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
LongAdder counter = new LongAdder();
counter.increment(); // void
counter.add(longValue); // void
long total = counter.sum();
long previous = counter.sumThenReset();
counter.reset(); // voidjava.util.concurrent.atomic.LongAdder rozpoczyna od zera i rozkłada aktualizacje na wewnętrzne zmienne, ograniczając rywalizację wątków. Przy dużej rywalizacji może zapewniać większą przepustowość niż AtomicLong, kosztem pamięci. Służy do statystyk, nie do precyzyjnego sterowania synchronizacją.
LongAdder.increment() dodaje jeden, a LongAdder.add(long) dodaje podaną wartość; obie metody zwracają void. LongAdder.sum() zwraca long, lecz nie jest atomowym obrazem stanu: może nie uwzględnić aktualizacji trwających podczas odczytu. Bez współbieżnych aktualizacji wynik jest dokładny.
LongAdder.reset() zeruje stan i zwraca void; używaj jej tylko wtedy, gdy żaden wątek nie aktualizuje licznika. LongAdder.sumThenReset() zwraca sumę i zeruje stan. Nie traktuj jej jako atomowego wyznaczenia granicy okresu pomiarowego: przy równoległych aktualizacjach wynik nie musi być końcową wartością sprzed zerowania.
W przykładzie oba wywołania join() poprzedzają odczyty i zerowanie. Dzięki temu oczekiwany wynik jest deterministyczny. Zakres dokumentacji to Java SE 21; środowisko repozytorium nie potwierdza środowiska produkcyjnego.
Przykłady
import java.util.concurrent.atomic.LongAdder;
public class Main {
public static void main(String[] args) throws InterruptedException {
LongAdder counter = new LongAdder();
Runnable task = () -> {
for (int i = 0; i < 1000; i++) {
counter.increment();
}
};
Thread first = new Thread(task);
Thread second = new Thread(task);
first.start();
second.start();
first.join();
second.join();
counter.add(5);
System.out.println(counter.sum());
System.out.println(counter.sumThenReset());
System.out.println(counter.sum());
counter.add(7);
counter.reset();
System.out.println(counter.sum());
}
}Wynik
2005 2005 0 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.