Knowledge baseExam Center
ENEnglish
Choose language13

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

requires

A 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.

Sources