Введение
Система обработки исключительных ситуаций - комплекс решений реализованных в разных частях системы, обеспечивающих - описание, реализацию вызова и обработку исключительных ситуаций. Решения связаны набором соглашений, которым должны удовлетворять - студия, реализации действий, движки.
Для презентации всей картины, отражающей работу с исключениями, опишем ее в виде сценария, от появления понятия исключения, до вариантов использования информации предоставляемой исключением.
Тип исключения
Тип исключения - Соглашение о составе данных, являющихся частью экземпляра данного типа исключения.
Унифицированная структура (тип исключения) необходима в системе с целью передачи информации о ошибках между компонентами системы (сериализация\десериализация) исключив при этом необходимость поддержания множества типов исключений (создаваемых авторами действий) и реализации данных типов, для каждой из платформ исполнения. Достигается это путем создания одного "универсального" типа исключения, экземпляр которого жестко не специфицирован и в режиме исполнения может нести множество данных во вложенном словаре типа ключ-значение. То есть, соглашение между автором и потребителем исключения является так сказать "мягким" (оговоренным в документации на исключение), а не "жестким" (зафиксированным например в XSD, которое могло бы описывать тип исключения). Автор исключения декларирует в документации, что экземпляр его типа будет нести такие то данные, которые можно извлечь по ключу. Тот кого интересует конкретный контент заключенный в экземпляре исключения, сможет его достать по заранее известному ему ключу. Это возможно потому, что специфические типы исключений всегда обрабатываются специализированными обработчиками (которые точно знают, какие данные им нужно извлечь из экземпляра исключения).
Структура типа исключения
Идентификатор типа исключения
Идентификатор типа исключения - строка, однозначно идентифицирующая тип исключения
| Name | Наименование свойства | Тип | Описание |
|---|---|---|---|
| typeID | Идентификатор типа исключения | Строка | Строковый ID уникально идентифицирующий тип исключения в системе. Потребитель - всегда человек (не важно, просматривающий лог робота, или создающий сценарий робота). По данному идентификатору типа, человек обращается к справочной информации, чтобы узнать какое содержимое может содержать экземпляр данного типа во вложенном словаре. |
Базовый набор свойств исключения
Работа с исключением с точки зрения создателя действий
Класс исключения Robin
Устройство и логика работы действия TryCatch
Логика работы движка при обработке исключений
Тип исключения
С целью унифицировать формат
Реализации действий
Тезисно:
- Создается одна универсальная структура для описания исключения (содержащая словарь для дополнительной информации специфической для типа исключнения). Эту структуру используют авторы экшенов чтобы бросить исключение. Если при выполнении действия движком он ловит исключение среды исполнения (clr, jvm и пр.) то экземпляр класса исключения преобразуется в данную структуру и дальше обрабатывается как и исключение брошенное автором действия. Единственное - устанавливается тип исключение Unknown (так как оно не предусматривалось автором действия и не было задекларировано).
- Авторы действий декларируют (наряду с параметрами и результатами) типы исключений которые может генерить их действие (документируя так же и возможные ключи-значения словаря входящего в состав структуры описывающей исключение. т.е. специфицируя и доп информацию которая может быть включена в исключение)
- Экземпляры задекларированных исключений действия доступны для использования в схеме робота так-же как и результаты работы действия. Но доступны они для использования сразу после их создания (еще до окончания работы действия).
- Действие TryCatch, при помощи которого и строится обработка исключений в схеме робота, имеет один задекларированный экземпляр исключения. Этот экземпляр устанавливается в значение, которое выбросило одно из действий помещенных в в блок Try.
Вариант реализации - изнутри экшена зовем сервис выполнения последоватльности и флагом указываем, что в случае ошибки в последовательности присваивать ошибку в контекст моего действия. Если флага нет, то ошибка всплывает выше в иерархии.
Картинка во вложении