CodeGym /Cursos /JAVA 25 SELF /Enumeração: enum

Enumeração: enum

JAVA 25 SELF
Nível 10, Lição 4
Disponível

1. Introdução

Em programação, muitas vezes lidamos com listas de opções previamente conhecidas e limitadas. Por exemplo: dias da semana, cores do semáforo, níveis de dificuldade de um jogo, status de um pedido. Cada uma dessas opções costuma ser representada por um valor fixo. É aqui que nos aproximamos do tema de hoje — enumerações (enum).

Enumeração é um tipo de dado especial que permite declarar um conjunto de constantes nomeadas.

enum — é como uma caixa com etiquetas organizadas em compartimentos, em que cada etiqueta é um nome único associado a um número.

Principais vantagens do enum:

  • Seu código se torna legível e autodocumentado;
  • Em vez de “números mágicos” como 0, 1, 2, surgem nomes expressivos: DayOfWeek.MONDAY ou TrafficLight.RED;
  • O compilador reclamará se você tentar atribuir um valor incorreto;
  • Por trás de cada elemento há… um número inteiro comum! (Voltaremos a isso.)

Sintaxe de declaração de enum


// Modelo geral de declaração de enumeração
public enum Imya
{
    KONSTANTA1 ,
    KONSTANTA2 ,
    KONSTANTA3
}
Sintaxe de declaração de enumeração

Declarar uma enumeração em Java é muito simples. Aqui vai um exemplo básico:

// Arquivo DayOfWeek.java
public enum DayOfWeek {
    MONDAY,			// 0	
    TUESDAY,		// 1
    WEDNESDAY,		// 2
    THURSDAY,		// 3
    FRIDAY,			// 4
    SATURDAY,		// 5
    SUNDAY			// 6
}

Explicação:

  • A palavra-chave enum diz ao compilador: “Isto é uma enumeração!”
  • Entre chaves, separados por vírgulas, vêm os nomes das opções (constantes).
  • É comum escrever os nomes em UPPER_SNAKE_CASE (todas as letras maiúsculas, palavras separadas por sublinhado).

Onde posso declarar um enum?

  • Em um arquivo separado (DayOfWeek.java).
  • Dentro de uma classe (se você precisa de uma enumeração privada apenas para essa classe).
  • Até mesmo dentro de um método (embora isso seja raro).

2. Usando enum no código

Declaração de variável enum:

DayOfWeek today = DayOfWeek.MONDAY;

Agora today pode assumir apenas um dos valores declarados em DayOfWeek.

Exemplo de uso com switch

switch (today) 
{
    case MONDAY:
        System.out.println("Ai, segunda-feira...");
        break;
    case FRIDAY:
        System.out.println("Oba, sexta-feira!");
        break;
    default:
        System.out.println("Dia comum.");
}

Diferencial importante: em case escrevemos apenas o nome da constante (sem prefixo), se o tipo da variável já for conhecido pelo compilador.

Iterando por todos os valores do enum

Todo enum tem um método estático values(), que retorna um array com todos os seus valores:

for (DayOfWeek day : DayOfWeek.values()) 
{
    System.out.println(day);
}

Isso é muito útil para exibir menus, validar, gerar opções etc.

3. Métodos do enum: name(), ordinal(), valueOf()

Enums em Java — não são apenas listas de constantes, mas classes completas com métodos!

Método name()

Retorna o nome da constante como String (como está escrito no código):

DayOfWeek day = DayOfWeek.FRIDAY;
System.out.println(day.name()); // "FRIDAY"

Método ordinal()

Retorna o índice ordinal da constante (contagem a partir de zero):

System.out.println(DayOfWeek.MONDAY.ordinal()); // 0
System.out.println(DayOfWeek.FRIDAY.ordinal()); // 4

Atenção: não armazene nem compare enums pelo ordinal() se a ordem puder mudar no futuro! Prefira usar os nomes.

Método valueOf(String name)

Converte uma String em um valor do enum, se existir uma constante com esse nome:

DayOfWeek day = DayOfWeek.valueOf("MONDAY");
System.out.println(day); // MONDAY

Se a String não corresponder — será lançada a exceção IllegalArgumentException.

Método values()

Retorna o array com todos os valores do enum (já vimos um exemplo acima):

DayOfWeek[] days = DayOfWeek.values();

4. Enum com campos, construtor e métodos

Enums em Java podem ser estendidos: você pode adicionar campos, construtores e métodos! Sim, não é apenas uma lista de nomes, mas uma mini-classe.

Exemplo: dias da semana com nome localizado

public enum DayOfWeek 
{
    MONDAY("Segunda-feira"),
    TUESDAY("Terça-feira"),
    WEDNESDAY("Quarta-feira"),
    THURSDAY("Quinta-feira"),
    FRIDAY("Sexta-feira"),
    SATURDAY("Sábado"),
    SUNDAY("Domingo");

    private final String russianName;

    // Construtor (private por padrão)
    DayOfWeek(String russianName) 
    {
        this.russianName = russianName;
    }

    public String getRussianName() 
    {
        return russianName;
    }
}

Você saberá mais sobre como isso funciona quando começarmos a estudar POO nos níveis 27+ :P

Agora dá para fazer assim:

DayOfWeek day = DayOfWeek.WEDNESDAY;
System.out.println(day.getRussianName()); // "Quarta-feira"

Dica: cada valor do enum pode ter seus próprios dados (neste caso — um nome localizado).

Vantagens de usar enum

  • Segurança de tipos: não é possível atribuir acidentalmente à variável enum um valor que não esteja na lista.
  • Legibilidade: o código se autodocumenta (TrafficLight.RED em vez de 1 ou "red").
  • Facilidade de manutenção: se for preciso adicionar ou remover uma opção, isso é feito em um único lugar.
  • Funciona com switch: o enum é perfeito para ramificações por valor.
  • Expansível: é possível adicionar campos, métodos, implementar interfaces.
  • Menos erros: o compilador ajuda a não esquecer de tratar as opções (especialmente em construções com switch).

6. Prática: usando enum no nosso aplicativo

Vamos adicionar ao nosso miniaplicativo o suporte a dias da semana via enum.

Etapa 1. Declarar o enum

public enum DayOfWeek 
{
    MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY
}

Etapa 2. Usar no código

System.out.println("Digite o dia da semana (por exemplo, MONDAY):"); 
Scanner console = new Scanner(System.in);                      
String input = console.nextLine().toUpperCase();               
                                                               
DayOfWeek day = DayOfWeek.valueOf(input);                      
switch (day) 
{                                                 
    case MONDAY:                                               
        System.out.println("Início da semana útil!");          
        break;                                                 
    case FRIDAY:                                               
        System.out.println("Fim de semana chegando!");                 
        break;                                                 
    case SATURDAY:                                             
    case SUNDAY:                                               
        System.out.println("Oba, fim de semana!");                  
        break;                                                 
    default:                                                   
        System.out.println("Dia útil comum.");           
}                                                              

O que está acontecendo:

  • O usuário digita o dia da semana (por exemplo, "monday" ou "MONDAY").
  • Convertemos a String para maiúsculas (toUpperCase()) para não depender de maiúsculas/minúsculas.
  • Convertemos a String em um valor do enum via valueOf.
  • Usamos switch para imprimir mensagens diferentes.
  • Se algo inválido for digitado — capturamos o erro e mostramos um aviso.

7. Erros comuns ao trabalhar com enum

Erro nº 1: usar strings ou números em vez de enum. Com muita frequência, iniciantes continuam escrevendo assim:

int day = 1; // 1 — é segunda-feira?

ou

String status = "DELIVERED";

Isso é ruim: é fácil errar na grafia e o código fica difícil de manter. Use enum!

Erro nº 2: comparação de enum com == e .equals(). Em Java, é seguro comparar valores de enum com ==, porque todos os valores são únicos dentro da classe do enum:

if (day == DayOfWeek.MONDAY) { ... } // OK!

Embora .equals() também funcione, usa-se com mais frequência ==.

Erro nº 3: maus nomes para os elementos do enum. Não nomeie os elementos VALUE1, VALUE2, VALUE3 — em um mês ninguém vai entender o que isso significa! Use nomes significativos.

Erro nº 4: usar ordinal() na lógica. Não escreva assim:

if (day.ordinal() == 0) { ... } // Não faça isso!

A ordem dos elementos pode mudar, e tudo vai quebrar. Use os nomes!

1
Tarefa
JAVA 25 SELF, nível 10, lição 4
Bloqueado
Modelagem do semáforo 🚦
Modelagem do semáforo 🚦
1
Tarefa
JAVA 25 SELF, nível 10, lição 4
Bloqueado
Saudações sazonais no aplicativo 🌸☀️🍁❄️
Saudações sazonais no aplicativo 🌸☀️🍁❄️
1
Tarefa
JAVA 25 SELF, nível 10, lição 4
Bloqueado
Planejamento da semana no aplicativo 🗓️
Planejamento da semana no aplicativo 🗓️
1
Tarefa
JAVA 25 SELF, nível 10, lição 4
Bloqueado
Navegação em uma viagem espacial 🚀
Navegação em uma viagem espacial 🚀
Comentários
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION