Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

uses — dichiarare l’utilizzo di un servizio in un modulo

La direttiva uses in module-info.java identifica un tipo di servizio i cui provider possono essere cercati dal modulo tramite ServiceLoader. Non seleziona una particolare implementazione e non avvia da sola la ricerca. uses è una parola chiave contestuale, non riservata.

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

Sintassi

module ModuleName {
    uses ServiceType;
}

uses ServiceType; si inserisce nella dichiarazione del modulo in module-info.java. Il tipo di servizio è un contratto, di solito un’interfaccia, e un provider ne fornisce un’implementazione. uses è una parola chiave contestuale: in questa posizione ha un significato speciale, ma al di fuori del contesto appropriato può essere un identificatore, per esempio il nome di una variabile.

La direttiva dichiara l’utilizzo di un servizio; il codice esegue la ricerca tramite java.util.ServiceLoader. Non crea automaticamente istanze e non garantisce che venga trovato un provider. Quando il codice di un modulo esplicito chiama ServiceLoader.load(ServiceType.class), il controllo sull’utilizzo del servizio viene superato se il modulo contiene la direttiva uses corrispondente o se ha aggiunto tale utilizzo a runtime con Module.addUses. Se non è soddisfatta nessuna delle due condizioni, la chiamata genera un ServiceConfigurationError.

Non confondere uses con requires o provides ... with ...: requires dichiara una dipendenza da un modulo, mentre provides registra un provider. Se il servizio appartiene a un altro modulo, il suo tipo deve essere accessibile al consumer; uses non sostituisce la dipendenza necessaria né l’esportazione del package. Non è necessario dichiarare una dipendenza dal modulo del provider specifico.

Il tipo di servizio non può essere una classe enum. Ripetere uses per lo stesso servizio in una dichiarazione di modulo è un errore di compilazione. L’esempio colloca il consumer e il suo unico provider nello stesso modulo per mantenerlo autonomo. La classe annidata Hello è public e static e ha un costruttore public senza argomenti.

Esempi

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

Risultato

Hello

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti