KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

AtomicLong — een atomaire long-teller

AtomicLong bevat één long-waarde en biedt atomaire updates die door threads worden gedeeld. De methode incrementAndGet() verhoogt de waarde met één en geeft het bijgewerkte resultaat terug.

Versie: Java SE 21; repository runtime, production runtime not attested

Syntax

AtomicLong counter = new AtomicLong(0L);
long updated = counter.incrementAndGet();

java.util.concurrent.atomic.AtomicLong is een muteerbaar object met één waarde van het type long. Het is geschikt voor gedeelde tellers en volgnummers. De constructor new AtomicLong() stelt de beginwaarde in op nul; new AtomicLong(0L) geeft die waarde expliciet op. Het is geen vervanging voor een onveranderlijk Long-object.

AtomicLong.incrementAndGet() voert het lezen, met één verhogen en schrijven uit als één atomaire bewerking en geeft daarna de bijgewerkte long-waarde terug. getAndIncrement() geeft daarentegen de waarde van vóór de verhoging terug. get() leest de huidige waarde.

De atomiciteit van één methode geldt niet voor een willekeurige reeks aanroepen: counter.set(counter.get() + 1) is geen atomaire verhoging. Een andere thread kan de teller tussen het lezen en schrijven wijzigen. Gebruik counter.incrementAndGet() voor die update; de teller beschermt op zichzelf ook geen invarianten waarbij meerdere variabelen betrokken zijn.

In het voorbeeld verhogen twee threads dezelfde teller elk 1000 keer. Beide aanroepen van join() vinden plaats voordat het resultaat wordt gelezen, zodat de uitvoervolgorde van de threads de verwachte uitvoer 2000 niet verandert. Documentatiebereik: Java SE 21; de runtime van de repository en de productieomgeving zijn niet bevestigd.

Voorbeelden

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());
    }
}

Resultaat

2000

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen