Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

uses — deklarovanie využívania služby v module

Direktíva uses v module-info.java určuje typ služby, ktorej poskytovateľov môže modul vyhľadávať cez ServiceLoader. Nevyberá konkrétnu implementáciu ani sama nespúšťa vyhľadávanie. uses je kontextové, nie rezervované kľúčové slovo.

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

Syntax

module ModuleName {
    uses ServiceType;
}

uses ServiceType; patrí do deklarácie modulu v module-info.java. Typ služby je kontrakt, zvyčajne rozhranie, a poskytovateľ dodáva jeho implementáciu. uses je kontextové kľúčové slovo: na tomto mieste má osobitný význam, no mimo príslušného kontextu môže byť identifikátorom, napríklad názvom premennej.

Direktíva deklaruje využívanie služby; vyhľadávanie vykonáva kód prostredníctvom java.util.ServiceLoader. Automaticky nevytvára inštancie a nezaručuje, že sa nájde poskytovateľ. Keď kód v explicitnom module volá ServiceLoader.load(ServiceType.class), kontrola využívania služby prejde, ak modul obsahuje príslušnú direktívu uses alebo využívanie služby pridal za behu pomocou Module.addUses. Ak nie je splnená ani jedna z týchto podmienok, volanie vyvolá ServiceConfigurationError.

Nezamieňajte uses s requires ani provides ... with ...: requires deklaruje závislosť od modulu, zatiaľ čo provides registruje poskytovateľa. Ak služba patrí do iného modulu, jej typ musí byť dostupný používateľovi; uses nenahrádza potrebnú závislosť ani export balíka. Závislosť od modulu konkrétneho poskytovateľa netreba deklarovať.

Typ služby nesmie byť triedou enum. Opakovanie uses pre tú istú službu v jednej deklarácii modulu je chyba kompilácie. Príklad umiestňuje používateľa aj jeho jediného poskytovateľa do jedného modulu, aby zostal samostatný. Vnorená trieda Hello je public a static a má public konštruktor bez argumentov.

Prí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ýsledok

Hello

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje