Группировка пространств имен

Мне было интересно, можно ли сгруппировать сами пространства имен?

Наш проект сервера REST имеет сильно децентрализованную структуру (по принципу фрактального шаблона Redux), и каждая функция имеет собственное пространство имен. Это, как и ожидалось, привело к появлению множества пространств имен, и страница чванства сейчас становится довольно полной.

Если это недостижимо, я думаю, мы можем смириться с этим или рассмотреть возможность создания только json-файла swagger, который будет использоваться официальным пользовательским интерфейсом Swagger, который мы можем запустить на отдельном сервере. Но я бы предпочел решение restplus-y, поскольку оно представляет собой наименьшее трение кода.

Что вы имеете в виду под группировкой пространств имен? Разве недостаточно группировки методов для каждого ресурса? Возможно, вы поделитесь своим пониманием размера вашего API (# ресурсы, # методы и т. д.), А также объясните, почему это проблема.

dmulter 26.09.2018 18:16

@dmulter, у меня пока 45 пространств имен, каждое из которых ориентировано на функции и имеет свои собственные наборы операций получения, помещения, удаления и публикации. Надеюсь, это поможет мне понять мою дилемму.

Ojingo 26.09.2018 18:49
Стоит ли изучать PHP в 2023-2024 годах?
Стоит ли изучать PHP в 2023-2024 годах?
Привет всем, сегодня я хочу высказать свои соображения по поводу вопроса, который я уже много раз получал в своем сообществе: "Стоит ли изучать PHP в...
Поведение ключевого слова "this" в стрелочной функции в сравнении с нормальной функцией
Поведение ключевого слова "this" в стрелочной функции в сравнении с нормальной функцией
В JavaScript одним из самых запутанных понятий является поведение ключевого слова "this" в стрелочной и обычной функциях.
Приемы CSS-макетирования - floats и Flexbox
Приемы CSS-макетирования - floats и Flexbox
Здравствуйте, друзья-студенты! Готовы совершенствовать свои навыки веб-дизайна? Сегодня в нашем путешествии мы рассмотрим приемы CSS-верстки - в...
Тестирование функциональных ngrx-эффектов в Angular 16 с помощью Jest
В системе управления состояниями ngrx, совместимой с Angular 16, появились функциональные эффекты. Это здорово и делает код определенно легче для...
Концепция локализации и ее применение в приложениях React ⚡️
Концепция локализации и ее применение в приложениях React ⚡️
Локализация - это процесс адаптации приложения к различным языкам и культурным требованиям. Это позволяет пользователям получить опыт, соответствующий...
Пользовательский скаляр GraphQL
Пользовательский скаляр GraphQL
Листовые узлы системы типов GraphQL называются скалярами. Достигнув скалярного типа, невозможно спуститься дальше по иерархии типов. Скалярный тип...
0
2
475
1

Ответы 1

Базовый Спецификация OpenAPI имеет концепцию тегов. Функция пространства имен в Flask-RESTPlus назначает эти имена как теги для определений путей, поэтому именно так вы получаете группировку в пользовательском интерфейсе Swagger. Спецификация не предлагает никакого механизма иерархической группировки, поэтому Flask-RESTPlus не предлагает такой функции.

Вы могли бы рассмотреть другую стратегию для назначения пространств имен / тегов для создания более управляемых группировок, разделения API на несколько страниц / сайтов пользовательского интерфейса Swagger и т. д. Похоже, что в вашем пользовательском интерфейсе Swagger нет необходимости отображать очень большое количество методов API. , поэтому сделать его более понятным с помощью общей структурирования контента может быть вашим лучшим подходом.

Другие вопросы по теме