Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

uses — deklariranje uporabe storitve v modulu

Direktiva uses v module-info.java določa tip storitve, katere ponudnike lahko modul poišče z uporabo ServiceLoader. Ne izbere določene izvedbe in iskanja ne sproži sama. uses je kontekstna, ne rezervirana ključna beseda.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

module ModuleName {
    uses ServiceType;
}

uses ServiceType; sodi v deklaracijo modula v module-info.java. Tip storitve je pogodba, običajno vmesnik, ponudnik pa zagotovi njeno izvedbo. uses je kontekstna ključna beseda: na tem mestu ima poseben pomen, zunaj ustreznega konteksta pa je lahko identifikator, na primer ime spremenljivke.

Direktiva deklarira uporabo storitve; koda iskanje izvede prek java.util.ServiceLoader. Samodejno ne ustvari primerkov in ne zagotavlja, da bo ponudnik najden. Ko koda v eksplicitnem modulu pokliče ServiceLoader.load(ServiceType.class), je preverjanje uporabe storitve uspešno, če modul vsebuje ustrezno direktivo uses ali če je uporabo storitve dodal med izvajanjem z Module.addUses. Če ni izpolnjen nobeden od teh pogojev, klic sproži napako ServiceConfigurationError.

uses ne zamenjujte z requires ali provides ... with ...: requires deklarira odvisnost od modula, provides pa registrira ponudnika. Če storitev pripada drugemu modulu, mora biti njen tip dostopen uporabniku; uses ne nadomesti potrebne odvisnosti ali izvoza paketa. Odvisnosti od modula konkretnega ponudnika ni treba deklarirati.

Tip storitve ne sme biti razred enum. Ponovitev uses za isto storitev v eni deklaraciji modula je napaka pri prevajanju. Primer zaradi samostojnosti postavi uporabnika in njegovega edinega ponudnika v isti modul. Ugnezdeni razred Hello je public in static ter ima public konstruktor brez argumentov.

Primeri

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

Rezultat

Hello

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri