CKTIS / Java
requires — zależność modułu
requires — zależność modułu: Dyrektywa requires w module-info.java ustanawia zależność modułu i krawędź czytelności do nazwanego modułu.
Wersja: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Składnia
requiresDyrektywa requires w module-info.java ustanawia zależność modułu i krawędź czytelności do nazwanego modułu.
Użyj requires m dla zwykłej zależności, requires transitive m do propagacji czytelności na klientów oraz requires static m dla zależności wymaganej przy kompilacji, lecz opcjonalnej w czasie wykonania.
requires transitive nie eksportuje automatycznie pakietów, a requires static nie gwarantuje obecności modułu w obrazie runtime; cykle zależności są błędem.
Każdy moduł poza java.base ma domniemaną zależność mandated od java.base; dwa modyfikatory transitive i static mogą wystąpić razem.
Deskryptor rozróżnia requires transitive dla demo.api, requires static dla demo.optional i zwykłe requires dla java.logging.
Przykłady
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()));
}
}
Wynik
demo.api:[TRANSITIVE] demo.optional:[STATIC] java.logging:[]
Deskryptor rozróżnia requires transitive dla demo.api, requires static dla demo.optional i zwykłe requires dla java.logging.