CKTIS / Java
uses — déclarer l’utilisation d’un service dans un module
La directive uses dans module-info.java désigne un type de service dont le module peut rechercher les fournisseurs avec ServiceLoader. Elle ne sélectionne aucune implémentation particulière et ne lance pas elle-même la recherche. uses est un mot-clé contextuel, et non réservé.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
module ModuleName {
uses ServiceType;
}uses ServiceType; se place dans la déclaration du module de module-info.java. Le type de service constitue un contrat, généralement une interface, et un fournisseur en propose une implémentation. uses est un mot-clé contextuel : il a un sens particulier à cet emplacement, mais peut être un identifiant, par exemple un nom de variable, hors du contexte approprié.
La directive déclare l’utilisation d’un service ; le code effectue la recherche avec java.util.ServiceLoader. Elle ne crée pas automatiquement d’instances et ne garantit pas qu’un fournisseur sera trouvé. Lorsque du code dans un module explicite appelle ServiceLoader.load(ServiceType.class), le contrôle d’utilisation du service réussit si le module contient la directive uses correspondante ou s’il a ajouté cette utilisation à l’exécution avec Module.addUses. Si aucune de ces conditions n’est remplie, l’appel lève une ServiceConfigurationError.
Ne confondez pas uses avec requires ou provides ... with ... : requires déclare une dépendance de module, tandis que provides enregistre un fournisseur. Si le service appartient à un autre module, son type doit être accessible au consommateur ; uses ne remplace ni la dépendance nécessaire ni l’exportation du package. Il n’est pas nécessaire de dépendre du module du fournisseur particulier.
Le type de service ne peut pas être une classe enum. Répéter uses pour le même service dans une déclaration de module constitue une erreur de compilation. L’exemple place le consommateur et son unique fournisseur dans un même module afin de rester autonome. La classe imbriquée Hello est public et static et possède un constructeur public sans argument.
Exemples
// src/demo/module-info.java
module demo {
uses demo.Main.Greeting;
provides demo.Main.Greeting with demo.Main.Hello;
}
// src/demo/demo/Main.java
package demo;
import java.util.ServiceLoader;
public class Main {
public interface Greeting {
String message();
}
public static class Hello implements Greeting {
public Hello() {}
@Override
public String message() {
return "Hello";
}
}
public static void main(String[] args) {
Greeting greeting = ServiceLoader.load(Greeting.class)
.findFirst().orElseThrow();
System.out.println(greeting.message());
}
}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.