Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

with — fournisseurs de services dans un module

En Java SE 21, `with` est un mot-clé contextuel dans la directive `provides` d’une déclaration de module. Il sépare le type de service de sa liste de fournisseurs ; en dehors de ce contexte, il peut être utilisé comme identifiant.

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

Syntaxe

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

with est un mot-clé contextuel, et non un mot-clé réservé en toutes circonstances. Dans une directive provides de module-info.java, il introduit la liste des fournisseurs du service. En dehors de ce contexte de mot-clé, une déclaration telle que int with = 1; est valide.

Dans provides ServiceType with ProviderType;, la partie gauche indique le service et la partie droite son fournisseur pour ServiceLoader. Plusieurs fournisseurs peuvent être séparés par des virgules, sans doublons. Les fournisseurs doivent être déclarés dans le même module.

L’exemple utilise la forme fondée sur un constructeur : Task est une classe publique qui implémente Runnable et possède un constructeur public sans argument. Une autre forme utilise une méthode publique statique provider() sans argument, qui renvoie un sous-type du service ; dans ce cas, le fournisseur lui-même n’a pas besoin d’être un sous-type.

provides ... with ... déclare un fournisseur, tandis que uses déclare l’utilisation d’un service. Le module de l’exemple remplit les deux rôles. Cette description concerne Java SE 21 ; la compatibilité avec un environnement d’exécution de production n’a pas été attestée.

Exemples

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

Résultat

OK

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources