Пользовательские исключения
📖 Описание
Пользовательское исключение описывает условие приложения, для которого нет подходящего предопределённого имени. Его объявляют через 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.