寻找具有 Javadoc 注释的 Java 代码的好例子

Question

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

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

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

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

见here。

我该怎么做：

1) 获取日历的源代码？

2) 找到一个示例，说明如何在 Javadoc 中记录这样的代码（Checkstyle flags it needs it）：

private static final int NO_OF_RECORDS = 10;

Answer 1

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

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

Answer 2

Oracle 当前的 java 6 源下载链接到 http://download.java.net/jdk6/source/，其中应该包含整个 java 库源。