Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

NoSuchFieldException — hledání pole selhalo

NoSuchFieldException je kontrolovaná výjimka vyvolaná tehdy, když hledání nenajde pole se zadaným názvem. Při reflexi záleží na rozsahu hledání: getField hledá veřejná pole, zatímco getDeclaredField hledá pole deklarovaná přímo v daném typu.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

public class NoSuchFieldException extends ReflectiveOperationException

new NoSuchFieldException()
new NoSuchFieldException("Field not found")

Class<?> type = Example.class;
type.getField("fieldName");
type.getDeclaredField("fieldName");

NoSuchFieldException patří do java.lang a dědí z ReflectiveOperationException. Je to kontrolovaná výjimka: pokud může opustit metodu, musí ji kód zachytit nebo deklarovat pomocí throws. Její konstruktory jsou NoSuchFieldException() a NoSuchFieldException(String s); druhý přijímá podrobnou zprávu.

Class.getField(String) hledá pouze pole public, včetně zděděných. Class.getDeclaredField(String) hledá pole deklarovaná přímo v daném typu bez ohledu na modifikátor přístupu, ale nezahrnuje zděděná pole. Obě metody vyvolají NoSuchFieldException, pokud ve svém rozsahu hledání žádné pole nenajdou. Nemusí to tedy znamenat, že pole vůbec neexistuje.

V příkladu je balance typu private, takže getField("balance") vyvolá výjimku, zatímco getDeclaredField("balance") pole najde. Nalezení objektu Field samo o sobě nedává oprávnění číst ani měnit hodnotu pole; příklad čte pouze jeho název.

Při hledání příčiny chyby zkontrolujte název pole, prohlížený typ a to, zda potřebujete veřejná, nebo přímo deklarovaná pole. Výjimku zachyťte tam, kde lze chybějící pole smysluplně zpracovat; jinak ji předejte dál.

Pří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ýsledek

Public field not found
balance

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje