CKTIS / Java
LongAdder: zwiększanie licznika, dodawanie i odczyt sumy
Używaj `increment()` do zwiększania licznika o 1, `add(long)` do dodawania dowolnego przyrostu, a `sum()` do odczytu. Dowiedz się, jak scalać wyniki częściowe i kiedy odczyt daje dokładną sumę.
Wersja: Java SE 21
Składnia
Java SE 21 — java.util.concurrent.atomic.LongAdder
public LongAdder()
public void increment()
public void add(long x)
public long sum()
LongStream.collect: (left, right) -> left.add(right.sum())W Java SE 21 klasa java.util.concurrent.atomic.LongAdder przechowuje sumę typu long i umożliwia aktualizowanie jej przez wiele wątków. new LongAdder() zaczyna od zera. increment() zwiększa sumę o 1 i działa tak samo jak add(1L). Metoda add(long x) dodaje x, również gdy jest ujemne. Obie metody zwracają void. sum() zwraca long i nie zeruje licznika.
W równoległym LongStream.collect(...) wyrażenie LongAdder::new tworzy nowe akumulatory częściowe. Akumulator przetwarza każdy element, a funkcja scalająca (left, right) -> left.add(right.sum()) odczytuje prawą sumę częściową i dodaje ją do lewego akumulatora, nie zmieniając prawego. W tym wywołaniu collect częściowe akumulatory są od siebie odizolowane podczas gromadzenia danych; równoległość nie wymaga zatem użycia LongAdder.
sum() wywołane podczas aktualizacji nie jest atomową migawką: może pominąć zmiany zachodzące w trakcie odczytu. Aby uzyskać dokładny wynik końcowy, odczytaj zwrócony akumulator po zakończeniu collect, tak jak w przykładzie. Jeśli samodzielnie zarządzasz wątkami, zaczekaj za pomocą Thread.join() na zakończenie wszystkich wątków aktualizujących licznik i upewnij się, że żaden inny wątek go nie zmienia.
Przykłady
import java.util.concurrent.atomic.LongAdder;
import java.util.stream.LongStream;
public class LongAdderDemo {
public static void main(String[] args) {
LongAdder total = LongStream.of(1, 4, 1, -2, 3)
.parallel()
.collect(LongAdder::new,
(partial, delta) -> {
if (delta == 1L) {
partial.increment();
} else {
partial.add(delta);
}
},
(left, right) -> left.add(right.sum()));
System.out.println(total.sum());
}
}Wynik
7
Program wypisze `7`, ponieważ `1 + 4 + 1 - 2 + 3 = 7`. Wynik nie zależy od podziału strumienia, a końcowy odczyt odbywa się po powrocie z `collect`.
Powiązane lekcje
- Java · Lekcja 24 · Zaawansowany · Wersja: 2