我应该如何可视化我的代码结构？

Question

我有一个用Java编写的应用程序。 In存储在多个文件中。它使用不同的类和不同的方法。代码又大又复杂。如果我有代码的图形模型（某种有向图），我认为理解代码会更容易。是否有一些标准的代码可视化方法。我正在考虑使用UML（不确定它是一个正确的选择）。谁能推荐我一些东西？

增加：

我考虑两种可能性：

1. 手动创建图表（明确地）。
2. 以自动方式创建图表。例如，使用一些工具来读取可用代码并生成描述代码结构的图形。

已添加2：

免费获得一些东西会很不错。

Answer 1

我尝试使用大量的UML工具，发现大多数UML工具的逆向工程功能对于理解代码没有帮助。他们专注于设计需求和逆向工程功能，通常最终会显示大量无用信息的大量图片。当我在使用Microsoft Office代码库时，我发现使用笔和纸比典型的设计/建模工具更有帮助。

您通常希望以多种方式考虑这样做：

1. 使用你的大脑：其他人提到它 - 实际上试图理解代码库是没有替代品的。您可能需要记下笔记并稍后再参考。工具有帮助吗？当然。但是不要指望他们为你完成大部分工作。
2. 查找文档并与同事交谈：没有比在源代码库中描述主要概念更好的方法了。如果你能找到帮助你的人，请拿笔和纸，去找他并记下很多笔记。对另一个人造成多大的伤害？在一开始 - 尽可能多的是你的工作，但没有数量太少。
3. 考虑工具：如果您不熟悉项目的一部分 - 您将花费大量时间来理解代码，因此请查看您可以自动获得多少帮助。有很好的工具和糟糕的工具。尝试找出哪些工具具有可能对您有所帮助的功能。正如我上面提到的，普通的UML工具更侧重于建模，似乎不适合你。
4. 时间与成本：当然，免费是很棒的。但是，如果许多人没有使用免费工具 - 可能是该工具不起作用。有许多工具只是作为对可以做的事情的探索而创建，但并不是真正有用，因此只是免费提供，希望其他人可以采用它。考虑它的另一种方式，决定你的时间值多少 - 花一两天时间让一个工具为你工作可能是有意义的。

在那里，在尝试理解项目时请记住这些：

1. 英里高视图：分层体系结构图非常有助于了解项目中的主要概念如何相互关联。 Lattix 和 Architexa 等工具在这里非常有用。
2. 核心：尝试弄清楚代码如何与主要概念相关联。类图在这里特别有用。笔在纸上的工作经常就足够了，但工具不仅可以加快流程，还可以帮助您保存和共享这些图表。我认为 AgileJ 和 Architexa 是您最好的选择，但您的平均UML工具通常都足够好。
3. 关键用例：我建议您为应用程序追踪至少一个关键用例。您可能会从团队中的任何人那里获得最重要的用例，并且逐步完成它将非常有用。大多数IDE在这里真的很有帮助。如果您尝试绘制它们，那么序列图是最合适的。对于这里的工具，我认为 MaintainJ ， JDeveloper 和 Architexa 是您最好的选择。< / LI>

   注意：我是Architexa的创始人 - 我们构建工具来帮助您 understand and document Java code ，但我试图在上面做出公正。我的目的是建议工具和选项，因为这是我作为博士学位的一部分所关注的。

Answer 2

你应该使用的最重要的工具是你的大脑，它是免费的。

没有理由要使用任何标准的可视化方法，您可以使用任何您喜欢的媒体。纸，白板，photoshop，visio，powerpoint，记事本：所有这些都可以有效。绘制类，对象，方法，属性，变量的图表 - 无论您认为有什么看法，以了解应用程序。观众不仅是您团队的其他成员，也是您自己。创建有助于您查看和快速理解的图表。将它们发布在您的工作区周围并定期查看它们，以便在构建时提醒您自己的整体系统架构。

UML和其他代码文档标准是您可以执行的图表类型以及您应该考虑的信息的良好指南。然而，对于大多数应用来说，它是过度的，并且基本上存在于没有标准的情况下不能承担个人责任的人。如果您遵循UML，那么您最终会花费太多时间在文档上，而不是创建应用程序。

Answer 3

  

    

它存储在多个文件中。它使用不同的类和不同的方法。代码又大又复杂。

  

在学校外面编写的所有Java代码都是这样的，特别是对于从项目开始的新开发人员。

这是一个老问题，但是随着谷歌搜索的出现，我在这里添加了我的回复，以便它对未来的访问者有用。我还要透露我是MaintainJ的作者。

不要试图了解整个应用程序

让我问你这个问题 - 你为什么要理解代码？很可能您正在修复错误或增强应用程序的功能。您不应该尝试做的第一件事是了解整个应用程序。尝试在项目重新开始时理解整个架构只会让你感到压力。

当我这样说时，请相信我 - 具有10年以上固体编码经验的开发人员可能无法理解应用程序的某些部分即使在同一个项目上工作超过一年（假设他们不是原始开发人员）也是如此。他们可能无法理解身份验证的工作原理或事务管理在应用程序中的工作方式。我说的是具有1000到2000个类并使用不同框架的典型企业应用程序。

维护大型应用程序所需的两项重要技能

然后他们如何生存并获得巨额支出？经验丰富的开发人员通常了解他们在做什么;意思是，如果他们要修复一个bug，他们会找到bug的位置，然后修复它并确保它不会破坏应用程序的其余部分。如果他们需要增强功能或添加新功能，大多数情况下，他们只需模仿现有功能，执行类似的操作。

有两项重要技能可以帮助他们做到这一点。

1. 他们能够在修复错误时分析他们所做的更改的影响。首先，他们找到问题，更改代码并对其进行测试以确保其有效。然后，因为他们很了解Java语言并且框架足够好，他们可以判断它是否会破坏应用程序的任何其他部分。如果没有，他们就完成了。

2. 我说他们只需要模仿来增强应用程序。为了有效地模仿，人们需要很好地了解Java并且足够了解框架＆＃39;。例如，当他们添加新的Struts Action类并添加到配置xml时，他们将首先找到类似的功能，尝试遵循该功能的流程并了解其工作原理。他们可能不得不调整一些配置（例如＆＃39;表格＆＃39;数据在＆＃39;请求＆＃39;而不是＆＃39;会话＆＃39;范围）。但是，如果他们足够了解框架，他们就可以很容易地做到这一点。

最重要的是，您不需要了解所有2000个类正在做什么来修复错误或增强应用程序。只需了解所需的内容。

专注于提供即时价值

所以我劝你不要理解架构吗？一点都不。我所要求的只是提供。一旦你开始一个项目，一旦你在PC上设置了开发环境，你就不应该花费超过一周的时间来交付一些东西，无论它多么小。如果您是一位经验丰富的程序员并且在2周后没有提供任何服务，那么经理如何知道您是否真的在工作或阅读体育新闻？

因此，为了让每个人的生活更轻松，提供的东西。不要采取你需要了解整个应用程序以提供有价值的东西的态度。这完全是假的。添加一个小的本地化Javascript验证可能对业务非常有价值，当您交付它时，经理对他的钱有一些价值感到宽慰。此外，它为您提供了阅读体育新闻的时间。

随着时间的推移，在您提供5个小修补程序之后，您将开始慢慢了解该体系结构。不要低估了解应用程序各个方面所需的时间。提供3-4天了解身份验证。可能需要2-3天才能了解交易管理。这实际上取决于应用程序和您之前在类似应用程序上的经验，但我只是给出了大概的估计。窃取修复缺陷之间的时间。不要求那个时间。

当你理解某些东西时，写下笔记或绘制类/序列/数据模型图。

图表

Haaa ......我花了很长时间才提到图表:)。我开始披露我是MaintainJ的作者，这是生成运行时序列图的工具。让我告诉你它是如何帮助你的。

维护的重要部分是找到问题的根源或了解功能的工作原理。

MaintainJ生成的序列图显示了单个用例的调用流和数据流。因此，在一个简单的序列图中，您可以看到为用例调用了哪些方法。因此，如果您正在修复错误，那么错误很可能就是其中一种方法。只需修复它，确保它不会破坏任何其他东西并退出。

如果需要增强功能，请使用序列图了解该功能的呼叫流程，然后对其进行增强。增强可能类似于添加额外字段或添加新验证等。通常，添加新代码的风险较小。

如果您需要添加新功能，找到一些类似于您需要开发的功能，请使用MaintainJ了解该功能的呼叫流程，然后模仿它。

听起来很简单？它实际上很简单，但是在某些情况下，您将进行更大的增强，例如构建一个全新的功能或影响应用程序基本设计的东西。当你尝试这样的东西时，你应该熟悉应用程序并合理地理解应用程序的体系结构。

上述论点的两个警告

1. 我提到添加代码的风险比改变现有代码要小。因为您想避免更改，所以您可能只想复制现有方法并添加到它而不是更改现有代码。抵制这种诱惑。所有应用都具有一定的结构或“均匀性”。不要因代码重复等不良做法而毁掉它。你应该知道什么时候你偏离了统一性＆＃39;。请项目高级开发人员查看更改。如果你必须做一些不符合约定的事情，至少要确保它是一个小类的本地（200行的私有方法不会破坏应用程序的美学）。

2. 如果您遵循上述方法，虽然您可以在行业中存活多年，但您可能会面临不了解应用程序体系结构的风险，从长远来看这并不好。这可以通过更大的变化或更少的Facebook时间来避免。花时间了解架构，当你有点免费并将其记录给其他开发人员。

<强>结论

专注于即时价值，并使用提供这些功能的工具，但不要懒惰。工具和图表有所帮助，但你也可以不用它们。您可以通过花一些时间在项目上的高级开发人员来遵循我的建议。

Answer 4

我知道Eclipse的一些插件：

<强> Architexa

http://www.architexa.com/

<强> nWire

http://www.nwiresoftware.com/

如果您想对代码进行反向工程，请尝试 Enterprise Architect

Answer 5

你试过Google CodePro Analytix吗？

它可以显示相关性并且是免费的（来自cod.google.com的屏幕截图）：

Answer 6

这是一个非UML工具，它具有非常好的可视化功能。

您可以将每个类/方法的代码行映射到矩形的颜色/边长。 您还可以显示类之间的依赖关系。

http://www.moosetechnology.org/

好消息是，您可以使用Smalltalk脚本来显示您需要的内容： http://www.moosetechnology.org/docs/faq/JavaModelManipulation

在这里您可以看到这样的可视化效果如何： http://www.moosetechnology.org/tools/moosejee/casestudy

Answer 7

JUDE Community UML曾经能够导入Java，但现在不再是这种情况了。这是一个很好的免费工具。

如果您的应用程序非常复杂，我认为图表不会带您走得太远。当图表变得非常复杂时，它们变得难以阅读并失去其力量。一些精心挑选的图表，即使是手工生成，也可能就足够了。

您不需要拼写出每个方法，参数和返回值。通常，它只是您需要的对象或包之间的关系和交互。

Answer 8

这是另一个可以解决问题的工具： http://xplrarc.massey.ac.nz/

Answer 9

您可以使用JArchitect工具，一个非常完整的工具，使用dependency graph可视化您的代码结构，并使用CQlinq浏览源代码，如数据库。 JArchitect对open source contributors

是免费的

Answer 10

我使用的一些很棒的工具 -

StarUML（允许代码转换图表）

MS Visio

XMind（对系统概述非常有用）

笔和纸！