Перейти до основного вмісту

Документи веб-сервера

інформація

Документи веб-сервера призначені для опису конкретної предметної області, яка використовується в веб-застосунку. Ці документи мають дворівневу структуру: на першому рівні знаходиться документ точки входу, який відповідає за реєстрацію похідних документів другого рівня. Документи другого рівня є кінцевою реалізацією певного спектра логіки предметної області.

Маршрути та події

Маршрути та події використовуються для детального опису кінцевих маршрутів або подій та їх обробників у системі. Вони використовуються під час обробки запитів: веб-сервер знаходить потрібний сервіс, область застосування та кінцевий маршрут або подію. Потім формується контекст виконання обробника та викликається сам обробник, якому передається сформований контекст, дані запиту та агенти функціональності, що описують бізнес-логіку. Якщо є результат, він обробляється та повертається як відповідь на запит.

інформація

Формування контексту запиту залежить від типу доступу, наявність сесій користувача тощо.

примітка

При описі обробників кінцевого маршруту використовується типізація структур, які будуть передані в обробник.

route-event-call.svg

Побудова обробників запитів повинна відбуватись за шаблоном "Композиція", де кожна стадія розміщується у відповідному документі, а робота в обробниках полягає лише в зверненні до цих функцій.

route-event-arch.svg

порада

Композиція, як підхід у побудові програмного коду, має кілька очевидних переваг. По-перше, вона дозволяє ефективно перевикористовувати код, що спрощує підтримку та оновлення кодової бази. Також вона забезпечує ізоляцію та явний виклик стадій для обробки помилок, що допомагає підтримувати стабільність та надійність програми.

Проте існує й недолік: використання композиції може призвести до збільшення рівня шаблонного коду, оскільки бізнес-логіка розподіляється на окремі функції. Це може призвести до збільшення складності та ускладнити розуміння коду, тому композицію слід створювати, коли стадій роботи обробника стає більше 2.

Схеми та репозиторії

Схеми використовуються для опису таблиць або колекцій у базі даних. При завантаженні бізнес-схеми ці схеми передаються ядрі обчислень. Відповідно до конфігураційних налаштувань, ядро відповідає за логіку оновлення та міграції структур бази даних.

Репозиторії, у свою чергу, служать для опису методів роботи з цією самою таблицею або колекцією у базі даних. Кожен репозиторій має вбудовані методи для створення запитів до бази даних. Виклик репозиторію здійснюється за допомогою агента бізнес-схеми у обробниках запитів.

repository-arch.svg

Брокери повідомлень

небезпека

Брокер повідомлень призначений для комунікації між предметними областями різних сервісів. Брокер повідомлень знаходиться в активній розробці та буде наданий в релізі v2.0.0.