CKTIS / Java
uses — deklariranje uporabe storitve v modulu
Direktiva uses v module-info.java določa tip storitve, katere ponudnike lahko modul poišče z uporabo ServiceLoader. Ne izbere določene izvedbe in iskanja ne sproži sama. uses je kontekstna, ne rezervirana ključna beseda.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
module ModuleName {
uses ServiceType;
}uses ServiceType; sodi v deklaracijo modula v module-info.java. Tip storitve je pogodba, običajno vmesnik, ponudnik pa zagotovi njeno izvedbo. uses je kontekstna ključna beseda: na tem mestu ima poseben pomen, zunaj ustreznega konteksta pa je lahko identifikator, na primer ime spremenljivke.
Direktiva deklarira uporabo storitve; koda iskanje izvede prek java.util.ServiceLoader. Samodejno ne ustvari primerkov in ne zagotavlja, da bo ponudnik najden. Ko koda v eksplicitnem modulu pokliče ServiceLoader.load(ServiceType.class), je preverjanje uporabe storitve uspešno, če modul vsebuje ustrezno direktivo uses ali če je uporabo storitve dodal med izvajanjem z Module.addUses. Če ni izpolnjen nobeden od teh pogojev, klic sproži napako ServiceConfigurationError.
uses ne zamenjujte z requires ali provides ... with ...: requires deklarira odvisnost od modula, provides pa registrira ponudnika. Če storitev pripada drugemu modulu, mora biti njen tip dostopen uporabniku; uses ne nadomesti potrebne odvisnosti ali izvoza paketa. Odvisnosti od modula konkretnega ponudnika ni treba deklarirati.
Tip storitve ne sme biti razred enum. Ponovitev uses za isto storitev v eni deklaraciji modula je napaka pri prevajanju. Primer zaradi samostojnosti postavi uporabnika in njegovega edinega ponudnika v isti modul. Ugnezdeni razred Hello je public in static ter ima public konstruktor brez argumentov.
Primeri
// 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());
}
}Rezultat
Hello
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.