CKTIS / Java
to — rendre un paquet accessible à certains modules
En Java SE 21, `to` est un mot-clé contextuel utilisé dans les directives `exports` et `opens`. Il désigne les modules auxquels le module déclarant rend un paquet donné accessible.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
exports PackageName to ModuleName {, ModuleName};
opens PackageName to ModuleName {, ModuleName};to est un mot-clé contextuel, et non un mot-clé réservé. Dans une déclaration de module, généralement dans module-info.java, il introduit la liste des modules cibles d’une directive exports ou opens. En dehors du contexte approprié, il peut être un identifiant, par exemple un nom de variable.
exports p to m; rend l’API publique accessible du paquet p disponible pour le module m à la compilation et à l’exécution ; les règles d’accès habituelles continuent de s’appliquer. opens p to m; permet au module m d’accéder au paquet par réflexion, y compris à son contenu non public, mais ne rend pas le paquet disponible pour un usage normal à la compilation. Sans to, la directive ne limite pas les destinataires à une liste précise. Les noms après to désignent des modules, et non des paquets ; séparez plusieurs noms par des virgules.
to ne crée pas de dépendance : un module qui utilise une API exportée a toujours besoin de la relation de lisibilité appropriée, fournie dans l’exemple par requires demo.lib;. Répéter un nom de module dans une même clause to constitue une erreur de compilation. Une directive opens ne peut pas se trouver dans un open module. Dans l’exemple, demo.api est exporté uniquement vers demo.app.
Exemples
// 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());
}
}Résultat
Hello
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.