CKTIS / Java
uses — деклариране на използване на услуга в модул
Директивата uses в module-info.java посочва тип услуга, чиито доставчици модулът може да търси чрез ServiceLoader. Тя не избира конкретна реализация и сама не започва търсенето. uses е контекстна, а не запазена ключова дума.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
module ModuleName {
uses ServiceType;
}uses ServiceType; се поставя в декларацията на модула в module-info.java. Типът на услугата е договор, обикновено интерфейс, а доставчикът предоставя негова реализация. uses е контекстна ключова дума: на това място има специално значение, но извън подходящия контекст може да бъде идентификатор, например име на променлива.
Директивата декларира използването на услуга; кодът извършва търсенето чрез java.util.ServiceLoader. Тя не създава автоматично инстанции и не гарантира, че ще бъде намерен доставчик. Когато код в изричен модул извика ServiceLoader.load(ServiceType.class), проверката за използване на услугата преминава успешно, ако модулът съдържа съответната директива uses или ако по време на изпълнение е заявил, че използва услугата, чрез Module.addUses. Ако нито едно от тези условия не е изпълнено, извикването предизвиква ServiceConfigurationError.
Не бъркайте uses с requires или provides ... with ...: requires декларира зависимост от модул, а provides регистрира доставчик. Ако услугата принадлежи на друг модул, типът ѝ трябва да е достъпен за потребителя; uses не заменя необходимата зависимост или експортирането на пакета. Не е необходимо да се декларира зависимост от модула на конкретния доставчик.
Типът на услугата не може да бъде клас enum. Повтарянето на uses за една и съща услуга в една декларация на модул е грешка при компилация. За да остане самостоятелен, примерът поставя потребителя и единствения му доставчик в един модул. Вложеният клас Hello е public и static и има public конструктор без аргументи.
Примери
// 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());
}
}Резултат
Hello
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.