CKTIS / Java
NoSuchFieldException — nieudane wyszukiwanie pola
NoSuchFieldException to wyjątek kontrolowany zgłaszany, gdy wyszukiwanie pola o podanej nazwie nie znajduje wyniku. Przy refleksji znaczenie ma zakres wyszukiwania: getField szuka pól publicznych, a getDeclaredField pól zadeklarowanych bezpośrednio w danym typie.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
public class NoSuchFieldException extends ReflectiveOperationException
new NoSuchFieldException()
new NoSuchFieldException("Field not found")
Class<?> type = Example.class;
type.getField("fieldName");
type.getDeclaredField("fieldName");NoSuchFieldException z pakietu java.lang dziedziczy po ReflectiveOperationException. Jest wyjątkiem kontrolowanym: kod musi go przechwycić albo zadeklarować przez throws, jeśli może on opuścić metodę. Dostępne są konstruktory NoSuchFieldException() oraz NoSuchFieldException(String s); drugi przyjmuje komunikat szczegółowy.
Class.getField(String) wyszukuje wyłącznie pola public, uwzględniając pola odziedziczone. Class.getDeclaredField(String) wyszukuje pola zadeklarowane bezpośrednio w danym typie, niezależnie od modyfikatora dostępu, ale nie pola odziedziczone. Obie metody zgłaszają NoSuchFieldException, gdy nie znajdą pola w swoim zakresie wyszukiwania. Nie musi to więc oznaczać, że pole w ogóle nie istnieje.
W przykładzie balance jest polem private, dlatego getField("balance") kończy się wyjątkiem, a getDeclaredField("balance") znajduje pole. Samo znalezienie obiektu Field nie nadaje uprawnień do odczytu ani zmiany wartości pola; przykład odczytuje tylko jego nazwę.
Podczas diagnozowania sprawdź nazwę pola, badany typ oraz to, czy potrzebujesz pól publicznych, czy zadeklarowanych bezpośrednio. Przechwytuj ten wyjątek tam, gdzie brak pola można sensownie obsłużyć; w przeciwnym razie przekaż go wyżej.
Przykłady
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()
);
}
}Wynik
Public field not found balance
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.