CKTIS / Java
Modules and their boundaries in Java
Modules and their boundaries in Java: The Java module system groups packages in a named module described by module-info.java; requires controls readability, exports type access, and opens deep reflection.
Version: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Syntax
modulesThe Java module system groups packages in a named module described by module-info.java; requires controls readability, exports type access, and opens deep reflection.
Use exports for a public API, qualified exports for selected consumers, and uses/provides with ServiceLoader to invert dependencies between modules.
Moving a library to the module path can expose missing requires, split packages, or reflection ending in InaccessibleObjectException; class-path code belongs to an unnamed module.
requires transitive passes readability to consumers, requires static is mandatory at compile time but optional at run time, and an open module opens every package for reflection.
The constructed ModuleDescriptor prints name=demo.app, requires-logging=true, exports-api=true, opens-internal=true, and uses-runnable=true, proving four distinct module directives.
Examples
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"));
}
}
Result
name=demo.app requires-logging=true exports-api=true opens-internal=true uses-runnable=true
The constructed ModuleDescriptor prints name=demo.app, requires-logging=true, exports-api=true, opens-internal=true, and uses-runnable=true, proving four distinct module directives.