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

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници