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

CKTIS / Java

uses — declarar o consumo de um serviço num módulo

A diretiva uses em module-info.java identifica um tipo de serviço cujos fornecedores o módulo pode procurar através de ServiceLoader. Não seleciona uma implementação específica nem inicia a pesquisa por si só. uses é uma palavra-chave contextual, não reservada.

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

Sintaxe

module ModuleName {
    uses ServiceType;
}

uses ServiceType; fica dentro da declaração do módulo em module-info.java. O tipo de serviço é um contrato, normalmente uma interface, e um fornecedor disponibiliza uma implementação. uses é uma palavra-chave contextual: tem um significado especial nesta posição, mas fora do contexto adequado pode ser um identificador, como o nome de uma variável.

A diretiva declara o consumo de um serviço; o código efetua a pesquisa através de java.util.ServiceLoader. Não cria instâncias automaticamente nem garante que seja encontrado um fornecedor. Quando o código de um módulo explícito invoca ServiceLoader.load(ServiceType.class), a verificação do consumo do serviço é bem-sucedida se o módulo contiver a diretiva uses correspondente ou se tiver adicionado esse consumo em tempo de execução com Module.addUses. Se nenhuma destas condições se verificar, a chamada lança ServiceConfigurationError.

Não confundas uses com requires ou provides ... with ...: requires declara uma dependência de módulo, enquanto provides regista um fornecedor. Se o serviço pertencer a outro módulo, o seu tipo tem de estar acessível ao consumidor; uses não substitui a dependência necessária nem a exportação do pacote. Não é necessário declarar uma dependência do módulo do fornecedor específico.

O tipo de serviço não pode ser uma classe enum. Repetir uses para o mesmo serviço numa declaração de módulo é um erro de compilação. O exemplo coloca o consumidor e o seu único fornecedor no mesmo módulo para se manter autónomo. A classe aninhada Hello é public e static e tem um construtor public sem argumentos.

Exemplos

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

Resultado

Hello

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