CKTIS / Java
AtomicLong – atomický čítač typu long
AtomicLong uchovává jednu hodnotu typu long a nabízí atomické aktualizace sdílené mezi vlákny. Metoda incrementAndGet() zvýší hodnotu o jedna a vrátí aktualizovaný výsledek.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
AtomicLong counter = new AtomicLong(0L);
long updated = counter.incrementAndGet();java.util.concurrent.atomic.AtomicLong je měnitelný objekt uchovávající jednu hodnotu typu long. Hodí se pro sdílené čítače a pořadová čísla. Konstruktor new AtomicLong() nastaví počáteční hodnotu na nulu; new AtomicLong(0L) tuto hodnotu zadá výslovně. Nejde o náhradu neměnného objektu Long.
AtomicLong.incrementAndGet() provede čtení, zvýšení o jedna a zápis jako jednu atomickou operaci a poté vrátí aktualizovanou hodnotu typu long. Naproti tomu getAndIncrement() vrátí hodnotu před zvýšením. get() přečte aktuální hodnotu.
Atomicita jedné metody se nevztahuje na libovolnou posloupnost volání: counter.set(counter.get() + 1) není atomické zvýšení. Jiné vlákno může čítač změnit mezi čtením a zápisem. Pro tuto aktualizaci použijte counter.incrementAndGet(); samotný čítač také nechrání invarianty zahrnující více proměnných.
V příkladu dvě vlákna každé zvýší tentýž čítač 1000krát. Obě volání join() předcházejí čtení výsledku, takže pořadí provádění vláken očekávaný výstup 2000 nezmění. Rozsah dokumentace: Java SE 21; běhové prostředí repozitáře ani produkční běhové prostředí nejsou potvrzeny.
Příklady
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());
}
}Výsledek
2000
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.