Cuando escribo código Java, me refiero ampliamente al Javadoc, es decir, al Plataforma Java®, edición estándar y versión del kit de desarrollo de Java x especificación de API. Sé cómo leerlo en línea desde el sitio web, pero me gustaría descargar una copia a mi computadora para poder leerlo sin conexión cuando no haya conexión a Internet disponible.

¿Cómo puedo descargar la documentación? ¿Hay alguna manera de “descargar” el Javadoc (documentación JDK) desde un sitio en línea a un archivo local?

Los documentos en línea que estoy usando tienden a rechazar clientes como Eclipse, lo que dificulta el trabajo, por lo que debo colocarlos en mi máquina y adjuntarlos a mi biblioteca JAR.

Enlaces a la documentación de JDK

También de interés:

• Notas de lanzamiento
• Historial de las versiones de Java SE

1. Primero, asegúrese de que no ofrezcan una descarga en formato zip o similar.

2. Luego, asegúrese de que realmente tiene permiso para hacerlo (esto puede depender de dónde viva y de las condiciones mencionadas en el sitio web desde donde desea obtenerlo).

3. Luego, eche un vistazo a la Obtener herramienta. Es parte del sistema GNU, por lo que está incluido en muchas distribuciones de Linux, pero supongo que también está disponible para Windows y Mac.

Algo como esto funciona para mí:

wget --no-parent --recursive --level inf --page-requisites --wait=1 \
   https://epaul.github.io/jsch-documentation/simple.javadoc/

(sin el salto de línea; debe ser escapado por el \ barra invertida aquí).

Busque lo que hace cada opción en el manual antes de probar esto.

Si desea hacer esto repetidamente, busque en el --mirror opción. Para descargar otros sitios web, --convert-links también podría ser útil, pero descubrí que no es necesario para Javadocs, que generalmente tienen los enlaces absolutos y relativos correctos.

Esto descarga muchas de las mismas copias del index.html archivo con adjunto ?... nombres (para el MARCOS enlaces en cada página). Puede eliminar estos archivos después de la descarga agregando el --reject 'index.html\?*' opción, pero aún se descargarán primero (y se verificarán los enlaces recursivos). Todavía no descubrí cómo evitar descargarlos en absoluto. (Ver esta pregunta relacionada con Server Fault.)

Tal vez agregar el nivel de recursión correcto ayudaría aquí (no lo intenté).

Después de la descarga, es posible que desee comprimir el directorio resultante para ocupar menos espacio en disco. Use la herramienta zip de su elección para esto.

Para cualquier Javadoc (no solo los que están disponibles para descargar) puede usar el complemento DownThemAll para Firefox con una máscara de cambio de nombre adecuada, por ejemplo:

*subdirs*/*name*.*ext*

https://www.downthemall.org/main/install-it/downthemall-3-0-7/

Es posible usar algunas versiones anteriores del complemento DownThemAll con Luna pálida navegador.

Puedes usar algo llamado Dash: documentación de la API sin conexión para Mac. Para Windows y Linux tienes una alternativa llamada Celo.

Ambos son muy similares. Y puede obtener documentación sin conexión para la mayoría de las API, como Java, Android, Angular, HTML5, etc. … casi todo.

También he escrito un post sobre Cómo instalar Zeal en Ubuntu 14.04

actualización 2019-09-29: Java versión 11

La técnica a continuación no funciona ahora con Java 11, y probablemente con versiones superiores: no hay forma de ignorar múltiples “enlaces rotos” (es decir, a otras clases, otras API). Solución: mantenga su archivo ejecutable javadoc (o javadoc.exe) de la versión 8 de Java

Hay buenas razones para crear sus propios javadocs locales, ¡y no es particularmente difícil!

Primero necesitas la fuente. Al momento de escribir, el JDK de Java 8 viene con un archivo zip llamado src.zip. A veces, por razones inexplicables, Oracle no siempre incluye la fuente. Entonces, para algunas versiones anteriores (y quién sabe sobre el futuro), debe obtener la fuente de Java de otra manera. También vale la pena tener en cuenta que, en el pasado, Oracle a veces incluía la fuente con la versión de Linux del JDK, pero no con la de Windows.

Acabo de descomprimir este archivo… los directorios principales son “com”, “java”, “javax”, “launcher” y “org”. Directorio launcher no contiene archivos para documentar.

Puede generar los javadocs de manera muy simple a partir de cualquiera o todos estos mediante un CD en el símbolo del sistema/terminal al directorio ...\src. Entonces vete

javadoc -d docs -Xmaxwarns 10 -Xmaxerrs 10 -Xdoclint:none -sourcepath . -subpackages java:javax:org:com

NB tenga en cuenta que hay un “.” después -sourcepath

Simple como eso. Generar tus propios javadocs también tiene 2 grandes ventajas

1. sabe que son precisamente los javadocs correctos para el JDK (o cualquier archivo jar externo) que está utilizando en su sistema
2. una vez que adquiera el hábito, reconstituir sus Javadocs no es un desafío tedioso (es decir, dónde ir a buscarlos). Por ejemplo, acabo de descomprimir un par de archivos jar de origen cuyos paquetes están estrechamente acoplados, por lo que sus fuentes se “fusionaron” y luego hice un solo Javadoc a partir de ellos…

NB Swing está semioficialmente MUERTO. Todos deberíamos cambiar a JavaFX, que se incluye de manera útil con Java 8 JDK, pero en su propio archivo fuente, javafx-src.zip.

Descomprimido, esto revela 3 paquetes “raíz”: com, javafx y netscape (¿qué?). Estos deben moverse manualmente a los lugares apropiados debajo de los archivos descomprimidos. src directorio (incluyendo el JavaFX com.sun paquetes bajo Java com.sun estructura). La compilación de todos estos archivos Javadoc le tomó a mi máquina un tiempo no despreciable. Esperaría ver todas las clases fuente de JavaFX junto con todas las demás clases fuente pronto.

Por cierto, el mismo pensamiento se aplica a la documentación de todos y cada uno de los archivos Java (con fuente) que utiliza. Sin embargo, todas las versiones de la mayoría de los jars se encontrarán con su documentación disponible para descargar en Maven Central http://search.maven.org…

PD pensamiento tardío:
usando Eclipse y el complemento “Gradle STS”: el asistente “Nuevo proyecto Gradle STS” creará un gradle.build archivo que contiene la línea

include plugin: 'eclipse'

Esto descarga mágicamente el jar fuente con el jar ejecutable (bajo GRADLE_HOME) cuando te vas

./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.]

… dándole un grado extra de certeza de que ha acertado src y por lo tanto el derecho javadoc para la dependencia en cuestión.

he usado javadoc empaquetado por Allimant desde que estaba en la universidad.

El Javadoc está en el CHM (formato de ayuda estándar de Windows), por lo que se ve mejor cuando usa Windows.

Para la descarga de la última documentación de Java (JDK 8u77) API

Navegar a http://www.oracle.com/technetwork/java/javase/downloads/index.html

En Recursos adicionales y en Documentación de Java SE 8, haga clic en el botón Descargar.

Bajo Kit de desarrollo de Java SE 8 Documentación → Kit de desarrollo de Java SE 8u77 Documentación.

Aceptar el Acuerdo de licencia y haga clic en el archivo ZIP de descarga.

• Descomprimir el archivo descargado
• Inicie la documentación de la API desde jdk-8u77-docs-all\docs\api\index.html

Para la descarga de la API de otras versiones de Java, siga los siguientes pasos.

Navegar a http://docs.oracle.com/javase/

En el menú desplegable Versión, seleccione cualquiera de Java SE 7/6/5.

En la página correspondiente de Java SE y en el menú del lado izquierdo de Descargas, haga clic en Documentación JDK 7/6/5 o Documentación de Java SE.

Ahora, en la página siguiente, seleccione la documentación adecuada de Java SE Development Kit 7uXX.

Aceptar Acuerdo de licencia y haga clic en Descargar archivo ZIP.

Descomprima el archivo e inicie la documentación de la API desde
jdk-7uXX-docs-all\docs\api\index.html.