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.