Introdução à Estrutura Básica do Java

Para desenvolver aplicações robustas em Java, é essencial compreender os elementos fundamentais que compõem a linguagem. Isso inclui a maneira correta de documentar o código, as regras para nomeação de elementos e a definição rigorosa dos tipos de dados.

Comentários e Documentação

Comentários são trechos de texto ignorados pelo compilador, destinados exclusivamente à leitura humana. Eles servem para explicar a lógica, desativar temporariamente códigos ou gerar documentação automática. A adoção de uma prática consistente de comentários é vital para a manutenibilidade do software.

O Java suporta três modalidades de comentários:

• Linha única: Inicia com // e comenta todo o conteúdo até o fim da linha.
• Múltiplas linhas: Delimitado por /* e */, permitindo bloquear grandes trechos de código.
• Documentação (JavaDoc): Inicia com /** e é utilizado por ferramentas para gerar documentação oficial das classes e métodos.

public class ExemploComentarios {
    public static void main(String[] args) {
        // Este é um comentário de linha única
        System.out.println("Executando programa...");

        /* 
           Este é um bloco de comentário
           útil para explicações mais longas
           que ocupam várias linhas.
        */

        /**
         * Método principal de entrada.
         * @param args argumentos de linha de comando
         * @author Desenvolvedor Senior
         */
        
        // Exemplo de uso de variável
        int ano = 2024;
    }
}

Identificadores e Palavras-Chave

Todos os componentes de um programa Java, como classes, métodos e variáveis, necessitam de nomes únicos, conhecidos como identificadores. Existem regras estritas para sua criação:

• Podem conter letras, dígitos, underscores (_) e cifrões ($).
• Não podem iniciar com números.
• Não podem conter caracteres especiais como # ou *.
• Não podem ser palavras-chave reservadas da linguagem (como public, class, int).
• São sensíveis a maiúsculas e minúsculas (Case Sensitive).

public class RegrasNominais {
    public static void main(String[] args) {
        // Válidos
        String usuario = "admin";
        String Usuario = "gestor"; // Diferente de 'usuario' devido ao case sensitive
        String $valor = "100";
        String _id = "12345";

        // Inválidos (causariam erro de compilação se descomentados)
        // String 1place = "erro"; // Não pode começar com número
        // String #tag = "erro";   // Caractere especial inválido
        
        System.out.println(usuario);
    }
}

Tipos de Dados e Tipagem Forte

Java é uma linguagem de tipagem forte, o que significa que cada variável deve ter seu tipo declarado explicitamente antes do uso. Não é possível atribuir um valor incompatível ao tipo definido. As variáveis podem ser declaradas em sequência separadas por vírgula se forem do mesmo tipo.

Os tipos dividem-se em duas categorias principais:

Tipos Primitivos

São os tipos básicos pré-definidos pela linguagem, armazenando valores diretos na memória.

• Inteiros: byte, short, int (padrão), long (sufixo L).
• Ponto Flutuante: float (sufixo F), double (padrão).
• Caractere: char (antre aspas simples).
• Booleano: boolean (assume true ou false).

public class DefinicaoTipos {
    public static void main(String[] args) {
        // Declaração de números inteiros
        int quantidade = 150;
        byte pequeno = 12;
        short medio = 300;
        long grande = 5000000L;

        // Declaração de números decimais
        float precoUnitario = 19.99F;
        double pi = 3.14159;

        // Caractere único
        char letra = 'Z';

        // Lógico
        boolean ativo = true;
        boolean pendente = false;
        
        // Tipos de referência (exemplo)
        String mensagem = "Sistema operacional";
    }
}

Tipos de Referência

Qualquer tipo que não seja primitivo é considerado uma referência. Isso inclui classes, interafces e arrays. O tipo String, por exemplo, é uma classe e não uma palavra-chave primitiva, sando amplamente utilizado para manipulação de texto.