NullPointerException s sont des exceptions qui se produisent lorsque vous essayez d'utiliser une référence qui pointe à aucun endroit dans la mémoire (null) comme s'il référençait un objet. Appeler une méthode sur une référence nulle ou essayer d'accéder à un champ d'une référence nulle déclenchera un NullPointerException . Ce sont les plus communs, mais d'autres moyens sont énumérés sur la NullPointerException javadoc page.

probablement le code d'exemple le plus rapide que j'ai pu trouver pour illustrer un NullPointerException serait:

public class Example {

    public static void main(String[] args) {
        Object obj = null;
        obj.hashCode();
    }

}

sur la première ligne à l'intérieur de main , je mets explicitement Object référence obj égale à null . Cela signifie que j'ai une référence, mais elle ne montre aucun objet. Après cela, j'essaie de traiter la référence comme si elle pointe vers un objet en appelant une méthode sur elle. Il en résulte un NullPointerException parce qu'il n'y a pas de code à exécuter dans l'emplacement que la référence pointe.

(c'est un détail technique, mais je pense qu'il vaut la peine de le mentionner: une référence qui pointe vers nul n'est pas la même chose qu'un pointeur C qui pointe vers un emplacement mémoire invalide. Un pointeur nul ne pointe littéralement pas n'importe où , ce qui est subtilement différent de pointer vers un endroit qui se trouve être invalide.)

Qu'est-ce qu'une NullPointerException?

Un bon endroit pour commencer est le Javadoc . Ils ont ceci couvert:

lancé lorsqu'une application tente d'utiliser null dans un cas où un l'objet est nécessaire. Il s'agit notamment de:

• appelant la méthode d'instance d'un objet nul.
• accès ou modification du champ d'un objet nul.
• prenant la longueur de null comme s'il s'agissait d'un tableau.
• accéder ou modifier les fentes de null comme si c'était un tableau.
• lancer null comme si c'était une valeur Lancable.

les demandes doivent mentionner les instances de cette classe pour indiquer les autres l'usage illicite de l'objet nul.

il est également le cas que si vous tentez d'utiliser un null référence avec synchronized , qui lancera également cette exception, selon le JLS :

SynchronizedStatement:
    synchronized ( Expression ) Block

• Sinon, si la valeur de L'Expression est nulle, un NullPointerException est lancé.

Comment puis-je le réparer?

donc vous avez un NullPointerException . Comment voulez-vous résoudre ce problème? Prenons un exemple simple qui jette un NullPointerException :

public class Printer {
    private String name;

    public void setName(String name) {
        this.name = name;
    }

    public void print() {
        printString(name);
    }

    private void printString(String s) {
        System.out.println(s + " (" + s.length() + ")");
    }

    public static void main(String[] args) {
        Printer printer = new Printer();
        printer.print();
    }
}

identifiez les valeurs nulles

la première étape consiste à identifier exactement les valeurs qui causent l'exception . Pour cela, nous avons besoin de faire un peu de débogage. Il est important d'apprendre à lire un stacktrace . Cela vous montrera où l'exception a été jetée:

Exception in thread "main" java.lang.NullPointerException
    at Printer.printString(Printer.java:13)
    at Printer.print(Printer.java:9)
    at Printer.main(Printer.java:19)

ici, nous voyons que l'exception est jetée sur la ligne 13 (dans le printString ). Regardez la ligne et vérifiez quelles valeurs sont nulles par l'ajout de l'enregistrement des déclarations ou à l'aide d'un débogueur . Nous découvrons que s est nul, et appeler la méthode length sur elle jette l'exception. Nous pouvons voir que le programme cesse de lancer l'exception lorsque s.length() est supprimé de la méthode.

Trace où ces valeurs proviennent de

vérifiez ensuite d'où vient cette valeur. En suivant les appelants de la méthode, nous voyons que s est transmis avec printString(name) dans le print() , et this.name est null.

Trace où ces valeurs doivent être réglées

Où est fixé this.name ? Dans la méthode setName(String) . Avec un peu plus de débogage, nous pouvons voir que cette méthode n'est pas appelée à tous. Si la méthode a été appelée, assurez-vous de vérifier le ordre que ces méthodes sont appelées, et la méthode d'ensemble n'est pas appelé après la méthode d'impression.

cela suffit pour nous donner une solution: ajouter un appel à printer.setName() avant d'appeler printer.print() .

autres dispositifs fixes

la variable peut avoir une valeur par défaut (et setName peut empêcher qu'elle soit définie à null):

private String name = "";

soit la méthode print soit la méthode printString peut cochez la case "null , par exemple:

printString((name == null) ? "" : name);

ou vous pouvez concevoir la classe de sorte que name a toujours une valeur non nulle :

public class Printer {
    private final String name;

    public Printer(String name) {
        this.name = Objects.requireNonNull(name);
    }

    public void print() {
        printString(name);
    }

    private void printString(String s) {
        System.out.println(s + " (" + s.length() + ")");
    }

    public static void main(String[] args) {
        Printer printer = new Printer("123");
        printer.print();
    }
}

Voir aussi:

• eviter"!= déclarations nulles en Java?

Je ne trouve toujours pas le problème

Si vous avez essayé de déboguer le problème et n'ont toujours pas de solution, vous pouvez poster une question pour plus d'aide, mais assurez-vous d'inclure ce que vous avez essayé jusqu'à présent. À tout le moins, inclut la chaîne de caractères dans la question, et marque les numéros de ligne importants dans le code. Aussi, essayer de simplifier le code d'abord (voir SSCCE ).

Question: Qu'est-ce qui cause un NullPointerException (NPE)?

comme vous devez le savoir, les types Java sont divisés en types primitifs ( boolean , int , etc.) et types de référence . Les types de référence en Java vous permettent d'utiliser la valeur spéciale null qui est la façon Java de dire "aucun objet".

A NullPointerException est lancé à l'exécution chaque fois que votre programme tente d'utiliser un null comme si c'était une vraie référence. Par exemple, si vous écrivez ceci:

public class Test {
    public static void main(String[] args) {
        String foo = null;
        int length = foo.length();   // HERE
    }
}

l'énoncé étiqueté" ici "va tenter d'exécuter la méthode length() sur une référence null , et cela lancera un NullPointerException .

il y a plusieurs façons d'utiliser une valeur null qui donnera un résultat NullPointerException . En fait, les seules choses que vous peut faire avec un null sans la cause d'une NPE sont:

• l'affecter à une variable de référence ou de lire à partir d'une variable de référence,
• l'attribuer à un élément de tableau ou de lire à partir d'un élément de tableau (à condition que la matrice de référence lui-même est non-nulle!),
• passer en tant que paramètre ou le retourner comme un résultat, ou
• tester en utilisant les opérateurs == ou != , ou instanceof .

Question: Comment lire la NPE stacktrace?

supposons que je compile et exécute le programme ci-dessus:

$ javac Test.java 
$ java Test
Exception in thread "main" java.lang.NullPointerException
    at Test.main(Test.java:4)
$

première observation: la compilation réussit! Le problème dans le programme n'est pas une erreur de compilation. C'est une erreur runtime . (Certains IDEs peuvent prévenir votre programme de toujours jeter une exception ... mais pas le compilateur standard javac .)

deuxième observation: quand je lance le programme, il affiche deux lignes de "charabia". faux!! ce n'est pas charabia. C'est un stacktrace ... et il fournit informations vitales qui vous aideront à traquer l'erreur dans votre code, si vous prenez le temps de lire attentivement.

Alors, regardons ce qu'il dit:

Exception in thread "main" java.lang.NullPointerException

La première ligne de la trace de la pile vous dit un certain nombre de choses:

• il vous indique le nom du fil Java dans lequel l'exception a été jetée. Pour un programme simple avec un fil (comme celui-ci), il sera "principal". Passons sur ...
• il vous indique le nom complet de l'exception qui a été lancée; i.e. java.lang.NullPointerException .
• si l'exception a un message d'erreur associé, qui sera affiché après le nom de l'exception. NullPointerException est inhabituel à cet égard, parce qu'il a rarement une message d'erreur.

la deuxième ligne est la plus importante pour diagnostiquer une NPE.

at Test.main(Test.java:4)

cela nous dit un certain nombre de choses:

• "au Test.main "dit que nous étions dans la méthode main de la classe Test .
• " Test.java: 4" donne le nom du fichier source de la classe, et il nous dit que la déclaration où cela s'est produit est dans la ligne 4 du fichier.

si vous comptez les lignes dans le fichier ci-dessus, la ligne 4 est celle que j'ai étiqueté avec le commentaire "ici".

notez que dans un exemple plus compliqué, il y aura beaucoup de lignes dans la trace de la pile NPE. Mais vous pouvez être sûr que la deuxième ligne (la première ligne "at") vous dira où le NPE a été lancé ¹ .

en bref, la trace de la pile nous indiquera sans ambiguïté quelle déclaration de le programme a lancé le NPE.

^{1-pas tout à fait vrai. Il y a des choses qu'on appelle des exceptions imbriquées...}

Question: Comment retrouver la cause de l'exception NPE dans mon code?

C'est la partie difficile. La réponse courte est d'appliquer l'inférence logique aux preuves fournies par la trace de la pile, le code source et la documentation pertinente de L'API.

Let's illustrer avec l'exemple simple (ci-dessus). Nous commençons par regarder la ligne que la trace de la pile nous a indiqué est où le NPE s'est produit:

int length = foo.length(); // HERE

comment ça peut lancer un NPE?

en fait, il n'y a qu'un seul moyen: il ne peut se produire que si foo a la valeur null . Nous essayons ensuite d'exécuter la méthode length() sur null et .... BANG!

mais (je vous entends dire) que faire si le NPE a été jeté dans l'appel de méthode length() ?

si c'était le cas, la trace de la pile serait différente. La première ligne" at "dirait que l'exception a été jetée dans une certaine ligne dans la classe java.lang.String , et la ligne 4 de Test.java serait la deuxième ligne" at".

alors d'où vient ce null ? Dans ce cas, il est évident, et il est évident que nous devons faire pour le réparer. (Attribuez une valeur non nulle à foo .)

OK, donc essayons un exemple un peu plus délicat. Cela nécessitera une déduction logique de .

public class Test {

    private static String[] foo = new String[2];

    private static int test(String[] bar, int pos) {
        return bar[pos].length();
    }

    public static void main(String[] args) {
        int length = test(foo, 1);
    }
}

$ javac Test.java 
$ java Test
Exception in thread "main" java.lang.NullPointerException
    at Test.test(Test.java:6)
    at Test.main(Test.java:10)
$ 

return args[pos].length();

int length = test(foo, 1);

private static String[] foo = new String[2];