CKTIS / Java
AtomicLong — atomowy licznik typu long
AtomicLong przechowuje pojedynczą wartość long i udostępnia atomowe aktualizacje współdzielone przez wątki. Metoda incrementAndGet() zwiększa wartość o jeden i zwraca wynik po zmianie.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
AtomicLong counter = new AtomicLong(0L);
long updated = counter.incrementAndGet();java.util.concurrent.atomic.AtomicLong to mutowalny obiekt przechowujący pojedynczą wartość long. Nadaje się do współdzielonych liczników i numerów sekwencyjnych. Konstruktor new AtomicLong() ustawia początkowo zero; new AtomicLong(0L) podaje tę wartość jawnie. Nie jest to zamiennik niemutowalnego obiektu Long.
AtomicLong.incrementAndGet() wykonuje odczyt, zwiększenie o jeden i zapis jako jedną atomową operację, a następnie zwraca nową wartość typu long. Natomiast getAndIncrement() zwraca wartość sprzed zwiększenia. get() odczytuje bieżącą wartość.
Atomowość pojedynczej metody nie obejmuje dowolnej sekwencji wywołań: counter.set(counter.get() + 1) nie jest atomowym zwiększeniem. Inny wątek może zmienić licznik między odczytem a zapisem. Do takiej aktualizacji użyj counter.incrementAndGet(); sam licznik nie chroni też niezmienników obejmujących kilka zmiennych.
W przykładzie dwa wątki zwiększają ten sam licznik po 1000 razy. Oba wywołania join() poprzedzają odczyt wyniku, więc kolejność wykonywania wątków nie zmienia oczekiwanego wyjścia 2000. Zakres dokumentacji: Java SE 21; środowisko uruchomieniowe repozytorium ani środowisko produkcyjne nie zostały potwierdzone.
Przykłady
import java.util.concurrent.atomic.AtomicLong;
public class Main {
public static void main(String[] args) throws InterruptedException {
AtomicLong counter = new AtomicLong(0L);
Runnable work = () -> {
for (int i = 0; i < 1000; i++) {
counter.incrementAndGet();
}
};
Thread first = new Thread(work);
Thread second = new Thread(work);
first.start();
second.start();
first.join();
second.join();
System.out.println(counter.get());
}
}Wynik
2000
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.