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.