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

📖 Описание

Пользовательское исключение описывает условие приложения, для которого нет подходящего предопределённого имени. Его объявляют через EXCEPTION, явно поднимают RAISE и обрабатывают в разделе EXCEPTION.

🧩 Объявление, вызов и обработка

DECLARE
  e_no_seats EXCEPTION;
  v_seats PLS_INTEGER := 0;
BEGIN
  IF v_seats = 0 THEN
    RAISE e_no_seats;
  END IF;
  DBMS_OUTPUT.PUT_LINE('Booking accepted');
EXCEPTION
  WHEN e_no_seats THEN
    DBMS_OUTPUT.PUT_LINE('Select at least one seat');
END;
/
-- Select at least one seat

Объявление e_no_seats EXCEPTION; создаёт имя. RAISE e_no_seats; прерывает текущую выполняемую часть. Ветка WHEN e_no_seats THEN задаёт реакцию; строка Booking accepted в этом запуске не выполняется.

💻 Пользовательское исключение в процедуре

Для учебного бронирования разрешено от 1 до 6 целых мест. Проверка относится к размеру одного бронирования, а не к расчёту свободных мест в зале. NULL, ноль, отрицательные, дробные значения и число больше 6 отклоняются.

CREATE TABLE demo_custom_bookings (
  booking_id NUMBER PRIMARY KEY,
  seats NUMBER(3) NOT NULL
);

CREATE OR REPLACE PROCEDURE demo_book_seats(p_id NUMBER, p_seats NUMBER) IS
  e_invalid_seats EXCEPTION;
BEGIN
  IF p_seats IS NULL OR p_seats < 1 OR p_seats > 6 OR p_seats <> TRUNC(p_seats) THEN
    RAISE e_invalid_seats;
  END IF;
  INSERT INTO demo_custom_bookings (booking_id, seats) VALUES (p_id, p_seats);
EXCEPTION
  WHEN e_invalid_seats THEN
    RAISE_APPLICATION_ERROR(-20081, 'Select 1 to 6 whole seats');
  WHEN OTHERS THEN
    RAISE;
END;
/

Локальное имя e_invalid_seats не видно вызывающему блоку. Чтобы передать узнаваемую ошибку через границу подпрограммы, обработчик использует RAISE_APPLICATION_ERROR с кодом приложения. Диапазон кодов — от -20000 до -20999; сообщение ограничено 2048 байтами. Неожиданные ошибки сохраняются повторным RAISE.

💻 Пользовательское исключение в функции

Функция считает плату на одного гостя. Проверка числа гостей выполняется до деления; на успешном пути есть RETURN.

CREATE OR REPLACE FUNCTION demo_fee_per_guest(p_total NUMBER, p_guests NUMBER)
RETURN NUMBER IS
  e_invalid_guests EXCEPTION;
BEGIN
  IF p_guests IS NULL OR p_guests <= 0 OR p_guests <> TRUNC(p_guests) THEN
    RAISE e_invalid_guests;
  END IF;
  RETURN ROUND(p_total / p_guests, 2);
EXCEPTION
  WHEN e_invalid_guests THEN
    RAISE_APPLICATION_ERROR(-20082, 'Guest count must be a positive integer');
END;
/

NULL в p_total остаётся неизвестной суммой и даёт NULL; функция проверяет число гостей, а не устанавливает правила допустимости общей суммы.

💻 Обработка кода приложения по имени

PRAGMA EXCEPTION_INIT связывает объявленное в вызывающем блоке имя с кодом -20081. Это позволяет обработать конкретную ошибку без общего WHEN OTHERS.

DECLARE
  e_seat_limit EXCEPTION;
  PRAGMA EXCEPTION_INIT(e_seat_limit, -20081);
BEGIN
  SAVEPOINT before_custom_demo;
  demo_book_seats(51, 6);
  BEGIN
    demo_book_seats(52, 7);
  EXCEPTION
    WHEN e_seat_limit THEN
      DBMS_OUTPUT.PUT_LINE('Seat limit: ' || SQLCODE);
  END;
  DBMS_OUTPUT.PUT_LINE('Fee per guest: ' || demo_fee_per_guest(420, 6));
  ROLLBACK TO before_custom_demo;
EXCEPTION
  WHEN OTHERS THEN
    ROLLBACK TO before_custom_demo;
    RAISE;
END;
/
-- Seat limit: -20081
-- Fee per guest: 70

Бронирование 51 успешно вставляется, 52 не вставляется. После отката учебная таблица пуста. DDL для таблицы и обеих подпрограмм выполните до этого блока: CREATE делает неявный COMMIT.

📌 Примечания

Для локального исключения, которое поднимается и ловится внутри доступной области видимости, EXCEPTION_INIT не нужен. Имя само по себе не задаёт отдельный код ORA-20xxx. RAISE без имени в обработчике повторяет текущую ошибку. Исключение из обработчика или из инициализации декларативной части обрабатывается внешним блоком, а не соседними WHEN того же блока.

См. предопределённые исключения и WHEN OTHERS. Включите DBMS Output в клиенте для просмотра сообщений.

Документация Oracle 19c: raising-exceptions-explicitly, EXCEPTION_INIT-pragma, exception-propagation, exception-handler.