Formations — 1 037 leçons en français

Accueil › Java › Le système de modules

Le système de modules

Modules et déploiementavance

Avant Java 9, tout le code d'une application vivait sur un classpath plat : aucune notion de dépendance entre composants, aucun moyen d'exprimer qu'un JAR en dépendait d'un autre, et deux versions différentes de la même bibliothèque pouvaient s'y retrouver sans avertissement (le « JAR hell »). L'encapsulation s'arrêtait au paquet : tout type public était accessible depuis n'importe où, y compris les classes internes du JDK jamais censées être utilisées directement.

Le système de modules (JPMS, Java Platform Module System, JEP 261, JDK 9) répond à ces deux problèmes. Un module se déclare dans module-info.java :

module com.boutique.catalogue {
    requires com.boutique.stock;
    requires transitive java.sql;

    exports com.boutique.catalogue.api;
    opens com.boutique.catalogue.dto to com.fasterxml.jackson.databind;

    uses com.boutique.catalogue.spi.CalculateurRemise;
    provides com.boutique.catalogue.spi.CalculateurRemise
        with com.boutique.catalogue.remise.RemiseStandard;
}

requires déclare une dépendance explicite ; exports rend un package visible aux autres modules ; opens autorise en plus la réflexion profonde sur ce package. Le JDK lui-même est entièrement modulaire (java.base, java.sql, java.xml...), ce qui permet une encapsulation forte de ses classes internes : tenter d'y accéder par réflexion lève désormais une InaccessibleObjectException.

Le chemin de modules (--module-path) coexiste avec le classpath historique : un jar sans module-info.java placé dessus devient un module automatique (nommé d'après le manifeste ou le nom de fichier), étape de transition qui permet d'adopter les modules progressivement sans réécrire tout l'écosystème de dépendances d'un coup.

Les termes à connaître

module-info.java

Fichier de description placé à la racine des sources d'un module. Il déclare son nom, ses dépendances (requires) et ce qu'il expose (exports, opens), compilé en un fichier module-info.class embarqué dans le jar.

requires transitive

Variante de requires qui propage la dépendance aux modules qui dépendent du module courant : si A requires transitive B, alors tout module qui fait requires A lit aussi B sans avoir à le déclarer lui-même.

exports

Rend les types publics d'un package accessibles en compilation et à l'exécution aux autres modules. Un package non exporté reste invisible depuis l'extérieur du module, même si ses classes sont public.

opens

Autorise la réflexion profonde (accès aux membres privés via setAccessible(true)) sur un package, sans forcément l'exporter pour un usage en compilation normale. Indispensable pour les frameworks qui inspectent des classes par réflexion (sérialisation JSON, injection de dépendances).

uses / provides

Déclarations du mécanisme de services du module system : uses Service indique qu'un module consomme une implémentation via ServiceLoader, provides Service with Impl indique qu'un module fournit une implémentation, sans lien de compilation direct entre les deux.

Module automatique

Jar sans module-info.java placé sur le chemin de modules (et non le classpath). La JVM lui attribue un nom dérivé du manifeste (Automatic-Module-Name) ou du nom de fichier, l'expose en lecture vers tous les autres modules, et lui laisse lire tous les autres modules : étape de migration progressive.

Module non nommé (unnamed module)

Ensemble de tout ce qui est chargé depuis le classpath classique. Il lit tous les autres modules, mais aucun module nommé ne peut le lire explicitement : c'est le mode de fonctionnement historique, toujours disponible pour la compatibilité.

InaccessibleObjectException

Exception non vérifiée levée à l'exécution quand du code appelle setAccessible(true) sur un membre d'un package qui n'est ni ouvert (opens) ni exporté au module appelant. Signale une violation de l'encapsulation forte imposée par le module system.

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.