UML Диаграмма для API модели - PullRequest
       53

UML Диаграмма для API модели

11 голосов
/ 13 ноября 2009

Мне нужно создать диаграмму для документирования API RESTFul, который строит, какую диаграмму UML мне следует использовать?

Заранее спасибо,

Ответы [ 3 ]

12 голосов
/ 22 ноября 2009

A диаграмма последовательности показывает динамику системы. Итак, если вы хотите показать поток вызовов, которые будут происходить, когда клиенты будут вызывать ваш API, то это ваш выбор.

Диаграмма классов показывает структуру системы. Итак, если вы хотите показать сигнатуры методов / функций вашего API и то, как они распределены по типам, то это то, что вы должны использовать.

Или вы можете использовать оба варианта для отображения различных представлений вашего API.

12 голосов
/ 13 ноября 2009

Диаграммы последовательности - хорошее начало. Но вам лучше прочитать о различных типах диаграмм , чтобы узнать, чего хочет ваш босс / проф и т. Д.

2 голосов
/ 13 ноября 2009

Это зависит от того, что вы хотите передать, но при отображении API диаграмма последовательности - это мой переход к диаграмме.

...