Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

LongAdder: aktualizace, čtení a vynulování

Používej `LongAdder` pro statistiky aktualizované více vlákny. Zjisti, kdy je přečtený součet přesný a proč `sumThenReset()` netvoří atomickou hranici mezi intervaly měření.

Verze: Java SE 21

Syntaxe

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 udržuje součet typu long, který začíná na nule. Když o aktualizaci soupeří mnoho vláken, může aktualizace rozložit mezi více vnitřních proměnných. Hodí se pro sběr statistik, ne pro koordinaci vláken.

increment() přičte 1 stejně jako add(1L). add(long x) přičte zadanou hodnotu, která může být i záporná. Obě metody mají návratový typ void. sum() vrátí součet jako long, aniž by ho změnila. Bez souběžných aktualizací je výsledek přesný. Jinak čtení neposkytuje atomický snímek a může některé souběžné aktualizace vynechat.

reset() vynuluje tutéž instanci a nic nevrací. Používej tuto metodu jen tehdy, když víš, že během jejího volání žádné vlákno čítač neaktualizuje. Bez souběžných aktualizací má sumThenReset() stejný účinek jako volání sum() a pak reset(): vrátí dosavadní součet jako long a čítač vynuluje. Netvoří atomickou hranici mezi intervaly měření. Pokud se aktualizace překrývají s voláním, vrácená hodnota nemusí odpovídat poslednímu součtu před vynulováním.

Příklady

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

Výsledek

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

Jedno vlákno napočítá pět požadavků a celkem 7032 bajtů. `sumThenReset()` vrátí 7032 a vynuluje čítač bajtů; `reset()` vynuluje čítač požadavků, aniž by vrátila jeho předchozí hodnotu.

Související lekce

  • Java · Lekce 31 · Pokročilá · Verze: 2

Zdroje