Formations — 1 037 leçons en français

Accueil › Java › Packages, classpath et javadoc

Packages, classpath et javadoc

Organisation et outilsdebutant

Un package regroupe des classes apparentées et évite les collisions de noms. Son nom suit la convention inversée du nom de domaine de l'organisation, tout en minuscules : com.boutique.produit. Cette déclaration doit correspondre exactement à l'arborescence de dossiers du projet :

src/main/java/com/boutique/produit/Produit.java   →  package com.boutique.produit;

Pour utiliser une classe d'un autre package, on l'importe :

package com.boutique.commande;

import com.boutique.produit.Produit;
import static java.util.Comparator.comparing;

public class Commande {
    private List<Produit> produits;
    // ...
}

Évitez l'import avec joker (import com.boutique.produit.*;) : il masque la provenance exacte des classes utilisées et peut créer une ambiguïté si deux packages importés définissent une classe portant le même nom.

Le classpath est la liste des dossiers et fichiers .jar où la JVM cherche les classes à charger à l'exécution. Un outil comme Maven le construit automatiquement à partir des dépendances déclarées ; en ligne de commande, on le fixe avec -cp.

Les termes à connaître

Package

Espace de noms qui regroupe des classes apparentées et évite les collisions de noms. Déclaré en première ligne d'un fichier source (package com.boutique.produit;), il doit correspondre exactement à l'arborescence de dossiers du projet.

import statique

Variante d'import qui importe les membres statiques d'une classe (méthodes ou champs) pour les utiliser sans préfixe. import static java.lang.Math.max; permet d'écrire max(a, b) au lieu de Math.max(a, b).

Classpath

Liste de dossiers et de fichiers .jar dans lesquels la JVM (à l'exécution) et javac (à la compilation) cherchent les classes à charger. Fixé par l'option -cp/-classpath, ou géré automatiquement par un outil de build comme Maven.

ClassNotFoundException

Exception vérifiée levée quand du code tente de charger une classe par son nom à l'exécution (Class.forName("..."), chargement d'un pilote JDBC) et que cette classe est introuvable sur le classpath.

NoClassDefFoundError

Erreur levée par la JVM quand une classe référencée à la compilation (donc présente dans le bytecode) est introuvable ou n'a pas pu être initialisée à l'exécution. Signale presque toujours un classpath incomplet ou différent entre la compilation et l'exécution.

JAR et manifeste

Un .jar est une archive ZIP de classes compilées et de ressources. Son manifeste (META-INF/MANIFEST.MF) peut déclarer Main-Class pour en faire un jar exécutable (java -jar app.jar).

Javadoc

Commentaire de documentation /** ... */ placé juste avant une classe, une méthode ou un champ, avec des balises (@param, @return, @throws…). L'outil javadoc le transforme en pages HTML consultables.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.