Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

uses — deklarace využití služby v modulu

Direktiva uses v module-info.java určuje typ služby, jejíž poskytovatele může modul vyhledávat pomocí ServiceLoader. Nevybírá konkrétní implementaci ani sama vyhledávání nespouští. uses je kontextové, nikoli rezervované klíčové slovo.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

module ModuleName {
    uses ServiceType;
}

uses ServiceType; patří dovnitř deklarace modulu v module-info.java. Typ služby představuje kontrakt, obvykle rozhraní, a poskytovatel dodává jeho implementaci. uses je kontextové klíčové slovo: na tomto místě má zvláštní význam, ale mimo příslušný kontext může být identifikátorem, například názvem proměnné.

Direktiva deklaruje využití služby; vyhledávání provádí kód prostřednictvím java.util.ServiceLoader. Sama automaticky nevytváří instance a nezaručuje nalezení poskytovatele. Když kód v explicitním modulu volá ServiceLoader.load(ServiceType.class), kontrola využití služby projde, pokud modul obsahuje příslušnou direktivu uses nebo využití služby přidal za běhu pomocí Module.addUses. Není-li splněna ani jedna z těchto podmínek, volání vyvolá ServiceConfigurationError.

Nezaměňujte uses za requires nebo provides ... with ...: requires deklaruje závislost na modulu, zatímco provides registruje poskytovatele. Pokud služba patří do jiného modulu, její typ musí být pro uživatele přístupný; uses nenahrazuje potřebnou závislost ani export balíčku. Závislost na modulu konkrétního poskytovatele není nutné deklarovat.

Typ služby nesmí být třídou enum. Opakované uvedení uses pro stejnou službu v jedné deklaraci modulu je chyba při kompilaci. Příklad umisťuje uživatele i jeho jediného poskytovatele do jednoho modulu, aby byl samostatný. Vnořená třída Hello je public a static a má public konstruktor bez argumentů.

Příklady

// 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());
    }
}

Výsledek

Hello

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje