CKTIS / Java
uses — deklarovanie využívania služby v module
Direktíva uses v module-info.java určuje typ služby, ktorej poskytovateľov môže modul vyhľadávať cez ServiceLoader. Nevyberá konkrétnu implementáciu ani sama nespúšťa vyhľadávanie. uses je kontextové, nie rezervované kľúčové slovo.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
module ModuleName {
uses ServiceType;
}uses ServiceType; patrí do deklarácie modulu v module-info.java. Typ služby je kontrakt, zvyčajne rozhranie, a poskytovateľ dodáva jeho implementáciu. uses je kontextové kľúčové slovo: na tomto mieste má osobitný význam, no mimo príslušného kontextu môže byť identifikátorom, napríklad názvom premennej.
Direktíva deklaruje využívanie služby; vyhľadávanie vykonáva kód prostredníctvom java.util.ServiceLoader. Automaticky nevytvára inštancie a nezaručuje, že sa nájde poskytovateľ. Keď kód v explicitnom module volá ServiceLoader.load(ServiceType.class), kontrola využívania služby prejde, ak modul obsahuje príslušnú direktívu uses alebo využívanie služby pridal za behu pomocou Module.addUses. Ak nie je splnená ani jedna z týchto podmienok, volanie vyvolá ServiceConfigurationError.
Nezamieňajte uses s requires ani provides ... with ...: requires deklaruje závislosť od modulu, zatiaľ čo provides registruje poskytovateľa. Ak služba patrí do iného modulu, jej typ musí byť dostupný používateľovi; uses nenahrádza potrebnú závislosť ani export balíka. Závislosť od modulu konkrétneho poskytovateľa netreba deklarovať.
Typ služby nesmie byť triedou enum. Opakovanie uses pre tú istú službu v jednej deklarácii modulu je chyba kompilácie. Príklad umiestňuje používateľa aj jeho jediného poskytovateľa do jedného modulu, aby zostal samostatný. Vnorená trieda Hello je public a static a má public konštruktor bez argumentov.
Prí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ýsledok
Hello
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.