Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes