CKTIS / Java
requires — module dependency
requires — module dependency: A requires directive in module-info.java establishes a module dependency and a readability edge to a named module.
Version: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Syntax
requiresA requires directive in module-info.java establishes a module dependency and a readability edge to a named module.
Use requires m for an ordinary dependency, requires transitive m to propagate readability to clients, and requires static m for a compile-time dependency optional at run time.
requires transitive does not automatically export packages, and requires static does not guarantee the module is present in the runtime image; dependency cycles are errors.
Every module except java.base has an implicit mandated dependency on java.base; the transitive and static modifiers may be combined.
The descriptor distinguishes requires transitive for demo.api, requires static for demo.optional, and ordinary requires for java.logging.
Examples
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()));
}
}
Result
demo.api:[TRANSITIVE] demo.optional:[STATIC] java.logging:[]
The descriptor distinguishes requires transitive for demo.api, requires static for demo.optional, and ordinary requires for java.logging.