CKTIS / Java
NoSuchFieldException — hľadanie poľa zlyhalo
NoSuchFieldException je kontrolovaná výnimka, ktorá sa vyvolá, keď vyhľadávanie nenájde pole so zadaným názvom. Pri reflexii záleží na rozsahu vyhľadávania: getField hľadá verejné polia, zatiaľ čo getDeclaredField hľadá polia deklarované priamo v danom type.
Verzia: 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 patrí do java.lang a dedí z ReflectiveOperationException. Je to kontrolovaná výnimka: ak môže opustiť metódu, kód ju musí zachytiť alebo deklarovať pomocou throws. Jej konštruktory sú NoSuchFieldException() a NoSuchFieldException(String s); druhý prijíma podrobnú správu.
Class.getField(String) hľadá iba polia public, vrátane zdedených. Class.getDeclaredField(String) hľadá polia deklarované priamo v danom type bez ohľadu na modifikátor prístupu, ale nezahŕňa zdedené polia. Obe metódy vyvolajú NoSuchFieldException, ak vo svojom rozsahu vyhľadávania pole nenájdu. Nemusí to teda znamenať, že pole vôbec neexistuje.
V príklade je balance typu private, preto getField("balance") vyvolá výnimku, zatiaľ čo getDeclaredField("balance") pole nájde. Nájdenie objektu Field samo osebe neposkytuje oprávnenie čítať ani meniť hodnotu poľa; príklad číta iba jeho názov.
Pri diagnostike chyby skontrolujte názov poľa, skúmaný typ a to, či potrebujete verejné alebo priamo deklarované polia. Výnimku zachyťte tam, kde sa chýbajúce pole dá zmysluplne spracovať; inak ju odovzdajte ďalej.
Príklady
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()
);
}
}Výsledok
Public field not found balance
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.