CKTIS / Java
to — ein Paket ausgewählten Modulen zugänglich machen
In Java SE 21 ist `to` ein kontextabhängiges Schlüsselwort, das in `exports`- und `opens`-Direktiven verwendet wird. Es nennt die Module, denen das deklarierende Modul ein bestimmtes Paket zugänglich macht.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
exports PackageName to ModuleName {, ModuleName};
opens PackageName to ModuleName {, ModuleName};to ist ein kontextabhängiges, kein reserviertes Schlüsselwort. In einer Moduldeklaration, normalerweise in module-info.java, leitet es die Liste der Zielmodule einer exports- oder opens-Direktive ein. Außerhalb des passenden Kontexts kann es ein Bezeichner sein, zum Beispiel ein Variablenname.
exports p to m; macht die zugängliche öffentliche API des Pakets p für Modul m zur Compile-Zeit und zur Laufzeit verfügbar; die üblichen Zugriffsregeln gelten weiterhin. opens p to m; ermöglicht Modul m den reflektiven Zugriff, auch auf nicht öffentliche Inhalte des Pakets, macht das Paket aber nicht für die normale Nutzung zur Compile-Zeit verfügbar. Ohne to beschränkt die Direktive die Empfänger nicht auf eine bestimmte Liste. Die Namen nach to bezeichnen Module, keine Pakete; mehrere Namen werden durch Kommas getrennt.
to erzeugt keine Abhängigkeit: Ein Modul, das eine exportierte API verwendet, benötigt weiterhin die passende Lesbarkeitsbeziehung, die im Beispiel durch requires demo.lib; hergestellt wird. Einen Modulnamen innerhalb derselben to-Klausel zu wiederholen, ist ein Kompilierfehler. Eine opens-Direktive darf nicht innerhalb eines open module stehen. Im Beispiel wird demo.api nur für demo.app exportiert.
Beispiele
// 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());
}
}Ergebnis
Hello
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.