java - 寻找具有 Javadoc 注释的 Java 代码的好示例

Question

我一直在一些代码上运行 Checkstyle，并寻找一个很好的示例来掌握如何为特定目的添加注释。

例如，Checkstyle 说我应该为常量/类变量添加注释。然而，在 Oracle 主机的官方文档中，我找不到这样的示例。

我在各个地方寻找，但找不到简洁的例子...... 1 2 3 4 5

我想如果我能得到 Java Calendar 类的源代码，这将是一个很好的例子。您可以在该类的 API 文档中看到各种常量。

参见here .

我怎样才能:

1) 获取日历的源代码？

2)找到一个示例，说明如何在 Javadoc 中记录这样的代码(Checkstyle 标记它需要它):

私有(private)静态最终 int NO_OF_RECORDS = 10;

Answer 1

关于Java 6 download page ，在“其他资源”部分下，您可以下载整个JDK的源代码。

此外，大多数 IDE 会自动索引 Java 库类的源代码，以便您可以透明地打开这些类。