База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници