Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła