CKTIS / Java
AtomicIntegerFieldUpdater — атомарни актуализации на поле int
AtomicIntegerFieldUpdater предоставя атомарни операции върху полето volatile int на съществуващ обект. Един updater може да се използва за няколко екземпляра на клас, без да е необходим отделен обект AtomicInteger за всяко поле.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
AtomicIntegerFieldUpdater<T> updater = AtomicIntegerFieldUpdater.newUpdater(targetClass, "fieldName"); // targetClass is a Class<T>
int current = updater.get(obj);
boolean changed = updater.compareAndSet(obj, expect, update);AtomicIntegerFieldUpdater<T> от пакета java.util.concurrent.atomic работи с избрано поле volatile int на обекти от тип T. Стойността остава в обекта, а updater може да се споделя между екземпляри. Тези помощни средства позволяват, наред с другото, независими актуализации на полета в конкурентни структури от данни.
AtomicIntegerFieldUpdater.newUpdater(targetClass, "fieldName") свързва updater с поле. Аргументът targetClass е стойност от тип Class<T>. Полето трябва да е нестатично, да е декларирано като volatile int и да е достъпно за кода, който създава updater, според правилата за достъп на Java. Невалидна декларация, име или достъп предизвиква изключение при създаването.
get и compareAndSet са методи на екземпляра и се извикват върху обекта updater. updater.get(obj) прочита полето. updater.compareAndSet(obj, expect, update) записва update само ако текущата стойност е == expect; връща true при успех и false при несъвпадение. Отделното прочитане, последвано от записване, не замества тази операция.
Гаранцията за атомарност обхваща извикванията на compareAndSet и set на същия updater, но не и произволни други промени на полето. Затова не смесвайте независими механизми за актуализиране на споделено състояние. Примерът с една нишка показва успешна и отхвърлена промяна; той не е тест за коректност при конкурентно изпълнение.
Примери
import java.util.concurrent.atomic.AtomicIntegerFieldUpdater;
public class Main {
private volatile int state = 0;
private static final AtomicIntegerFieldUpdater<Main> STATE =
AtomicIntegerFieldUpdater.newUpdater(Main.class, "state");
public static void main(String[] args) {
Main item = new Main();
System.out.println(STATE.get(item));
System.out.println(STATE.compareAndSet(item, 0, 1));
System.out.println(STATE.compareAndSet(item, 0, 2));
System.out.println(STATE.get(item));
}
}Резултат
0 true false 1
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.