Java Academy · Aula

Serviços com provides/uses

Desacople com o carregador de serviços.

Serviços com provides/uses é uma aula grátis de Java Academy no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Java Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Java Academy inclui 4 aulas no total.

Desacoplamento com serviços

Os módulos podem colaborar sem depender das implementações uns dos outros, usando o padrão de carregamento de serviços.

Um módulo declara que uses uma interface de serviço; outro declara que provides uma implementação. A JVM conecta os dois.

As três funções

Um serviço tem três participantes:

Interface de serviço: o contrato, em algum módulo
Fornecedor: um módulo que fornece uma implementação
Consumidor: um módulo que carrega implementações em tempo de execução

A interface de serviço

Primeiro, defina o contrato. É apenas uma interface comum em um pacote exportado, para que fornecedores e consumidores possam fazer referência a ela.

package com.example.spi;

public interface Codec {
    String name();
    byte[] encode(String input);
}

O consumidor declara o uso

O módulo consumidor declara que uses a interface. Isso informa ao JPMS que o módulo procurará implementações por meio de ServiceLoader.

module com.example.app {
    requires com.example.spi;
    uses com.example.spi.Codec;
}

O fornecedor declara a implementação

Um módulo fornecedor declara qual interface implementa com provides ... with ..., nomeando sua classe concreta.

module com.example.base64 {
    requires com.example.spi;
    provides com.example.spi.Codec
        with com.example.base64.Base64Codec;
}

A implementação do fornecedor

A classe de implementação é um Java comum. Ela deve ser pública e ter um construtor público sem argumentos ou um método estático público provider().

package com.example.base64;

import com.example.spi.Codec;
import java.util.Base64;

public class Base64Codec implements Codec {
    public String name() { return "base64"; }
    public byte[] encode(String input) {
        return Base64.getEncoder().encode(input.getBytes());
    }
}

Carregando com ServiceLoader

Em tempo de execução, o consumidor solicita a ServiceLoader.load(Codec.class) todos os fornecedores disponíveis e itera sobre eles, sem uma ligação em tempo de compilação com qualquer implementação.

import com.example.spi.Codec;
import java.util.ServiceLoader;

public class App {
    public static void main(String[] args) {
        ServiceLoader<Codec> loader = ServiceLoader.load(Codec.class);
        for (Codec codec : loader) {
            System.out.println("Found codec: " + codec.name());
        }
    }
}

Por que isso é poderoso

O consumidor nunca nomeia uma classe de fornecedor. Adicione um novo módulo fornecedor ao caminho de módulos, e ele será descoberto automaticamente.

Isso permite arquiteturas de plug-ins e uma inversão limpa das dependências.

A fábrica de instâncias

Se a construção exigir lógica, exponha um método estático público provider() em vez de um construtor sem argumentos. O JPMS o chama para obter a instância.

package com.example.base64;

import com.example.spi.Codec;

public class CodecFactory {
    public static Codec provider() {
        return new Base64Codec();
    }
}

Vários fornecedores

Muitos módulos podem fornecer a mesma interface. O ServiceLoader retorna todos eles, permitindo que o consumidor escolha por nome, prioridade ou capacidade.

Adicione ou remova fornecedores sem alterar o código do consumidor.

Percorrendo fornecedores com um fluxo

Desde o Java 9, o ServiceLoader oferece stream(), produzindo referências Provider que podem ser filtradas antes da instanciação, o que é útil quando a construção é dispendiosa.

import com.example.spi.Codec;
import java.util.ServiceLoader;

public class App {
    public static void main(String[] args) {
        Codec chosen = ServiceLoader.load(Codec.class).stream()
            .map(ServiceLoader.Provider::get)
            .filter(c -> c.name().equals("base64"))
            .findFirst()
            .orElseThrow();
        System.out.println("Using: " + chosen.name());
    }
}

Verificação rápida

Relembre qual diretiva cada função usa.

Recapitulação

Você aprendeu o padrão de serviços dos módulos:

Três funções: interface de serviço, fornecedor, consumidor
Consumidor: uses; fornecedor: provides ... with
Implementações carregadas em tempo de execução por meio de ServiceLoader
Fornecedores precisam de um construtor público sem argumentos ou de um método estático provider()

A seguir: migração de um projeto existente para módulos.

Perguntas Frequentes

A aula “Serviços com provides/uses” é grátis?

Sim — o texto completo de “Serviços com provides/uses” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Java Academy, atualize para CoddyKit PRO. O curso de Java Academy inclui 4 aulas no total.

O que vou aprender em “Serviços com provides/uses”?

Desacople com o carregador de serviços. Você pratica Java Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Java Academy?

Nenhuma experiência prévia é necessária. Java Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.

Quanto tempo leva a aula “Serviços com provides/uses”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Java Academy?

Sim. Cada aula de Java Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para Java Academy