2009-11-13 69 views
10

我需要创建一个图来记录构建的RESTFul API,我应该使用哪个UML图?UML图到模型API

在此先感谢,

+0

@AboutDev是否有人可以使用序列图为我提供一个API示例或示例建模的链接,如Java API可能是? – Debashisenator

回答

11

Sequence diagrams是一个好的开始。但你最好阅读不同的types of diagrams来看看你的老板/教授等想要什么。

+0

我在考虑使用通信图,但序列图似乎也是可行的。 谢谢, – Hugo

2

这取决于你想传达什么,但是当显示一个API时sequence diagram是我去图。

+0

感谢您的评论=) – Hugo

11

A 序列图显示系统的动态。因此,如果您想要显示客户端调用API时发生的调用流程,那么这是您的选择。

A 类图显示系统的结构。所以,如果你想展示你的API的方法/函数签名以及它们是如何分布在不同类型的,那么这就是你应该使用的。

或者您可以同时使用它们来描述API的不同视图。

+0

感谢您的评论=) 我认为,两者的结合将成为赢家=) – Hugo

+0

不客气。根据我的经验,大多数面向功能的API可以更好地记录为类图,使用类作为“模块”或“组件”来安排组中的功能,并将API函数视为方法。这提供了一个比面向动态的图如序列图更好的API粒度。 – CesarGon