CKTIS / Java
uses — deklarowanie korzystania z usługi w module
Dyrektywa uses w module-info.java wskazuje typ usługi, której dostawców moduł może wyszukiwać przez ServiceLoader. Nie wskazuje konkretnej implementacji i sama nie uruchamia wyszukiwania. uses jest słowem kluczowym kontekstowym, a nie zastrzeżonym.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
module ModuleName {
uses ServiceType;
}uses ServiceType; umieszcza się w deklaracji modułu w module-info.java. Typ usługi jest kontraktem, zwykle interfejsem, a dostawca udostępnia jego implementację. uses jest słowem kluczowym kontekstowym: w tej pozycji ma specjalne znaczenie, ale poza odpowiednim kontekstem może być identyfikatorem, na przykład nazwą zmiennej.
Dyrektywa deklaruje korzystanie z usługi; wyszukiwanie wykonuje kod przez java.util.ServiceLoader. Nie tworzy ona automatycznie instancji i nie gwarantuje znalezienia dostawcy. Gdy kod w module jawnym wywołuje ServiceLoader.load(ServiceType.class), warunek dotyczący korzystania z usługi jest spełniony, jeśli moduł zawiera odpowiednią dyrektywę uses albo dodał informację o korzystaniu z tej usługi w czasie działania za pomocą Module.addUses. Jeśli żaden z tych warunków nie jest spełniony, wywołanie zgłasza ServiceConfigurationError.
Nie myl uses z requires ani provides ... with ...: requires deklaruje zależność od modułu, a provides rejestruje dostawcę. Jeśli usługa pochodzi z innego modułu, jej typ musi być dostępny dla konsumenta; uses nie zastępuje wymaganej zależności ani eksportu pakietu. Nie trzeba deklarować zależności od modułu konkretnego dostawcy.
Typ usługi nie może być klasą enum. Powtórzenie uses dla tej samej usługi w jednej deklaracji modułu jest błędem kompilacji. Przykład umieszcza konsumenta i jedynego dostawcę w jednym module, aby pozostał samowystarczalny. Zagnieżdżona klasa Hello jest publiczna, statyczna i ma publiczny konstruktor bezargumentowy.
Przykłady
// 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());
}
}Wynik
Hello
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.