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

CKTIS / Java

requires — dépendance de module

requires — dépendance de module: La directive requires de module-info.java établit une dépendance et une relation de lisibilité vers un module nommé.

Version : Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Syntaxe

requires

La directive requires de module-info.java établit une dépendance et une relation de lisibilité vers un module nommé.

Utilise requires m normalement, requires transitive m pour propager la lisibilité aux clients et requires static m pour une dépendance de compilation facultative à l’exécution.

requires transitive n’exporte pas automatiquement les packages et requires static ne garantit pas le module dans l’image runtime ; les cycles sont interdits.

Tout module sauf java.base possède une dépendance mandated implicite vers java.base ; transitive et static peuvent être combinés.

Le descripteur distingue requires transitive pour demo.api, requires static pour demo.optional et requires ordinaire pour java.logging.

Exemples

import java.lang.module.ModuleDescriptor;
import java.util.Comparator;
import java.util.Set;

public class Main {
    public static void main(String[] args) {
        var descriptor = ModuleDescriptor.newModule("demo.app")
                .requires("java.logging")
                .requires(Set.of(ModuleDescriptor.Requires.Modifier.TRANSITIVE), "demo.api")
                .requires(Set.of(ModuleDescriptor.Requires.Modifier.STATIC), "demo.optional")
                .build();
        descriptor.requires().stream()
                .filter(requirement -> !requirement.name().equals("java.base"))
                .sorted(Comparator.comparing(ModuleDescriptor.Requires::name))
                .forEach(requirement -> System.out.println(requirement.name() + ":" + requirement.modifiers()));
    }
}

Résultat

demo.api:[TRANSITIVE]
demo.optional:[STATIC]
java.logging:[]

Le descripteur distingue requires transitive pour demo.api, requires static pour demo.optional et requires ordinaire pour java.logging.

Sources