Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

NoSuchFieldException — échec de la recherche d’un champ

NoSuchFieldException est une exception contrôlée déclenchée lorsqu’une recherche ne trouve aucun champ portant le nom indiqué. En réflexion, la portée de recherche compte : getField cherche les champs publics, tandis que getDeclaredField cherche ceux déclarés directement dans le type donné.

Version : 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 appartient à java.lang et hérite de ReflectiveOperationException. C’est une exception contrôlée : le code doit la capturer ou la déclarer avec throws si elle peut remonter hors de la méthode. Ses constructeurs sont NoSuchFieldException() et NoSuchFieldException(String s) ; le second accepte un message détaillé.

Class.getField(String) recherche uniquement les champs public, y compris les champs hérités. Class.getDeclaredField(String) recherche les champs déclarés directement dans le type donné, quel que soit leur modificateur d’accès, mais exclut les champs hérités. Les deux méthodes déclenchent NoSuchFieldException si elles ne trouvent aucun champ dans leur portée de recherche. Cela ne signifie donc pas nécessairement que le champ n’existe pas du tout.

Dans l’exemple, balance est private : getField("balance") déclenche donc l’exception, tandis que getDeclaredField("balance") trouve le champ. Le fait de trouver un objet Field ne donne pas à lui seul le droit de lire ou de modifier la valeur du champ ; l’exemple ne lit que son nom.

Pour diagnostiquer un échec, vérifiez le nom du champ, le type examiné et si vous avez besoin des champs publics ou de ceux déclarés directement. Capturez cette exception là où l’absence du champ peut être traitée de façon pertinente ; sinon, laissez-la remonter.

Exemples

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

Résultat

Public field not found
balance

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources