CKTIS / Java
Moduły i ich granice w Javie
Moduły i ich granice w Javie: System modułów Javy grupuje pakiety w nazwanym module opisanym przez module-info.java, a requires ustala czytelność, exports dostęp do typów i opens głęboką refleksję.
Wersja: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Składnia
modulesSystem modułów Javy grupuje pakiety w nazwanym module opisanym przez module-info.java, a requires ustala czytelność, exports dostęp do typów i opens głęboką refleksję.
Używaj exports dla publicznego API, qualified exports dla wybranych odbiorców oraz uses/provides z ServiceLoader do odwrócenia zależności między modułami.
Umieszczenie biblioteki na module path może ujawnić brak requires, split packages lub refleksję kończącą się InaccessibleObjectException; classpath trafia do modułu nienazwanego.
requires transitive przekazuje czytelność konsumentom, requires static jest obowiązkowe przy kompilacji lecz opcjonalne w runtime, a open module otwiera wszystkie pakiety do refleksji.
Zbudowany ModuleDescriptor wypisuje name=demo.app, requires-logging=true, exports-api=true, opens-internal=true i uses-runnable=true, potwierdzając cztery różne dyrektywy modułu.
Przykłady
import java.lang.module.ModuleDescriptor;
public class Main {
public static void main(String[] args) {
var descriptor = ModuleDescriptor.newModule("demo.app")
.requires("java.logging")
.exports("demo.api")
.opens("demo.internal")
.uses(Runnable.class.getName())
.build();
System.out.println("name=" + descriptor.name());
System.out.println("requires-logging=" + descriptor.requires().stream()
.anyMatch(r -> r.name().equals("java.logging")));
System.out.println("exports-api=" + descriptor.exports().stream()
.anyMatch(e -> e.source().equals("demo.api")));
System.out.println("opens-internal=" + descriptor.opens().stream()
.anyMatch(o -> o.source().equals("demo.internal")));
System.out.println("uses-runnable=" + descriptor.uses().contains("java.lang.Runnable"));
}
}
Wynik
name=demo.app requires-logging=true exports-api=true opens-internal=true uses-runnable=true
Zbudowany ModuleDescriptor wypisuje name=demo.app, requires-logging=true, exports-api=true, opens-internal=true i uses-runnable=true, potwierdzając cztery różne dyrektywy modułu.