Недавно я наблюдал много людей, все еще дающих ссылки на javadocs 1.4.2. Это - не совсем хорошая практика, и я хотел бы поднять вопрос.
Это происходит, потому что поисковые системы (Google, по крайней мере) дают старый javadoc, если Вы ищете, скажем, java.lang.String
Так, как получить javadoc для корректного (в настоящее время 1.6) версия JDK?
Почти во всех случаях добавление версии после искомого класса позволяет получить желаемый результат сверху. Например:
(обратите внимание - это не "1.6" - только "6")
По мере обновления учебные пособия уже ссылаются на черновую версию Java 7 API. Например, Как использовать таблицы относится к JTable
.
Я предпочитаю загружать и устанавливать javadoc, когда устанавливаю новую версию Java.
Так у меня всегда есть правильный javadoc на диске. Занимает немного места на диске, но это быстрее и позволяет работать в автономном режиме.
Недостаток: вы не можете копировать и вставлять ссылки в форум
Меня всегда удивляло, что никто в Google не обновляет поиск документации, чтобы она по умолчанию соответствовала последним версиям.
Обычно я просто добавляю "Java 6", если ищу "Java 6", и "Galileo", если ищу материалы по Eclipse (поскольку при поиске по умолчанию я обычно получаю документацию Eclipse 3.2). Добавление JavaDoc на всякий случай помогает в работе с более непонятными классами в целом.