Entendendo a Estrutura de um Programa Java: Pacotes, Classes e Métodos

Por Gaspar Barancelli Junior em 25 de janeiro de 2025

Introdução

Todo programa Java segue uma estrutura básica composta por pacotes, classes e métodos. Esses elementos são fundamentais para organizar e modularizar o código, tornando-o mais legível, reutilizável e fácil de manter. Neste post, exploraremos cada um desses componentes, com exemplos claros para ajudá-lo a entender como eles funcionam e como são utilizados na prática.

O Que São Pacotes?

Pacotes em Java são usados para organizar as classes e outros elementos do código. Eles funcionam como pastas em um sistema de arquivos, ajudando a agrupar classes relacionadas e a evitar conflitos de nomes.

https://s3.us-east-1.amazonaws.com/gasparbarancelli.com/pacotes-java.png[align="center"
Figure 1. Exemplo de pacotes de uma aplicação Java

Criando e Usando Pacotes

Os pacotes são definidos na primeira linha do arquivo, utilizando a palavra-chave package.

Exemplo de Pacote

package com.exemplo.meupacote;

public class MinhaClasse {
    public static void main(String[] args) {
        System.out.println("Esta classe está dentro de um pacote.");
    }
}

Para usar uma classe de outro pacote, você precisa importá-la utilizando a palavra-chave import:

import com.exemplo.meupacote.MinhaClasse;

O Que São Classes?

Classes são os blocos básicos de construção de um programa Java. Elas encapsulam dados (variáveis) e comportamento (métodos), permitindo modelar objetos do mundo real ou conceitos abstratos.

Estrutura de Uma Classe

Uma classe em Java é definida com a palavra-chave class e pode conter:

  • Variáveis (atributos).

  • Construtores.

  • Métodos (comportamentos).

Exemplo de Classe Simples

public class Pessoa {

    // variáveis
    private final String nome;
    private final int idade;

    // construtor
    public Pessoa(String nome, int idade) {
        this.nome = nome;
        this.idade = idade;
    }

    // método
    public void apresentar() {
        System.out.println("Olá, meu nome é " + nome + " e tenho " + idade + " anos.");
    }

}

O Que São Métodos?

Métodos são blocos de código que executam ações ou comportamentos. Eles podem receber parâmetros, retornar valores ou simplesmente executar instruções.

Estrutura de Um Método

Um método é definido com a seguinte estrutura:

modificadorDeAcesso tipoDeRetorno nomeDoMetodo(parametros) {
    // Corpo do método
}

Exemplo de Método

public class Calculadora {
    public int somar(int a, int b) {
        return a + b;
    }
}

Você pode chamar esse método da seguinte maneira:

public class Principal {
    public static void main(String[] args) {
        Calculadora calculadora = new Calculadora();
        int resultado = calculadora.somar(5, 3);
        System.out.println("Resultado: " + resultado);
    }
}

Relacionando Pacotes, Classes e Métodos

Vamos criar um exemplo completo que demonstra a interação entre pacotes, classes e métodos.

Exemplo Completo

// Arquivo: com/exemplo/model/Pessoa.java
package com.exemplo.model;

public class Pessoa {

    private final String nome;
    private final int idade;

    public Pessoa(String nome, int idade) {
        this.nome = nome;
        this.idade = idade;
    }

    public void apresentar() {
        System.out.println("Olá, meu nome é " + nome + " e tenho " + idade + " anos.");
    }
}
// Arquivo: com/exemplo/main/ProgramaPrincipal.java
package com.exemplo.main;

import com.exemplo.model.Pessoa;

public class ProgramaPrincipal {
    public static void main(String[] args) {
        Pessoa pessoa = new Pessoa("Ana", 30);
        pessoa.apresentar();
    }
}

Boas Práticas ao Trabalhar com Pacotes, Classes e Métodos

  1. Use Nomes Significativos Escolha nomes que reflitam o propósito de cada pacote, classe ou método.

  2. Organize o Código com Pacotes Existem diversas boas práticas quando falamos de organização de pacotes. No entanto, acredito que, para quem está iniciando, o ideal seja separar os pacotes por domínio. Nos próximos posts, abordaremos esse método e também explicaremos sobre arquitetura limpa e hexagonal, as quais possuem padrões estabelecidos para a nomenclatura dos pacotes.

  3. Adote Convenções de Nomenclatura

    • Pacotes: letras minúsculas (ex.: com.exemplo.util).

    • Classes: CamelCase com inicial maiúscula (ex.: MinhaClasse).

    • Métodos: CamelCase com inicial minúscula (ex.: calcularMedia).

  4. Documente o Código Use comentários para explicar a funcionalidade de classes e métodos.

Conclusão

Pacotes, classes e métodos formam a base da estrutura de qualquer programa Java. Compreender como eles funcionam e como usá-los corretamente é essencial para escrever código organizado, reutilizável e fácil de manter.

Nos próximos posts da série "Aprendendo Java do Zero: Guia Completo para Iniciantes", teremos uma "Introdução à Programação Orientada a Objetos (POO) em Java: Conceitos Essenciais".

// Compartilhe esse Post

💫
🔥 NOVO APP

Domine o Inglês em 30 dias!

Inteligência Artificial + Repetição Espaçada • Método cientificamente comprovado

✅ Grátis para começar 🚀 Resultados rápidos
×