Подробное описание ошибок валидации #21

d-hurricane · 2025-01-13T21:20:47Z

Первый проход в решении задачи #16 . Начал с того, что обернул всю работу с ошибками и предупреждениями в отдельные методы. Т.о. в дальнейшем в рамках этой же задачи будет проще изменить формат описания ошибок на выходе валидации. Попутно кое-что отрефакторил, подсветил пару вопросов метками TODO, а также предложил варианты для будущих кодов ошибок.

Прошу провести ревью. После него продолжу решение задачи в рамках этого же pull request.

d-hurricane · 2025-01-14T22:33:49Z

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

Колонка	Тип	Описание
КодОшибки	Строка	Постарался придумать коды ошибок так, как если бы это были названия классов в ООП. Сразу прошу прощения, с английским у меня туго. В итоге получилось не рыба, ни мясо, как мне кажется. Через чур подробно, хочется укрупнить категории ошибок. Но тогда теряется возможность собственной локализации языка ошибок на стороне клиента.
Позиция	Массив	Сперва хотел сделать строкой, разделив части пути точками, но потом подумал, что имена полей сами могу иметь точки. И тогда на стороне клиента будут трудности с автоматической локализации позиции ошибки. Может, если и выводить позицию строкой, то стоит это сделать в формате json-ссылок с экранированием слешей в именах свойств?
Представление	Строка	Прежнее сообщение об ошибке, осталось почти без изменений.
Предупреждение	Булево	Признак, по которому разделяем ошибки от предупреждений. Хотел сперва использовать что-то вроде уровней важности, но не придумал, как использовать больше двух имеющихся.
ДополнительныеПараметры	Структура	Коллекция с дополнительной информацией об ошибке. Не всегда по содержимому совпадает с параметрами, используемыми при формировании представления ошибки. Не решил, надо ли это вообще.