KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

uses — dienstgebruik in een module declareren

De uses-directive in module-info.java benoemt een servicetype waarvan de module de providers via ServiceLoader kan vinden. De directive kiest geen specifieke implementatie en start de zoekactie niet zelf. uses is een contextueel, geen gereserveerd sleutelwoord.

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

Syntax

module ModuleName {
    uses ServiceType;
}

uses ServiceType; staat binnen de moduledeclaratie in module-info.java. Het servicetype is een contract, meestal een interface, en een provider levert een implementatie. uses is een contextueel sleutelwoord: op deze plaats heeft het een speciale betekenis, maar buiten de juiste context kan het een identifier zijn, bijvoorbeeld een variabelenaam.

De directive declareert het gebruik van een service; code voert de zoekactie uit met java.util.ServiceLoader. De directive maakt niet automatisch instanties aan en garandeert niet dat er een provider wordt gevonden. Wanneer code in een expliciete module ServiceLoader.load(ServiceType.class) aanroept, slaagt de controle op servicegebruik als de module de bijbehorende uses-directive bevat of het gebruik van de service tijdens de uitvoering heeft toegevoegd met Module.addUses. Als aan geen van beide voorwaarden is voldaan, gooit de aanroep een ServiceConfigurationError.

Verwar uses niet met requires of provides ... with ...: requires declareert een moduleafhankelijkheid, terwijl provides een provider registreert. Als de service bij een andere module hoort, moet het type ervan toegankelijk zijn voor de gebruiker; uses vervangt noch de vereiste afhankelijkheid, noch de package-export. Een afhankelijkheid van de module van de specifieke provider is niet nodig.

Het servicetype mag geen enum-klasse zijn. uses voor dezelfde service herhalen in één moduledeclaratie is een compilatiefout. Het voorbeeld plaatst de gebruiker en diens enige provider in één module, zodat het zelfstandig blijft. De geneste klasse Hello is public en static en heeft een public constructor zonder argumenten.

Voorbeelden

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

Resultaat

Hello

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen