CKTIS / Java
to — een pakket beschikbaar maken voor geselecteerde modules
In Java SE 21 is `to` een contextueel sleutelwoord dat wordt gebruikt in `exports`- en `opens`-directieven. Het geeft aan voor welke modules de declarerende module een bepaald pakket beschikbaar maakt.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
exports PackageName to ModuleName {, ModuleName};
opens PackageName to ModuleName {, ModuleName};to is een contextueel sleutelwoord, geen gereserveerd sleutelwoord. In een moduledeclaratie, meestal in module-info.java, leidt het de lijst met doelmodules van een exports- of opens-directief in. Buiten de betreffende context kan het een identifier zijn, bijvoorbeeld een variabelenaam.
exports p to m; maakt de toegankelijke openbare API van pakket p tijdens compilatie en uitvoering beschikbaar voor module m; de normale toegangsregels blijven gelden. opens p to m; geeft module m reflectieve toegang, ook tot niet-openbare inhoud van het pakket, maar maakt het pakket niet beschikbaar voor normaal gebruik tijdens compilatie. Zonder to beperkt het directief de ontvangers niet tot een specifieke lijst. De namen na to verwijzen naar modules, niet naar pakketten; scheid meerdere namen met komma’s.
to maakt geen afhankelijkheid aan: een module die een geëxporteerde API gebruikt, heeft nog steeds de juiste leesrelatie nodig, in het voorbeeld via requires demo.lib;. Een modulenaam binnen dezelfde to-clausule herhalen is een compilatiefout. Een opens-directief mag niet binnen een open module staan. In het voorbeeld wordt demo.api alleen naar demo.app geëxporteerd.
Voorbeelden
// src/demo.lib/module-info.java
module demo.lib {
exports demo.api to demo.app;
}
// src/demo.lib/demo/api/Message.java
package demo.api;
public class Message {
public static String text() {
return "Hello";
}
}
// src/demo.app/module-info.java
module demo.app {
requires demo.lib;
}
// src/demo.app/demo/app/Main.java
package demo.app;
import demo.api.Message;
public class Main {
public static void main(String[] args) {
System.out.println(Message.text());
}
}Resultaat
Hello
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.