Organizando os Códigos em Pacotes

Problema

Problema: sua aplicação consiste em grupos de classes Java, interfaces e outros tipos. Você quer organizar esses arquivos para ficar mais fácil a manutenção e evitar potencial conflitos com nomes de classes.

Solução

Solução: criar pacotes Java e colocá-los dentro de um sistema de arquivo. Pacotes Java pode ser utilizado para organizar grupos lógicos de arquivos dentro da aplicação.

Pacotes podem ajudar organizar códigos, reduzir conflitos de nomes de classes e outros arquivos, e fornece acesso de controle. Para criar um pacote, simplesmente crie um diretório dentro da pasta raiz e dê um nome a ele.

Pacotes geralmente estão um dentro do outro e seguem uma convenção para o nome. Vamos dizer que os pacotes estão organizados com o nome juneau e organiza widgets.

Para organizar todo o código da aplicação widget, crie um grupo de pacotes aninhados conforme segue a estrutura:

org/juneau

Qualquer arquivo de código que for colocado dentro desse pacote precisa ter na primeira linha a declaração package org.juneau. Essa declaração diz onde esse arquivo se encontra. Por exemplo, suponha que a classe main da aplicação tem o nome de JuneauWidgets.java.

Para colocar essa classe dentro do pacote chamado org.juneau, mova fisicamente esse arquivo para dentro do diretório juneau, o qual está dentro do diretório org, o qual é a pasta raiz da aplicação. O código fonte ficaria assim:

package org.juneau;

public class JuneauWidgets {

            public static void main(String[] args){

                        System.out.println(“Bem-vindo a minha aplicação!”);

}

}

Veja que na primeira linha está o caminho onde se encontra esse arquivo e que as pastas na declaração são separadas por pontos.

Uma aplicação pode ter vários pacotes. Se a aplicação contém poucas classes, todas elas poderiam ficar no pacote org.juneau. Se a aplicação tivesse interfaces, poderíamos criar um outro pacote e colocar essas interfaces no pacote org.juneau.interfaces.

Como Funciona

Como funciona: os pacotes Java são úteis para organizar os arquivos fontes, controle de acesso e evitar conflitos com os nomes. Os pacotes estão representados em diretórios físicos no sistema de arquivo, que podem conter arquivos de código fonte.

Cada arquivo do código fonte deve ter a declaração do pacote na primeira linha. Essa declaração diz onde esse arquivo se encontra. Por exemplo: package org.juneau;

Essa declaração diz que o arquivos está dentro do diretório juneau, e esse diretório está dentro do diretório org. Os nomes dos pacotes variam dependendo da empresa.

Contudo, é importante que as palavras estejam em letras minúsculas para não conflitar com os nomes de arquivos de classes. Muitas empresas utilizam o seu domínio para nomear o pacote, ex: br.com.micheladrianomedeiros. Contudo, se o domínio incluir hifens, underscore devem ser utilizados.

Veja

Veja: Quando uma classe reside dentro do pacote java, ela não é apenas referenciada pelo o nome da classe, mas, pelo nome do pacote anexado ao nome da classe, isso é conhecido como declaração completa (fully qualified name).

Por exemplo, o arquivo JuneauWidgets.java está contido dentro do pacote org.juneau, a classe é referenciada utilizando org.juneau.JuneauWidgets, e não simplesmente JuneauWidgets. Outra classe com o mesmo nome pode está em outro pacote, por exemplo, org.java9recipes.JuneauWidgets.

Pacotes são muito úteis para estabelecer níveis de segurança como em uma organização. Por padrão, classes diferentes que residem no mesmo pacote tem acesso uma a outra.

Se o arquivo reside em um pacote diferente do outro, precisa utilizar a declaração import no topo do arquivo para ter acesso ao arquivo, isso significa que você deve declarar o caminho do arquivo que deseja importar. Por exemplo: import org.juneau.JuneauWidgets;

Caso queira importar mais de uma classe do pacote ou até todas, basta utilizar o asteriscos(*) no lugar do nome da classe. Dessa maneira será importada todas as classes do pacote, por exemplo: import org.juneau.*. Normalmente se importa apenas os arquivos que serão utilizados.

As importações também são feitas da API do Java, a biblioteca do Java tem vários pacotes e classes que você pode utilizar a declaração import para poder utilizar alguma classe.

Entendendo as Declarações e Importações de Pacotes

Fonte: Java 9 Recipes: A Problem-Solution Approach (English Edition)