WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

uses — Dienstnutzung in einem Modul deklarieren

Die uses-Direktive in module-info.java benennt einen Diensttyp, dessen Anbieter das Modul mit ServiceLoader finden kann. Sie wählt keine bestimmte Implementierung aus und startet die Suche nicht selbst. uses ist ein kontextabhängiges, kein reserviertes Schlüsselwort.

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

Syntax

module ModuleName {
    uses ServiceType;
}

uses ServiceType; steht innerhalb der Moduldeklaration in module-info.java. Der Diensttyp ist ein Vertrag, meist ein Interface, und ein Anbieter stellt eine Implementierung bereit. uses ist ein kontextabhängiges Schlüsselwort: An dieser Stelle hat es eine besondere Bedeutung, außerhalb des passenden Kontexts kann es jedoch ein Bezeichner sein, etwa ein Variablenname.

Die Direktive deklariert die Nutzung eines Dienstes; den Suchvorgang führt Code mit java.util.ServiceLoader aus. Sie erzeugt nicht automatisch Instanzen und garantiert nicht, dass ein Anbieter gefunden wird. Ruft Code in einem expliziten Modul ServiceLoader.load(ServiceType.class) auf, ist die Prüfung der Dienstnutzung bestanden, wenn das Modul die entsprechende uses-Direktive enthält oder die Dienstnutzung zur Laufzeit mit Module.addUses hinzugefügt hat. Trifft beides nicht zu, löst der Aufruf einen ServiceConfigurationError aus.

Verwechsle uses nicht mit requires oder provides ... with ...: requires deklariert eine Modulabhängigkeit, während provides einen Anbieter registriert. Gehört der Dienst zu einem anderen Modul, muss sein Typ für den Verbraucher zugänglich sein; uses ersetzt weder die erforderliche Abhängigkeit noch den Paketexport. Eine Abhängigkeit vom konkreten Anbietermodul ist nicht erforderlich.

Der Diensttyp darf keine enum-Klasse sein. uses für denselben Dienst in einer Moduldeklaration zu wiederholen, ist ein Kompilierfehler. Das Beispiel enthält Verbraucher und einzigen Anbieter in einem Modul, damit es eigenständig bleibt. Die verschachtelte Klasse Hello ist public und static und besitzt einen public-Konstruktor ohne Argumente.

Beispiele

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

Ergebnis

Hello

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen