Java-API-Schnittstelle
Seit ich anfing, mit Scala herumzuspielen, hatte ich eine große Frage bezüglich der Java-API: Warum behält Oracle die die gleiche alte HTML Seite mit" frameset "Tags und überhaupt keine Suchfunktion? Es sieht so aus, als ob sie es nicht ins Web 2.0 geschafft haben ...
Die Scala-API-Dokumentation andererseits ist zwar nicht die beste Website in die Web-Geschichte, ist mehrere Größenordnungen mehr verwendbar.
Wenn jemand weiß, warum das so ist und, noch wichtiger, wenn es eine Java-API-Dokumentation mit einer besseren Schnittstelle gibt, lassen Sie es mich bitte wissen!
4 Antworten
Kürzlich wurde JavaDoc für Java 7 verbessert, sodass es benutzerdefiniertes CSS verwenden konnte. Hier sind die ersten Ergebnisse: Ссылка . Die Arbeit geht weiter und ich denke, wir werden mehr sehen, wenn neue Updates herauskommen. Ich stimme zu, dass ScalaDoc überlegen ist, aber sie mussten sich nicht mit 15 Jahren Vermächtnis auseinandersetzen.
Javadocs liefert die Ausgabe in diesem Format und seine Veröffentlichung unter dieser Adresse. Ich denke, niemand hat wirklich die Notwendigkeit für Verbesserungen gesehen, aber jetzt, wo Sie es erwähnen, macht es ein interessantes Nebenprojekt. Ich googelte herum und fand heraus, ob es eine "bessere" Schnittstelle gab, aber kein Glück.
Sie könnten javadoc -h ausführen, um zu sehen, welche zusätzlichen Optionen verfügbar sind, wenn Sie die Javadocs neu generieren möchten. Einige interessante sind benutzerdefinierte Header / Footer und Verknüpfung mit der Quelle, aber nichts mit dem Effekt, den Sie fragen.
Diese HTML-Seiten wurden mit den Javadoc -Tools erstellt, a Standardmethode zum Erstellen von Dokumentation in Java.
Ich weiß nicht, ob es andere Webseiten mit einer besseren Formatierung der API gibt, aber wenn es Ihnen bei irgendetwas hilft und Sie eine IDE und das SDK verwenden, können Sie den Quellcode für die meisten Dateien sehen dort.
JavaDoc wurde entwickelt, um der kleinste gemeinsame Nenner zu sein. Praktisch jeder Webbrowser kann ihn auch ohne JavaScript-Unterstützung anzeigen.
Wenn Sie nach schnelleren Zugriffs- und Suchfunktionen suchen, können Sie auf JavaDoc innerhalb einer IDE wie Eclipse zugreifen.