CKTIS / Java
NoSuchFieldException — fehlgeschlagene Feldsuche
NoSuchFieldException ist eine geprüfte Ausnahme, die ausgelöst wird, wenn eine Suche kein Feld mit dem angegebenen Namen findet. Bei der Reflection ist der Suchbereich entscheidend: getField sucht öffentliche Felder, getDeclaredField dagegen direkt im angegebenen Typ deklarierte Felder.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
public class NoSuchFieldException extends ReflectiveOperationException
new NoSuchFieldException()
new NoSuchFieldException("Field not found")
Class<?> type = Example.class;
type.getField("fieldName");
type.getDeclaredField("fieldName");NoSuchFieldException gehört zu java.lang und erweitert ReflectiveOperationException. Sie ist eine geprüfte Ausnahme: Wenn sie eine Methode verlassen kann, muss der Code sie abfangen oder mit throws deklarieren. Die Konstruktoren sind NoSuchFieldException() und NoSuchFieldException(String s); der zweite nimmt eine Detailnachricht entgegen.
Class.getField(String) sucht nur nach public-Feldern, einschließlich geerbter Felder. Class.getDeclaredField(String) sucht unabhängig vom Zugriffsmodifikator nach Feldern, die direkt im angegebenen Typ deklariert sind, jedoch nicht nach geerbten Feldern. Beide Methoden lösen NoSuchFieldException aus, wenn sie in ihrem jeweiligen Suchbereich kein Feld finden. Das bedeutet also nicht unbedingt, dass das Feld überhaupt nicht existiert.
Im Beispiel ist balance private, daher löst getField("balance") die Ausnahme aus, während getDeclaredField("balance") das Feld findet. Ein gefundenes Field-Objekt gewährt für sich allein keine Berechtigung, den Feldwert zu lesen oder zu ändern; das Beispiel liest nur den Namen.
Prüfe bei der Fehlersuche den Feldnamen, den untersuchten Typ und ob du öffentliche oder direkt deklarierte Felder benötigst. Fange die Ausnahme dort ab, wo sich ein fehlendes Feld sinnvoll behandeln lässt; andernfalls gib sie weiter.
Beispiele
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()
);
}
}Ergebnis
Public field not found balance
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.