Jeder Java Entwickler kennt und nutzt die JavaDoc Klassen- oder Bibliotheksdokumenation. Jeder kennt auch das Problem wenn man die JavaDoc Dokumentation einer bestimmten Klasse benötigt und mann sich diese Klasse erst noch in der Klassenübersicht herauspicken muss. Oft dauert das laden der Übersicht, natürlich nur in der online Version, schon lange genug. Eine Lösung und ein schöneres Navigieren in der JavaDoc von den gängigsten Bibliotheken ermöglich das Tool Javaref.

Einen, meiner Meinung nach, wirklichen Vorteil von JavaRef besteht darin, dass man die gewünschte Klasse, zu der man das JavaDoc benötigt, direkt suchen kann. Unterstützt wird man dabei durch ein AutoComplete mit dem alle gefundenen Klassen angezeigt werden, die mit dem eingegebenen Namen anfangen. Es gibt ja einige Stimmen die das AutoComplete bei Eingaben als unbrauchbares Feature von Ajax sehen und viele das nur einbauen um “auch dabei zu sein” – an dieser Stelle ist es ein sehr nützliches Feature.

Aktuell sind bei Javaref 85 Biblitheken gelistet. Um die Bibliotheken zu durchsuchen kann man auf der Bibliotheksübersichtsseite, wie auch schon bei der Eingabe von Klassen, den Namen der gesuchten Bibliothek eingeben und erhält direkt alle Treffer in der Ergebnisliste darunter.
Wenn die gewünschte Bibliothek noch nicht gelistet ist kann sie als Wunsch als “API upload request” hier eintragen werden.

Um den vollen Zugang zu allen Bibliotheken zu haben muss man sich allerdings registrieren. Als registrierter User hat man aber auch die Vorteile, dass man bestimmte Bibliotheken selektieren kann um nur in diesen zu suchen oder aber auch Notizen hinterlegen kann. Da viele Bibliotheken hinterlegt sind sind auch Querverweise zwischen Bibliotheken vorhanden und können direkt selektiert und angesprungen werden.
Schade ist, dass durch die Copyrights auf Sun JDK und J2EE Sun nicht erlaubt das JavaDoc woanders zu hosten. Daher sind dieses JavaDocs bei Javaref nicht zu finden. Eine Erklärung dazu ist auch auf dem Javaref blog zu finden.
Auch nachteilig ist, dass Google Ads überall prangern was die Übersicht doch ein wenig behindert. Aber der riesen Vorteil um direkt zu dem JavaDoc einer bestimmten Klasse zu gelangen überwiegt aktuell doch sehr.

Insgesamt ist Javaref eine sehr brauchbare und nützliche Anwendung. Zudem zeigt sie so ziemlich alle nützlichen Finessen die man mit Ajax erreichen kann. Das Tool bekommt zumindestens bei mir bei meinen Entwicklungen eine Chance. Sofern mir seltsame oder besonders tolle Features auffallen werde ich noch einmal darüber berichten.

(via Ajaxian)