CKTIS / Java
uses — deklarace využití služby v modulu
Direktiva uses v module-info.java určuje typ služby, jejíž poskytovatele může modul vyhledávat pomocí ServiceLoader. Nevybírá konkrétní implementaci ani sama vyhledávání nespouští. uses je kontextové, nikoli rezervované klíčové slovo.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
module ModuleName {
uses ServiceType;
}uses ServiceType; patří dovnitř deklarace modulu v module-info.java. Typ služby představuje kontrakt, obvykle rozhraní, a poskytovatel dodává jeho implementaci. uses je kontextové klíčové slovo: na tomto místě má zvláštní význam, ale mimo příslušný kontext může být identifikátorem, například názvem proměnné.
Direktiva deklaruje využití služby; vyhledávání provádí kód prostřednictvím java.util.ServiceLoader. Sama automaticky nevytváří instance a nezaručuje nalezení poskytovatele. Když kód v explicitním modulu volá ServiceLoader.load(ServiceType.class), kontrola využití služby projde, pokud modul obsahuje příslušnou direktivu uses nebo využití služby přidal za běhu pomocí Module.addUses. Není-li splněna ani jedna z těchto podmínek, volání vyvolá ServiceConfigurationError.
Nezaměňujte uses za requires nebo provides ... with ...: requires deklaruje závislost na modulu, zatímco provides registruje poskytovatele. Pokud služba patří do jiného modulu, její typ musí být pro uživatele přístupný; uses nenahrazuje potřebnou závislost ani export balíčku. Závislost na modulu konkrétního poskytovatele není nutné deklarovat.
Typ služby nesmí být třídou enum. Opakované uvedení uses pro stejnou službu v jedné deklaraci modulu je chyba při kompilaci. Příklad umisťuje uživatele i jeho jediného poskytovatele do jednoho modulu, aby byl samostatný. Vnořená třída Hello je public a static a má public konstruktor bez argumentů.
Příklady
// 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());
}
}Výsledek
Hello
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.