Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

LongAdder: aktualizacja, odczyt i zerowanie

Używaj `LongAdder` do zbierania statystyk aktualizowanych przez wiele wątków. Odróżniaj odczyt sumy od zerowania i sprawdź, dlaczego `sumThenReset()` nie wyznacza atomowej granicy okresu pomiarowego.

Wersja: Java SE 21

Składnia

import java.util.concurrent.atomic.LongAdder;

// LongAdder instance methods in Java SE 21:
public void increment()
public void add(long x)
public long sum()
public long sumThenReset()
public void reset()

java.util.concurrent.atomic.LongAdder przechowuje sumę typu long, początkowo równą zero. Przy dużej rywalizacji wątków może rozłożyć aktualizacje na kilka wewnętrznych zmiennych. Nadaje się do zbierania statystyk, a nie do sterowania synchronizacją wątków.

increment() dodaje 1, tak samo jak add(1L). add(long x) dodaje podaną wartość, która może być ujemna. Obie metody mają typ zwracany void. sum() zwraca sumę jako long i jej nie zmienia. Bez równoczesnych aktualizacji wynik jest dokładny. Gdy aktualizacje trwają, odczyt nie jest atomową migawką i może nie uwzględnić części zmian.

reset() zeruje tę samą instancję i nic nie zwraca. Używaj go tylko wtedy, gdy wiesz, że żaden wątek nie aktualizuje licznika w trakcie wywołania. Bez równoczesnych aktualizacji sumThenReset() daje taki sam efekt jak odczyt sum(), a następnie reset(): zwraca dotychczasową sumę jako long i zeruje licznik. Nie jest to atomowa granica okresu pomiarowego: gdy aktualizacje zbiegają się z wywołaniem, zwrócony wynik nie musi być ostatnią sumą sprzed wyzerowania.

Przykłady

import java.util.concurrent.atomic.LongAdder;

public class Main {
    public static void main(String[] args) {
        LongAdder requests = new LongAdder();
        LongAdder bytes = new LongAdder();

        for (long size : new long[] {512L, 1024L, 2048L, 3072L, 376L}) {
            requests.increment();
            bytes.add(size);
        }

        System.out.println("Requests: " + requests.sum());
        System.out.println("Bytes: " + bytes.sum());
        System.out.println("Bytes returned by sumThenReset(): " + bytes.sumThenReset());
        System.out.println("Bytes after sumThenReset(): " + bytes.sum());

        requests.reset();
        System.out.println("Requests after reset(): " + requests.sum());
    }
}

Wynik

Requests: 5
Bytes: 7032
Bytes returned by sumThenReset(): 7032
Bytes after sumThenReset(): 0
Requests after reset(): 0

Jeden wątek zlicza pięć żądań i łącznie 7032 bajty. `sumThenReset()` zwraca 7032 i zeruje licznik bajtów; `reset()` zeruje licznik żądań bez zwracania poprzedniej wartości.

Powiązane lekcje

  • Java · Lekcja 31 · Zaawansowany · Wersja: 2

Źródła