Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

AtomicIntegerFieldUpdater — atualizações atómicas de um campo int

AtomicIntegerFieldUpdater disponibiliza operações atómicas sobre o campo volatile int de um objeto existente. Um único updater pode servir várias instâncias de uma classe, sem ser necessário criar um objeto AtomicInteger separado para cada campo.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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>, do pacote java.util.concurrent.atomic, opera sobre um campo volatile int selecionado de objetos do tipo T. O valor permanece no objeto e o updater pode ser partilhado entre instâncias. Estes utilitários permitem, entre outras coisas, atualizações independentes de campos em estruturas de dados concorrentes.

AtomicIntegerFieldUpdater.newUpdater(targetClass, "fieldName") associa um updater a um campo. O argumento targetClass é um valor do tipo Class<T>. O campo tem de ser um volatile int não estático e estar acessível ao código que cria o updater, de acordo com as regras de acesso de Java. Uma declaração, um nome ou um acesso inválido provoca uma exceção durante a criação.

get e compareAndSet são métodos de instância chamados no updater. updater.get(obj) lê o campo. updater.compareAndSet(obj, expect, update) escreve update apenas se o valor atual for == expect; devolve true em caso de sucesso e false se não houver correspondência. Uma leitura seguida de uma escrita separada não substitui esta operação.

A garantia de atomicidade abrange as chamadas a compareAndSet e set do mesmo updater, não quaisquer outras modificações do campo. Por isso, evita combinar mecanismos de atualização independentes para um estado partilhado. O exemplo de uma única thread mostra uma alteração bem-sucedida e outra rejeitada; não é um teste de correção em concorrência.

Exemplos

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

Resultado

0
true
false
1

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes