Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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();           // void

java.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.

Źródła