Rufen Sie Javadoc (JDK-Dokumentation) ab und laden Sie es in eine lokale Datei zum Offline-Lesen herunter
Lesezeit: 9 Minuten
Lukas Dowell
Beim Schreiben von Java-Code beziehe ich mich ausführlich auf das Javadoc – das heißt die Java®-Plattform, Standard Edition und Java Development Kit Version x API-Spezifikation. Ich weiß, wie ich es online von der Website lesen kann, aber ich möchte eine Kopie auf meinen Computer herunterladen, damit ich es offline lesen kann, wenn keine Internetverbindung verfügbar ist.
Wie kann ich die Dokumentation herunterladen? Gibt es eine Möglichkeit, das Javadoc (JDK-Dokumentation) von einer Online-Site in eine lokale Datei “herunterzuladen”?
Die von mir verwendeten Online-Dokumente neigen dazu, Clients wie Eclipse abzulehnen, was die Arbeit erschwert, also muss ich sie auf meinen Computer ziehen und sie an meine Bibliotheks-JAR anhängen.
Hinweis für diejenigen, die erwägen, dies als Suche nach Ressourcenempfehlungen zu schließen: Das ist es nicht. Zunächst wird überhaupt nicht nach einer Empfehlung gefragt; es fragt, wie man ein Problem löst. Es ist völlig vernünftig, dass Leute Tools empfehlen, die das in der Frage dargestellte Problem lösen. Wenn individuelle Antworten von geringer Qualität sind, sollte dies auf der Ebene dieser spezifischen Antwort behandelt werden, nicht durch Schließen der Frage. Darüber hinaus ist die Frage, wo die offizielle Dokumentation zu finden ist, keine Suche nach einer Empfehlung.
Jedes Mal, wenn ich die JDK 6-API-Dokumentation in Form einer ZIP-Datei mit den Javadocs herunterladen möchte, muss ich SO durchforsten, also füge ich diesen Kommentar hinzu, in der Hoffnung, dass er meine zukünftige Suche erleichtert. Danke!
– Conan
31. Juli 2013 um 8:07 Uhr
Wie haben Sie diese Seiten gefunden? Zum Beispiel die Dokumentations-Downloadseite für Java SE 8. Wenn Sie auf diese Registerkarte klicken Dokumentation Auf dieser Seite werden Sie möglicherweise auf eine andere Seite weitergeleitet, auf der Sie die Dokumente nicht herunterladen können. Ich kann diese Seite dort nicht finden, es sei denn, ich habe Ihren direkten Link.
– David Ferenczy Rogožan
9. August 2019 um 11:47 Uhr
OK, verstanden, aber es ist ein bisschen … unpraktisch. Gehen Sie zum Java SE-Seitewähle aus Downloads Registerkarte und unter der Zusätzliche Downloadses gibt Herunterladen Schaltflächen für die Dokumente. Wenn Sie auf die wechseln Dokumentation Tab, es gibt keine Möglichkeit, es dort herunterzuladen.
– David Ferenczy Rogožan
9. August 2019 um 11:56 Uhr
Oracle hat für JDK 6 und 7 entfernt. Diese Links funktionieren nicht
– Vipul Verma
2. Januar 2021 um 14:31 Uhr
Download-Links für Java SE 12, 13, 14 leiten jetzt zur Online-Version weiter.
– Blauelf
13. Januar 2021 um 13:57 Uhr
Paulo Ebermann
Stellen Sie zunächst sicher, dass sie nicht bereits einen Download in Zip-Form oder ähnlichem anbieten.
Stellen Sie dann sicher, dass Sie dies tatsächlich tun dürfen (dies kann davon abhängen, wo Sie leben, und von den Bedingungen, die auf der Website angegeben sind, von der Sie dies abrufen möchten).
Dann schauen Sie sich doch mal um Gew Werkzeug. Es ist Teil des GNU-Systems, also in vielen Linux-Distributionen enthalten, aber auch für Windows und Mac verfügbar, nehme ich an.
(ohne den Zeilenumbruch; es sollte durch die maskiert werden \ Backslash hier).
Schlagen Sie nach, was jede Option in der bewirkt Handbuch bevor Sie dies versuchen.
Wenn Sie dies wiederholt tun möchten, schauen Sie in die --mirror Möglichkeit. Zum Herunterladen anderer Websites, --convert-links könnte auch nützlich sein, aber ich fand, dass dies für Javadocs nicht erforderlich ist, die normalerweise die richtigen absoluten und relativen Links haben.
Dies lädt viele der gleichen Kopie der herunter index.html Datei mit Anhang ?... Namen (für die RAHMEN Links auf jeder Seite). Sie können diese Dateien nach dem Herunterladen entfernen, indem Sie die --reject 'index.html\?*' Option, aber sie werden immer noch zuerst heruntergeladen (und auf rekursive Links geprüft). Ich habe noch nicht herausgefunden, wie ich es vermeiden kann, sie überhaupt herunterzuladen. (Sehen diese verwandte Frage zu Server Fault.)
Vielleicht würde das Hinzufügen der richtigen Rekursionsebene hier helfen (ich habe es nicht versucht).
Nach dem Herunterladen möchten Sie möglicherweise das resultierende Verzeichnis komprimieren, um weniger Speicherplatz zu beanspruchen. Verwenden Sie dazu das Zip-Tool Ihrer Wahl.
Zum Ausschluss der index.html?... Duplikate können Sie jetzt verwenden –reject-regex ab wget 1.14: wget --reject-regex='index.html\?(.*)' ...
– Alexander Klimetschek
11. Februar 2014 um 1:31 Uhr
CrouZ
Für jedes Javadoc (nicht nur die zum Download bereitstehenden) können Sie das DownThemAll-Addon für Firefox mit einer geeigneten Umbenennungsmaske verwenden, zum Beispiel:
Es ist möglich, einige ältere Versionen des DownThemAll-Add-ons mit zu verwenden Blasser Mond Browser.
Links aktualisiert. Ich glaube nicht, dass es in Firefox mehr verwendet werden kann, da sie alle Addons veraltet haben, aber es sollte immer noch mit Firefox-Forks funktionieren, zum Beispiel Pale Moon.
Die folgende Technik funktioniert jetzt nicht mit Java 11 und wahrscheinlich höheren Versionen: Es gibt keine Möglichkeit, mehrere “kaputte Links” (dh zu anderen Klassen, anderen APIs) zu ignorieren. Lösung: Behalten Sie Ihre ausführbare javadoc-Datei (oder javadoc.exe) von Java Version 8
Es gibt gute Gründe, eigene lokale Javadocs zu erstellen, und es ist nicht besonders schwierig!
Zuerst brauchen Sie die Quelle. Zum Zeitpunkt des Schreibens wird das Java 8 JDK mit einer ZIP-Datei namens src.zip. Manchmal enthält Oracle aus unerklärlichen Gründen nicht immer die Quelle. Für einige ältere Versionen (und wer weiß in der Zukunft) müssen Sie also auf andere Weise an die Java-Quellen herankommen. Es sollte auch beachtet werden, dass Oracle in der Vergangenheit manchmal den Quellcode in die Linux-Version des JDK aufgenommen hat, aber nicht in die Windows-Version.
Ich habe diese Datei gerade entpackt … die obersten Verzeichnisse sind “com”, “java”, “javax”, “launcher” und “org”. Verzeichnis launcher enthält keine zu dokumentierenden Dateien.
Sie können die Javadocs sehr einfach aus einigen oder allen generieren, indem Sie an der Eingabeaufforderung/dem Terminal per CD in das Verzeichnis wechseln ...\src. Dann geh
So einfach ist das. Das Generieren Ihrer eigenen Javadocs hat auch zwei große Vorteile
Sie wissen, dass es genau die richtigen Javadocs für das JDK (oder jede externe JAR-Datei) sind, die Sie auf Ihrem System verwenden
Sobald Sie sich daran gewöhnt haben, ist die Wiederherstellung Ihrer Javadocs keine lästige Herausforderung (dh wo Sie nach ihnen suchen müssen). Zum Beispiel habe ich gerade ein paar Quell-Jars entpackt, deren Pakete eng miteinander verbunden sind, sodass ihre Quellen tatsächlich “zusammengeführt” wurden und dann daraus ein einziges Javadoc gemacht haben …
NB Swing ist halboffiziell DEAD. Wir sollten alle zu JavaFX wechseln, das hilfreicherweise mit Java 8 JDK gebündelt ist, aber in einer eigenen Quelldatei, javafx-src.zip.
Entpackt zeigt dies 3 “Root”-Pakete: com, javafx Und netscape (was?). Diese sollten manuell über die an die entsprechenden Stellen unter den entpackten verschoben werden src Verzeichnis (einschließlich der JavaFX com.sun Pakete unter Java com.sun Struktur). Das Kompilieren all dieser Javadoc-Dateien hat auf meinem Rechner eine nicht zu vernachlässigende Zeit in Anspruch genommen. Ich würde erwarten, bald alle JavaFX-Quellklassen zusammen mit allen anderen Quellklassen zu sehen.
Übrigens gilt das gleiche Denken für die Dokumentation aller Java-Jars (mit Quellcode), die Sie verwenden. Alle Versionen der meisten JAR-Dateien sind jedoch mit ihrer Dokumentation zum Download bei Maven Central verfügbar http://search.maven.org…
PS Nachtrag: Verwendung von Eclipse und dem „Gradle STS“-Plug-in: Der Assistent „Neues Gradle STS-Projekt“ erstellt eine gradle.build Datei, die die Zeile enthält
include plugin: 'eclipse'
Dadurch wird das Quell-Jar mit dem ausführbaren JAR (unter GRADLE_HOME) wenn Sie gehen
./gradlew build
[addendum 2020-01-13: if you have chosen not to include the Eclipse plugin in your build.gradle, it would appear that you can go (with the selection on your project in the Project Explorer) Right-click Gradle –> Refresh Gradle Project to get Eclipse to download the source files.]
… gibt Ihnen ein zusätzliches Maß an Sicherheit, dass Sie richtig liegen src und damit das Recht javadoc für die betreffende Abhängigkeit.
Hinweis für diejenigen, die erwägen, dies als Suche nach Ressourcenempfehlungen zu schließen: Das ist es nicht. Zunächst wird überhaupt nicht nach einer Empfehlung gefragt; es fragt, wie man ein Problem löst. Es ist völlig vernünftig, dass Leute Tools empfehlen, die das in der Frage dargestellte Problem lösen. Wenn individuelle Antworten von geringer Qualität sind, sollte dies auf der Ebene dieser spezifischen Antwort behandelt werden, nicht durch Schließen der Frage. Darüber hinaus ist die Frage, wo die offizielle Dokumentation zu finden ist, keine Suche nach einer Empfehlung.
– Cody Grey
♦
28. Januar um 16:44 Uhr