Інструменти розробника · JSON форматування & реаніматор
Дійсно JSON проти дії проти схеми: два значення 'valid'
· Підземелля
Опубліковано ToolAcre · Редакція журналу
свінгери стандарти введення
Реактор каже, що ваш JSON Це означає, що це означає. Цей пост пояснює рівні дії (синтакси, структура, семантика) і чому JSON Шума існує для всього за граматику.
Дійсно, і все ще відхиляється
Запит може бути незрівнянним JSON і все ж неприпустимо API. `{"username":"nori","plan":"gold"}` має збалансовані глухі, цитовані імена та правові цінності, але послуга може вимагати повідомлення електронної пошти, відхилити назву плану або заборонити створення облікового запису в поточному стані. Розробки і додаток відповідають різним питанням, тому обидва результати можна виправити.
ToolAcre відповіді тільки перше питання: чи можна це зробити, як суворо JSON в межах його вхідної межі? Не завантажується щіма, перевіряємо необхідні властивості, перевіряємо формати, зв'язавшись з базою даних або оцінюйте правила ведення бізнесу. Коли інструмент говорить Дійсно, читати, як “відповіли” JSON синтаксис, не затвердження від системи, яка споживає значення.
Рівень: добре сформований синтаксис
Перевірка перевірки перевірки синтаксису JSON граматика: одне значення рівня, правильно паровані контейнери, цитовані назви об'єктів, дійсні коми і колонки, правові рядки, юридичні номери і точні літри. Відхилити `NaN` і `Infinity`, коментарі, причепи коми і однокоментовані рядки. Прийміть будь-яку граматику-відкладну форму, в тому числі номеру або об'єкт з ненависними полями.
У Малформе джерело є пунктом текстової відмови, тому ToolAcre може повідомити рядок і стовпець для першого незворотного характеру. Про це повідомляється про відсутність коми, що наступна цитата, причіпний кома може викликати закривання, що буде повідомлено. Виправлення синтаксису створює значення, але не встановлює, що значення має форму або значення, очікуване іншою програмою.
Рівень два: форма
Усвідчення форми запитує, чи відповідає заявленому контракту вартість. Користувач schema може знадобитися `email`, концентрат `age` до цілого принаймні 18, ліміт `tier` до `free` або `pro`, і невизначають невідомого властивості. `{"email":false,"tier":"gold"}` є дійсним JSON синтаксис, але не несе цих структурних правил, оскільки типи значень і дозволені варіанти невірно.
JSON Шма - один спосіб висловити такі обмеження, але ToolAcre не виконує його. А schema-абітор зазвичай повідомляє про те, що таке, як `/tier`, ключове слово, яке таке як `enum`, і пояснювальне повідомлення, а не догляд за parser. Тримайте версію схеми та API договір, що знаходиться на платі, коли діагностування цього рівня; зміна пунктуації не буде ремонтувати правильно, при цьому вартість неправильної форми.
Рівень три: значення
Значення залежить від фактів і правил за статичною формою документа. Анонім `accountId` може мати правильний шаблон рядків при наведенні облікового запису. Дата початку може відповідати ISO-формат стилю при падінні після закінчення дати. Кількість може бути позитивним, але не більше поточного запасу. Ці збої вимагають контексту заявки, збережених стану або відносин між полями.
Деякі сеймантичні обмеження можуть бути приблизні в шматемі, але багато хто належить до логіки обслуговування, де доступні авторські дані та стан транзакцій. Відповіді на цьому рівні повинні визначити відповідне поле або правило без попереднього закінчення JSON текст був збитий. ToolAcre не може відтворити ті рішення, оскільки не знає контракту, ані надсилає введення до програми, що володіє правилом бізнесу.
Зароблений приклад: один перезавантаження через три перевірки
Почати `{"sku":"A-19","quantity":3,"warehouse":"north"}`. ToolAcre приймає його: всі імена та значення слідувати JSON граматика. Шмама може потім вимагати об'єкту, неопомливий рядок SKU, позитивне ціле число і один з документівованих складських кодів. Надаючи цей перезаряджається занадто, щоб перенапруги. Нейтрий контроль підтвердив, що SKU А-19 чи існує на півночі три одиниці.
Послуга інвентаризації здійснює третє перевірку на поточні записи та може відхилити запит як 1.00. Зміна відступу не може змінити результат. У разі виникнення `quantity` були написані як `03`, синтаксис не буде першим; якщо це було `"3"`, парсінг пройде, але перевірка типу schema не буде; з номеричною `3`, тільки правило живого складу залишається. Так само поле може бути не в трьох різних шарах з трьох відмінних причин.
Де кожен чек належить
Запустіть перевірку синтаксису якнайшвидше, коли редагування, оскільки пізніше перевіряються не можуть працювати надійно на тексті, який не має парсеризації. Закріпити заявлену форму на кожному ненадійному ліміті заявки, а не допускати клієнта вже так. Оцінити варіант бізнесу в компоненті, який володіє необхідною державою, особливо якщо відповідь може змінитися між запитами.
Клієнт-замовити перевірки поліпшують зворотний зв'язок, але не замінюють сервер-захищений контроль. З повагою, відповідь сервера говорить “інвалід” JSON” повинні бути зарезервовані для відмови від парі, а не для кожного відхиленого запиту. Очистити поділ виробляє корисну діагностику: рядок та стовпець для синтаксису, наприклад, шляхи для структурних обмежень, та доменних кодів або повідомлень для сеймантичних конфліктів. ToolAcre поставляє тільки першу категорію.
Що це не криється
Цей форматувальник не є автором або оцінюється JSON Шума, виберіть схему схеми, вирішуйте посилання на схему, вставте за замовчуванням або комірки в цифри. Не знаю, що це не знає API’S OpenAPI документ або спеціальні умови перевірки. Подача схеми поряд з входом не змінить ToolAcre’s результат, тому що в цьому інструменті немає schema-processing кроку.
Синтаксис, що підтверджується також, не виявляє дублікати імен об'єкта; `JSON.parse` зберігає останнє залягання до форматування. Нор гарантується неоднорідна точність, канонічні байти, безпечне надання або авторизація. Кожен з тих, хто вимагає свого договору та реалізації. Уникайте компресійних стиснень в одну зелену «відкладну» значок, оскільки так приховує, які докази були зібрані і які питання ніколи не запропонували.
Похід: «відкладений» потребує кваліфікатора
Визначте всі вимоги щодо перевірки. «Валід JSON” означає текст, що має граматику. «Вальд проти цього стеми» означає, що номінальна вартість задовольняє названий структурний контракт. «Прийнята послугою» – це можливість отримання дозволу на використання діючих правил. Проходячи один шар необхідно для наступного в багатьох робочих процесах, але це ніколи не свідчить про те, що всі пізніше шари пропускаються.
Контакти ToolAcre у форматі та перевірте суворий синтаксис, включаючи відмову від не-JSON лілі такі як `NaN` і `Infinity`. Потім використовуйте схему і додаток, що фактично регулюють навантаження. Коли запит все ще не зникає, почитайте помилки на своєму рівні замість багаторазового переформатування JSON. Інструмент не має ніяких перевірок схеми, і це явного ліміту є більш корисним, ніж переважна обіцянка дійсності.