CKTIS / Java
NoSuchFieldException — búsqueda de campo fallida
NoSuchFieldException es una excepción comprobada que se produce cuando una búsqueda no encuentra un campo con el nombre indicado. En la reflexión importa el ámbito de búsqueda: getField busca campos públicos, mientras que getDeclaredField busca campos declarados directamente en el tipo dado.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
public class NoSuchFieldException extends ReflectiveOperationException
new NoSuchFieldException()
new NoSuchFieldException("Field not found")
Class<?> type = Example.class;
type.getField("fieldName");
type.getDeclaredField("fieldName");NoSuchFieldException pertenece a java.lang y extiende ReflectiveOperationException. Es una excepción comprobada: el código debe capturarla o declararla con throws si puede salir del método. Sus constructores son NoSuchFieldException() y NoSuchFieldException(String s); el segundo acepta un mensaje detallado.
Class.getField(String) busca únicamente campos public, incluidos los heredados. Class.getDeclaredField(String) busca campos declarados directamente en el tipo dado, sin importar el modificador de acceso, pero no incluye los heredados. Ambos métodos producen NoSuchFieldException cuando no encuentran un campo dentro de su ámbito de búsqueda. Por tanto, esto no significa necesariamente que el campo no exista en absoluto.
En el ejemplo, balance es private, así que getField("balance") produce la excepción, mientras que getDeclaredField("balance") encuentra el campo. Encontrar un objeto Field no concede por sí mismo permiso para leer o modificar el valor del campo; el ejemplo solo lee su nombre.
Al diagnosticar un fallo, comprueba el nombre del campo, el tipo inspeccionado y si necesitas campos públicos o campos declarados directamente. Captura esta excepción donde la ausencia del campo pueda tratarse de forma adecuada; de lo contrario, propágala.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.