UML/API: как смоделировать RESTful API

Мне нужно создать диаграмму классов UML и диаграмму вариантов использования для RESTFul API, который я разработал с использованием платформы API и Symfony 3.2 (бэкенд) и Ionic 2 (интерфейс). Но я точно не знаю, как описать структуру моего внутреннего API через диаграмму классов.

Если у кого-то есть идеи или может помочь, я был бы очень признателен. Благодарю вас!


person Fatimaezzahra Rarhibou    schedule 15.05.2017    source источник
comment
Ваш вопрос слишком прост (или слишком широк, в зависимости от того, как вы на него смотрите). Такого рода вопросы призывают прочитать книгу или посетить класс.   -  person qwerty_so    schedule 16.05.2017
comment
@ThomasKilian Спасибо за ответ. Мой вопрос: я хочу знать, как представить компоненты моего API на диаграмме классов. Диаграммы последовательности легче разрабатывать, поскольку вы можете описать взаимодействие между API и системой. Но я не знаю, как обойти диаграмму классов, как представить структуру моего API. Большое спасибо за вашу помощь   -  person Fatimaezzahra Rarhibou    schedule 16.05.2017
comment
Что вы пробовали до сих пор? Создать диаграмму классов гораздо проще, чем построить SD.   -  person qwerty_so    schedule 16.05.2017
comment
@ThomasKilian Я пытался создать несколько классов, но для меня это не имело никакого смысла. Я также думал, что диаграммы классов были проще, но я не мог обойти их, так как тема отличается от обычной. В настоящее время я пробую этот github.com/nrekretep/pikturr, который выглядит как отличный инструмент, который преобразует структуру моего спокойного API (через Swagger) в диаграмму классов. Если вы думаете о каких-либо предложениях, которые помогут, я был бы признателен. Спасибо   -  person Fatimaezzahra Rarhibou    schedule 16.05.2017
comment
Я думаю, что просто позволить машине что-то нарисовать — это не совсем документация. Вам необходимо понять концепцию классов перед созданием любого SD. Нужно поставить лошадь впереди повозки.   -  person qwerty_so    schedule 16.05.2017
comment
Еще раз спасибо за вашу помощь. Я не думаю, что вы совсем поняли мой вопрос (или я не совсем четко его задал), но я нашел решение. Спасибо.   -  person Fatimaezzahra Rarhibou    schedule 16.05.2017
comment
В StackOverflow принято помещать решение в ответ (чтобы быть полезным и для других пользователей) :-).   -  person gp_sflover    schedule 16.05.2017
comment
Верно. Если вы сами ответите на свой вопрос, мы все сможем научиться.   -  person qwerty_so    schedule 16.05.2017
comment
@gp_sflover Я только что сделал, я немного новичок в этом, хех. Благодарю вас ! :)   -  person Fatimaezzahra Rarhibou    schedule 17.05.2017
comment
Отличная работа! ;-) К ​​следующему!   -  person gp_sflover    schedule 19.05.2017


Ответы (4)


Итак, решение моей проблемы заключалось в следующем:

https://www.ibm.com/developerworks/rational/library/design-implement-restful-web-services/ : из этого я сделал вывод, что, хотя трудно смоделировать restful API на диаграмме классов (поскольку это в основном просто множество методов), рассмотрите такие классы, как «Ресурсы», добавьте методы (в основном методы HTTP) и пути к каждому ресурсу.

Это тоже очень помогло:

Другой (более простой) способ заключался в использовании таких инструментов, как Pikturr, которые преобразуют ваш Swagger в диаграмму UML.

Программное обеспечение для разработки REST API:

  • Визуальная парадигма
  • Архитектор программного обеспечения IBM Rational

Надеюсь, это поможет.

person Fatimaezzahra Rarhibou    schedule 17.05.2017

Платформа API автоматически создает документацию Swagger для вашего API по URL-адресу http://localhost/docs.json.

Вы можете создать диаграмму UML из документации Swagger, используя такие инструменты, как https://github.com/nrekretep/pikturr

person Kévin Dunglas    schedule 15.05.2017
comment
Большое спасибо за ваш ответ @Kévin Dunglas, я попробую это, выглядит просто и эффективно. Спасатель жизни! - person Fatimaezzahra Rarhibou; 16.05.2017

Слишком поздно, но это другой подход.

Если вы не знакомы с Visual Paradigm, вы можете попробовать.

Вы можете использовать этот контент, Visual Paradigm - How to Design REST API с UML?. Легко представить свой REST API. Я предпочитаю Коллекции Postman Кстати (это не UML).

Но если вы делаете какие-то другие артефакты UML для целей документации. Что ж, Visual Paradigm предоставляет вам кучу диаграмм UML для этого. Таким образом, вы сохраняете эту экосистему диаграмм.

До встречи.

person Franco Gil    schedule 15.06.2020

Настоящим ответом на этот вопрос является использование диаграммы компонентов UML, поскольку сама ее цель заключается в моделировании архитектур на основе служб. Перейдите по этой ссылке для получения дополнительной информации: https://diagramasuml.com/componentes/

person Ramiro G.M.    schedule 29.11.2020