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.