Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła