Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

NoSuchFieldException — falha na pesquisa de um campo

NoSuchFieldException é uma exceção verificada lançada quando uma pesquisa não encontra um campo com o nome indicado. Na reflexão, o âmbito da pesquisa é importante: getField procura campos públicos, enquanto getDeclaredField procura campos declarados diretamente no tipo indicado.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

public class NoSuchFieldException extends ReflectiveOperationException

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

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

NoSuchFieldException pertence a java.lang e estende ReflectiveOperationException. É uma exceção verificada: se puder sair do método, o código tem de a capturar ou declarar com throws. Os seus construtores são NoSuchFieldException() e NoSuchFieldException(String s); o segundo aceita uma mensagem detalhada.

Class.getField(String) procura apenas campos public, incluindo os herdados. Class.getDeclaredField(String) procura campos declarados diretamente no tipo indicado, independentemente do modificador de acesso, mas exclui os campos herdados. Ambos os métodos lançam NoSuchFieldException quando não encontram um campo no respetivo âmbito de pesquisa. Isto não significa necessariamente que o campo não exista de todo.

No exemplo, balance é private, pelo que getField("balance") lança a exceção, enquanto getDeclaredField("balance") encontra o campo. Encontrar um objeto Field não concede, por si só, autorização para ler ou alterar o valor do campo; o exemplo lê apenas o seu nome.

Ao diagnosticar uma falha, verifica o nome do campo, o tipo inspecionado e se precisas de campos públicos ou declarados diretamente. Captura esta exceção onde a ausência do campo possa ser tratada de forma adequada; caso contrário, propaga-a.

Exemplos

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()
        );
    }
}

Resultado

Public field not found
balance

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes