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

CKTIS / Java

to — disponibilizar um pacote a módulos selecionados

Em Java SE 21, `to` é uma palavra-chave contextual utilizada nas diretivas `exports` e `opens`. Identifica os módulos aos quais o módulo declarante disponibiliza um determinado pacote.

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

Sintaxe

exports PackageName to ModuleName {, ModuleName};
opens PackageName to ModuleName {, ModuleName};

to é uma palavra-chave contextual, não reservada. Numa declaração de módulo, normalmente em module-info.java, introduz a lista de módulos de destino de uma diretiva exports ou opens. Fora do contexto adequado, pode ser um identificador, por exemplo, o nome de uma variável.

exports p to m; disponibiliza ao módulo m, durante a compilação e a execução, a API pública acessível do pacote p; as regras de acesso habituais continuam a aplicar-se. opens p to m; permite ao módulo m o acesso por reflexão, incluindo ao conteúdo não público do pacote, mas não disponibiliza o pacote para utilização normal em tempo de compilação. Sem to, a diretiva não restringe os destinatários a uma lista específica. Os nomes após to identificam módulos, não pacotes; separa vários nomes com vírgulas.

to não cria uma dependência: um módulo que utiliza uma API exportada continua a precisar da relação de leitura adequada, fornecida no exemplo por requires demo.lib;. Repetir um nome de módulo na mesma cláusula to é um erro de compilação. Uma diretiva opens não pode surgir dentro de um open module. No exemplo, demo.api é exportado apenas para demo.app.

Exemplos

// src/demo.lib/module-info.java
module demo.lib {
    exports demo.api to demo.app;
}

// src/demo.lib/demo/api/Message.java
package demo.api;
public class Message {
    public static String text() {
        return "Hello";
    }
}

// src/demo.app/module-info.java
module demo.app {
    requires demo.lib;
}

// src/demo.app/demo/app/Main.java
package demo.app;
import demo.api.Message;
public class Main {
    public static void main(String[] args) {
        System.out.println(Message.text());
    }
}

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