Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła