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