Создание собственного класса исключений в Java: примеры

public class MyCustomException extends Exception {
    public MyCustomException() {
        super();
    } // Конструктор без аргументов

    public MyCustomException(String message) {
        super(message);
    } // Конструктор с сообщением об ошибке
}

Представьте, что ваш код – это битва с ошибками:
- Стандартные исключения – это обычные стрелы (🏹), которые могут не долететь до своей цели.
- Собственные исключения – это стрелы, точно нацеленные на конкретную мишень.

public class MyCustomException extends Exception {
    public MyCustomException(String message) {
        super(message);
    }
}

**Цель и Выстрел**: `throw new MyCustomException("Точное попадание!");` 🚀

Это позволяет делать обработку ошибок точнее и понятнее!

## Лучшие практики для собственных исключений

### Определение конструкторов для различных сценариев

Не ограничивайтесь только конструкторами, принимающими **сообщение** об ошибке, создавайте также конструкторы, принимающие **причину ошибки** и их комбинации:

public MyCustomException(String message, Throwable cause) {
    super(message, cause);
}

public MyCustomException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
    super(message, cause, enableSuppression, writableStackTrace);
}

### Расширение информации о контексте ошибки

Вы также можете добавить некоторые методы для предоставления большего контекста, в дополнение к методу `getMessage()`:

private final String detail;

public MyCustomException(String message, String detail) {
    super(message);
    this.detail = detail;
}

public String getDetailMessage() {
    return detail;
}

### Оптимизация работы со стеком вызовов

Для увеличения производительности можно упростить обработку стека вызовов:

@Override
public Throwable fillInStackTrace() {
    return this; // Отключаем заполнение стека вызовов, возвращая 'this'
}

### Эффективное использование собственных исключений

- **Объявление исключения**: Добавьте `throws MyCustomException` в объявления методов, которые могут генерировать ваше исключение.
- **Перехват исключений**: Обрабатывайте исключения путём использования блока `try-catch`.

## Полезные материалы

1. [Oracle® Tutorial – Creating Exception Classes](https://docs.oracle.com/javase/tutorial/essential/exceptions/creating.html) — начните изучение с официальной документации Oracle по созданию собственных исключений.
2. [User-defined Custom Exception in Java – GeeksforGeeks](https://www.geeksforgeeks.org/user-defined-custom-exception-in-java/) — подробное руководство по этой теме.
3. [Java Exceptions – Tutorialspoint](https://www.tutorialspoint.com/java/java_exceptions.htm) — дополнительные примеры и объяснения.
4. [Custom Exceptions in Java – DZone](https://dzone.com/articles/custom-exceptions-in-java) — обсуждение того, зачем и как создавать собственные исключения.
5. [Java Custom Exception – javatpoint](https://www.javatpoint.com/custom-exception) — ещё одно полезное руководство по этой теме.
6. [Java Custom Exception Examples – DigitalOcean](https://www.digitalocean.com/community/tutorials/java-custom-exception-examples) — примеры использования собственных исключений в различных сценариях.