Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

with — dostawcy usługi w module

W Java SE 21 `with` jest kontekstowym słowem kluczowym dyrektywy `provides` w deklaracji modułu. Oddziela typ usługi od listy jej dostawców; poza tym kontekstem może być identyfikatorem.

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

Składnia

provides ServiceType with ProviderType [, OtherProviderType ...];

with jest kontekstowym, a nie bezwarunkowo zarezerwowanym słowem kluczowym. W dyrektywie provides w pliku module-info.java wprowadza listę dostawców usługi. Poza kontekstem słowa kluczowego poprawna jest np. deklaracja int with = 1;.

W zapisie provides ServiceType with ProviderType; lewa strona wskazuje usługę, a prawa — jej dostawcę dla ServiceLoader. Można podać kilku dostawców rozdzielonych przecinkami, bez powtórzeń. Dostawcy muszą być zadeklarowani w tym samym module.

Przykład korzysta z wariantu konstruktorowego: Task jest publiczną klasą implementującą Runnable i ma publiczny konstruktor bezargumentowy. Istnieje też wariant z publiczną statyczną metodą provider() bez parametrów, zwracającą podtyp usługi; wtedy sam dostawca nie musi być jej podtypem.

provides ... with ... deklaruje dostawcę, natomiast uses deklaruje korzystanie z usługi. W przykładzie moduł pełni obie role. Opis dotyczy Java SE 21; zgodność środowiska produkcyjnego nie została potwierdzona.

Przykłady

// src/module-info.java
module demo.app {
    uses java.lang.Runnable;
    provides java.lang.Runnable with demo.Task;
}

// src/demo/Task.java
package demo;

public class Task implements Runnable {
    public Task() {}

    @Override
    public void run() {
        System.out.println("OK");
    }
}

// src/demo/Main.java
package demo;

import java.util.ServiceLoader;

public class Main {
    public static void main(String[] args) {
        ServiceLoader.load(Runnable.class)
                .findFirst()
                .orElseThrow()
                .run();
    }
}

Wynik

OK

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła