Пользовательские исключения

Часть раздела Объектно-ориентированное программирование путешествия по Java на Coddy — урок 60 из 87.

Встроенные исключения Java охватывают многие распространенные сценарии ошибок, но иногда вам нужны исключения, специфичные для предметной области вашего приложения. Пользовательские исключения позволяют создавать значимые типы ошибок, которые четко сообщают о том, что пошло не так.

Чтобы создать пользовательское исключение, просто расширьте существующий класс исключения. Для проверяемого исключения расширьте Exception:

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

Для непроверяемого исключения наследуйте RuntimeException:

public class InvalidAgeException extends RuntimeException {
    public InvalidAgeException(String message) {
        super(message);
    }
}

Вызов super(message) передает сообщение об ошибке родительскому классу, делая его доступным через getMessage(). Затем вы можете выбрасывать и перехватывать ваше пользовательское исключение так же, как и любое другое:

public void withdraw(double amount) throws InsufficientFundsException {
    if (amount > balance) {
        throw new InsufficientFundsException("Balance too low: " + balance);
    }
    balance -= amount;
}

// Использование
try {
    account.withdraw(1000);
} catch (InsufficientFundsException e) {
    System.out.println(e.getMessage());
}

Пользовательские исключения делают ваш код более читаемым и позволяют вызывающему коду обрабатывать конкретные условия ошибок по-разному. Они особенно ценны при создании API или библиотек, где важна четкая передача информации об ошибках.

Задание

Легко

Давайте создадим систему бронирования билетов, которая использует пользовательские исключения для обработки различных сценариев ошибок! Вы создадите информативные типы исключений, которые четко сообщают о том, что пошло не так при бронировании билетов.

Вы организуете свой код в четырех файлах:

TicketSoldOutException.java: Создайте пользовательское проверяемое исключение (наследуется от Exception) для случаев, когда билеты закончились. Ваше исключение должно принимать сообщение в конструкторе и передавать его родительскому классу с помощью super(message).
InvalidSeatException.java: Создайте пользовательское непроверяемое исключение (наследуется от RuntimeException) для случаев, когда кто-то пытается забронировать неверный номер места. Это исключение также должно принимать и передавать сообщение своему родителю.
TicketBooth.java: Создайте класс, который управляет продажей билетов. Ваша касса должна отслеживать общее количество доступных мест и максимально допустимый номер места. Включите:
Конструктор, который принимает общее количество доступных мест.

Метод bookTicket(int seatNumber), который проверяет бронирование. Если билетов не осталось (доступных мест 0 или меньше), выбросьте TicketSoldOutException с сообщением "No tickets remaining". Если номер места меньше 1 или больше общего количества мест, выбросьте InvalidSeatException с сообщением "Seat [seatNumber] does not exist". В противном случае уменьшите количество доступных мест на 1 и выведите Booked seat [seatNumber] successfully.

Метод getAvailableSeats(), который возвращает текущее количество доступных мест.
Main.java: Объедините вашу билетную систему! Вы получите два входных значения: общее количество мест и номер места для бронирования.
Создайте TicketBooth с заданным общим количеством мест. Затем попытайтесь забронировать указанный номер места внутри блока try-catch. Поскольку TicketSoldOutException является проверяемым, вы должны его обработать. Сначала поймайте TicketSoldOutException и выведите Booking failed: [exception message]. Затем поймайте InvalidSeatException и выведите в том же формате: Booking failed: [exception message].

После блока try-catch выведите Remaining seats: [count], используя метод-геттер.

Вы получите два входных значения по порядку: общее количество мест (целое число) и номер места для бронирования (целое число).

Обратите внимание, как проверяемые исключения заставляют вызывающую сторону обрабатывать их (с помощью try-catch или throws), в то время как непроверяемые исключения не требуют явной обработки. Выбирайте тип исключения в зависимости от того, является ли ошибка чем-то, что вызывающая сторона должна предвидеть и от чего должна уметь восстановиться!

Попробуйте сами

import java.util.Scanner;

class Main {
    public static void main(String[] args) {
        Scanner scanner = new Scanner(System.in);
        int totalSeats = scanner.nextInt();
        int seatNumber = scanner.nextInt();
        
        // TODO: Создайте TicketBooth с заданным общим количеством мест
        
        // TODO: Используйте блок try-catch, чтобы попытаться забронировать место
        // - Сначала перехватите TicketSoldOutException и выведите "Booking failed: [exception message]"
        // - Перехватите InvalidSeatException и выведите "Booking failed: [exception message]"
        
        // TODO: После try-catch выведите "Remaining seats: [count]"
    }
}