CKTIS / Java
uses — deklariranje uporabe usluge u modulu
Direktiva uses u module-info.java određuje tip usluge čije pružatelje modul može pronaći pomoću ServiceLoadera. Ne odabire određenu implementaciju niti sama pokreće pretraživanje. uses je kontekstna, a ne rezervirana ključna riječ.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
module ModuleName {
uses ServiceType;
}uses ServiceType; nalazi se unutar deklaracije modula u module-info.java. Tip usluge je ugovor, obično sučelje, a pružatelj nudi njegovu implementaciju. uses je kontekstna ključna riječ: na ovom mjestu ima posebno značenje, ali izvan odgovarajućeg konteksta može biti identifikator, primjerice naziv varijable.
Direktiva deklarira korištenje usluge; kod pretraživanje obavlja pomoću java.util.ServiceLoader. Ne stvara automatski instance i ne jamči da će pružatelj biti pronađen. Kada kod u eksplicitnom modulu pozove ServiceLoader.load(ServiceType.class), provjera korištenja usluge uspijeva ako modul sadrži odgovarajuću direktivu uses ili ako je korištenje usluge dodao tijekom izvođenja pomoću Module.addUses. Ako nije ispunjen nijedan od tih uvjeta, poziv izaziva ServiceConfigurationError.
Nemojte miješati uses s requires ili provides ... with ...: requires deklarira ovisnost o modulu, a provides registrira pružatelja. Ako usluga pripada drugom modulu, njezin tip mora biti dostupan korisniku; uses ne zamjenjuje potrebnu ovisnost ni izvoz paketa. Nije potrebno deklarirati ovisnost o modulu konkretnog pružatelja.
Tip usluge ne smije biti klasa enum. Ponavljanje uses za istu uslugu u jednoj deklaraciji modula pogreška je pri kompilaciji. Primjer smješta korisnika i njegova jedinog pružatelja u isti modul kako bi ostao samostalan. Ugniježđena klasa Hello je public i static te ima public konstruktor bez argumenata.
Primjeri
// 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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.