CKTIS / Java
NoSuchFieldException — ricerca del campo non riuscita
NoSuchFieldException è un’eccezione controllata che viene generata quando una ricerca non trova un campo con il nome specificato. Con la reflection conta l’ambito di ricerca: getField cerca i campi pubblici, mentre getDeclaredField cerca quelli dichiarati direttamente nel tipo indicato.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
public class NoSuchFieldException extends ReflectiveOperationException
new NoSuchFieldException()
new NoSuchFieldException("Field not found")
Class<?> type = Example.class;
type.getField("fieldName");
type.getDeclaredField("fieldName");NoSuchFieldException appartiene a java.lang ed estende ReflectiveOperationException. È un’eccezione controllata: se può uscire dal metodo, il codice deve intercettarla oppure dichiararla con throws. I suoi costruttori sono NoSuchFieldException() e NoSuchFieldException(String s); il secondo accetta un messaggio dettagliato.
Class.getField(String) cerca solo campi public, compresi quelli ereditati. Class.getDeclaredField(String) cerca i campi dichiarati direttamente nel tipo indicato, a prescindere dal modificatore di accesso, ma esclude quelli ereditati. Entrambi i metodi generano NoSuchFieldException se non trovano un campo nel rispettivo ambito di ricerca. Questo quindi non significa necessariamente che il campo non esista affatto.
Nell’esempio, balance è private, perciò getField("balance") genera l’eccezione, mentre getDeclaredField("balance") trova il campo. Trovare un oggetto Field non concede di per sé il permesso di leggere o modificare il valore del campo; l’esempio ne legge solo il nome.
Per diagnosticare un errore, controlla il nome del campo, il tipo esaminato e se ti servono campi pubblici o dichiarati direttamente. Intercetta questa eccezione nel punto in cui l’assenza del campo può essere gestita in modo appropriato; altrimenti propagala.
Esempi
public class Main {
static class Account {
private int balance;
}
public static void main(String[] args) throws NoSuchFieldException {
try {
Account.class.getField("balance");
System.out.println("Public field found");
} catch (NoSuchFieldException e) {
System.out.println("Public field not found");
}
System.out.println(
Account.class.getDeclaredField("balance").getName()
);
}
}Risultato
Public field not found balance
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.