Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti