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'
importqui 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'écriremax(a, b)au lieu deMath.max(a, b).- Classpath
Liste de dossiers et de fichiers
.jardans lesquels la JVM (à l'exécution) etjavac(à 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
.jarest une archive ZIP de classes compilées et de ressources. Son manifeste (META-INF/MANIFEST.MF) peut déclarerMain-Classpour 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'outiljavadocle transforme en pages HTML consultables.
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.