Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

with — fornecedores de serviços num módulo

Em Java SE 21, `with` é uma palavra-chave contextual na diretiva `provides` de uma declaração de módulo. Separa o tipo de serviço da lista de fornecedores; fora desse contexto, pode ser usado como identificador.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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

with é uma palavra-chave contextual, não uma palavra reservada em todas as circunstâncias. Numa diretiva provides em module-info.java, introduz a lista de fornecedores do serviço. Fora do contexto em que funciona como palavra-chave, é válida uma declaração como int with = 1;.

Em provides ServiceType with ProviderType;, o lado esquerdo identifica o serviço e o lado direito identifica o respetivo fornecedor para ServiceLoader. Podem ser indicados vários fornecedores separados por vírgulas, sem repetições. Os fornecedores têm de ser declarados no mesmo módulo.

O exemplo utiliza a forma baseada no construtor: Task é uma classe pública que implementa Runnable e tem um construtor público sem argumentos. Outra forma utiliza um método público estático provider() sem argumentos, que devolve um subtipo do serviço; nesse caso, o próprio fornecedor não tem de ser um subtipo.

provides ... with ... declara um fornecedor, enquanto uses declara a utilização de um serviço. O módulo do exemplo desempenha ambos os papéis. Esta descrição diz respeito a Java SE 21; a compatibilidade com ambientes de execução de produção não foi confirmada.

Exemplos

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

Resultado

OK

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes