Java Academy · Aula

requires e exports

Controle dependências e visibilidade.

requires e exports é uma aula grátis de Java Academy no CoddyKit. Esta é a aula 2 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.

Controlando o grafo de módulos

Duas diretivas definem o grafo de módulos: requires declara de que você depende, e exports declara o que você revela.

Esta lição explora as variantes dessas diretivas e as regras de legibilidade e acessibilidade que elas criam.

Dependência simples

Uma declaração simples requires X; significa que este módulo lê o módulo X. Seu código pode usar os tipos públicos exportados por X, mas os consumidores do seu módulo não aprendem nada sobre X.

module com.example.app {
    requires java.sql;
}

Dependência transitiva

requires transitive Y; significa que qualquer módulo que leia o seu módulo também lê Y. Isso é legibilidade implícita, útil quando sua API expõe tipos de Y.

module com.example.api {
    requires transitive java.sql;
}

Quando usar a forma transitiva

Use transitive quando um método da sua API exportada retorna ou aceita um tipo de outro módulo. Caso contrário, os chamadores nem poderiam nomear o tipo de retorno sem seu próprio requires.

Isso evita que os consumidores declarem dependências redundantes.

Dependência estática

requires static Z; declara uma dependência exclusiva do tempo de compilação. O módulo é necessário para compilar, mas é opcional em tempo de execução, sendo ideal para processadores de anotações ou integrações opcionais.

module com.example.app {
    requires static com.example.annotations;
}

Exportação simples

exports pkg; torna os tipos públicos de pkg legíveis por todos os módulos que dependem do seu.

module com.example.lib {
    exports com.example.lib.api;
}

Exportações qualificadas

Uma exportação qualificada revela um pacote apenas para módulos nomeados específicos, usando exports pkg to modA, modB;. É útil para módulos parceiros dentro de um sistema maior.

module com.example.core {
    exports com.example.core.internal to com.example.web, com.example.batch;
}

Abertura para reflexão

exports concede acesso em tempo de compilação e execução aos membros públicos. A reflexão profunda (campos privados) exige opens pkg;, usado por estruturas como Jackson ou Hibernate.

module com.example.model {
    exports com.example.model;
    opens com.example.model.entities to com.fasterxml.jackson.databind;
}

Módulos abertos

Se um módulo inteiro precisar de acesso por reflexão, algo comum em estruturas legadas, declare-o como open. Todos os pacotes ficam abertos para reflexão, embora as exports normais ainda controlem o acesso em tempo de compilação.

open module com.example.beans {
    requires java.logging;
}

Legibilidade versus acessibilidade

Duas condições devem ser atendidas ao mesmo tempo para usar o tipo de outro módulo:

Legibilidade: seu módulo declara requires para o módulo deles
Acessibilidade: o módulo deles exports o pacote e o tipo é público

Se uma delas faltar, o compilador rejeitará seu código.

Reunindo tudo

Um módulo bem formado que reexpõe tipos JDBC e abre entidades para uma biblioteca JSON:

module com.example.service {
    requires transitive java.sql;
    requires static com.example.annotations;

    exports com.example.service.api;
    exports com.example.service.spi to com.example.plugins;
    opens com.example.service.dto to com.fasterxml.jackson.databind;
}

Verificação rápida

Escolha a diretiva para tipos de API reexpostos.

Recapitulação

Você aprendeu as diretivas de dependência e visibilidade:

requires, requires transitive, requires static
exports e exports ... to qualificado
opens e open module para reflexão
O uso exige tanto legibilidade quanto acessibilidade

A seguir: desacoplamento com serviços por meio das diretivas de fornecimento e uso.

Perguntas Frequentes

A aula “requires e exports” é grátis?

Sim — o texto completo de “requires e exports” é 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 “requires e exports”?

Controle dependências e visibilidade. 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 2 de 4.

Quanto tempo leva a aula “requires e exports”?

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