Criando Exceções Personalizadas em Java: Guia Passo a Passo
O que é Exceção Personalizada em Java?
Exceção personalizada é classe definida pelo usuário que estende java.lang.Exception (ou RuntimeException para cenários não verificados). Criando seu próprio tipo de exceção, você pode representar condições de erro específicas do domínio, tornar tratamento de erros mais claro e fornecer contexto mais rico aos chamadores.

Na prática, raramente precisa sobrescrever todos métodos de Exception. Personalização mais comum envolve adicionar construtores que aceitam código de erro, mensagem ou causa subjacente. Abaixo exemplo conciso demonstrando passos essenciais.
Exemplo: Definindo e Lançando Exceção Personalizada
Passo 1 – Crie a classe de exceção
public class MinhaExcecao extends Exception {
private final int codigoErro;
public MinhaExcecao(int codigoErro) {
super("Código de erro: " + codigoErro);
this.codigoErro = codigoErro;
}
@Override
public String toString() {
return "MinhaExcecao{codigoErro=" + codigoErro + "}";
}
}
Passo 2 – Use a exceção no código cliente
public class DemoExcecaoJava {
public static void main(String[] args) {
try {
// Simula condição de falha
throw new MinhaExcecao(2);
} catch (MinhaExcecao e) {
System.out.println(e);
}
}
}
Ao executar, verá saída:

No exemplo acima, palavra-chave throw cria instância de MinhaExcecao e imediatamente passa para bloco catch correspondente mais próximo. Método toString() sobrescrito garante mensagem impressa informativa.
Principais Conclusões
- Estenda
Exception(ouRuntimeException) para criar tipo personalizado. - Forneça construtores que passem mensagens significativas para superclasse.
- Sobrescreva
toString()ougetMessage()para saída de debug mais clara. - Use
throwpara lançar exceção; capture onde puder tratar ou propagar.
Seguindo estas práticas, escreverá código Java mais manutenível, auto-documentado, que trata graciosamente condições de erro específicas do domínio.
Java
- Entendendo a Palavra-chave final em Java: Variáveis, Métodos e Classes
- Operador instanceof em Java: Guia Completo
- Entendendo Classes Aninhadas Estáticas em Java: Uso, Diferenças e Exemplos
- Dominando Classes Internas Anônimas em Java: Definição, Sintaxe e Exemplos Práticos
- Padrão Singleton em Java Explicado: Como Implementar e Usar com Segurança
- Dominando Reflection em Java: Inspecionando Classes, Métodos e Campos em Tempo de Execução
- Dominando Tratamento de Exceções em Java: Try, Catch, Finally, Throw e Throws Explicados
- Dominando Java ObjectOutputStream: Serialização, Métodos e Exemplos Práticos
- Dominando Java Generics – Construindo Código Reutilizável e Type-Safe
- Dominando Operações de Arquivo em Java com java.io – Criação, Leitura, Escrita e Exclusão