Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje