Как приручить дракона — реализация TMF Open API (Сергей Гусев, HelloConf MTS-2020)

Короткая ссылка: 202002072

Докладчик: Сергей Гусев

Для систем с большим количеством разнородных сущностей очень важен набор абстракций для выстраивания общих процессов. Один из наборов — TMForum SID и базирующийся на нём стандарт Open API. Реализация этого стандарта — не самый простой процесс, в докладе я рассказываю об основных подводных камнях и способах борьбы с ними.

Для сложной системы очень важна модель данных — хорошая модель данных содержит необходимый набор абстракций, который помогает выстраивать процессы, работающие одинаково с различными сущностями.

TM Forum SID и TM Forum Open API – готовое решение. Организация TM Forum предоставляет готовый стандарт на основе универсальной модели данных и открытых протоколах и форматах – RESTful JSON over HTTP.

Универсальная модель данных не предполагает ручной труд. Количество сущностей в модели данных предполагает использование средств автоматизации разработки вместо ручного кодирования обработчиков систем хранения данных. Документарные БД предпочтительней SQL баз данных для объектов с высоким уровнем вложенности.

PATCH – довольно неоднозначная операция. Для RESTful JSON over HTTP существует несколько стандартов обработки таких операций, которые не являются идеальными, но JSON MERGE более функционален.

Использование стандарта в чистом виде не подходит для frontend решений. Получается слишком сложная для GUI модель API, много логики приходится реализовать на клиентской стороне. Целесообразно использовать промежуточный слой, который бы скрывал от GUI систем большинство внутренней логики, накладываемой стандартом.

Личный R&D очень полезен для практикующего архитектора. Даже когда стандарты не безупречны, знание архитектурных принципов и методик помогает решать сложные проблемы.