База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

LongAdder: обновяване, прочитане и нулиране

Използвай `LongAdder` за статистика, която се обновява от няколко нишки. Научи кога прочетената сума е точна и защо `sumThenReset()` не поставя атомарна граница между периодите на измерване.

Версия: Java SE 21

Синтаксис

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 поддържа сума от тип long с начална стойност нула. Когато много нишки се конкурират за обновяване, класът може да разпредели обновяванията между няколко вътрешни променливи. Подходящ е за събиране на статистика, а не за координиране на нишки.

increment() добавя 1, както add(1L). add(long x) добавя подадената стойност, която може да е отрицателна. И двата метода имат тип на връщане void. sum() връща сумата като long, без да я променя. Без едновременни обновявания резултатът е точен. В противен случай прочитането не е атомарна снимка на състоянието и може да пропусне някои едновременни обновявания.

reset() нулира същия обект и не връща стойност. Използвай го само когато знаеш, че никоя нишка няма да обновява брояча по време на извикването. Без едновременни обновявания sumThenReset() има същия ефект като sum(), последвано от reset(): връща предишната сума като long и нулира брояча. Методът не поставя атомарна граница между периодите на измерване. Ако има обновявания по време на извикването, върнатата стойност не е непременно последната сума преди нулирането.

Примери

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

Резултат

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

Една нишка преброява пет заявки и общо 7032 байта. `sumThenReset()` връща 7032 и нулира брояча на байтовете; `reset()` нулира брояча на заявките, без да връща предишната му стойност.

Свързани уроци

  • Java · Урок 31 · Напреднало · Версия: 2

Източници