tutorial que proyecto pom plugin oxygen instalar español desde dependencia crear consola comandos adicionar java eclipse maven-2

java - que - maven tutorial español pdf



Cómo hacer referencia a javadocs a las dependencias en el plugin Eclipse de Maven cuando javadoc no está conectado a la dependencia (6)

Uso Eclipse, Maven y Java en mi desarrollo. Uso Maven para descargar dependencias (archivos jar y javadoc, cuando estén disponibles) y el complemento Eclipse de Maven para generar los archivos .project y .classpath para Eclipse. Cuando la dependencia descargada no tiene javadoc adjunto, agrego manualmente un enlace para javadoc en el archivo .classpath para que pueda ver el javadoc de la dependencia en Eclipse. Luego, cuando ejecuto el plugin Eclipse de Maven para regenerar el archivo .classpath, por supuesto, elimina ese cambio.

¿Hay alguna forma de configurar el complemento Eclipse de Maven para agregar automáticamente los atributos classpath para javadoc cuando se ejecuta el complemento Eclipse de Maven?

Solo me interesan las respuestas donde el javadoc y / o las fuentes no se proporcionan para la dependencia en el repositorio de maven, que es el caso más frecuente para mí. Usar downloadSources y / o descargar las propiedades de Javacs no ayudará a este problema.

¿Ayudaría tener las fuentes para la dependencia? Puede decirle al plugin eclipse que descargue esos (y hacer referencia a ellos en .classpath) con -DdownloadSources=true

Puede considerar simplemente evitar este problema completamente instalando el javadoc jar en su repositorio local manualmente usando el objetivo del archivo de instalación y pasando la opción -Dclassifier = javadoc. Una vez que hagas eso, el .classpath que mvn genera debería ser correcto.

Si usa un repositorio remoto como proxy para central, también podría implementar los javadocs en ese repositorio y luego todos los demás que usen ese proxy obtendrán los javadocs automáticamente también.

De las preguntas frecuentes del plugin de Maven Eclipse

El siguiente ejemplo muestra cómo hacer esto en la línea de comandos:

mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true

o en tu pom.xml:

<project> [...] <build> [...] <plugins> [...] <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-eclipse-plugin</artifactId> <configuration> <downloadSources>true</downloadSources> <downloadJavadocs>true</downloadJavadocs> </configuration> </plugin> [...] </plugins> [...] </build> [...] </project>

Estoy ejecutando STS 2.8.1 que es básicamente eclipse + herramientas de primavera; En un proyecto maven existente, hice clic derecho en el proyecto -> maven -> Descargar fuentes y descargar JavaDocs

En general, Javadocs no se utilizan principalmente como dependencia. Porque estos no son necesarios en compilación ni en tiempo de ejecución. Es solo para ayudar al desarrollador mientras se desarrolla o depura.

Suponiendo que se utiliza el IDE Eclipse de Java, podemos usar los documentos de Java como se hace referencia. A continuación se detallan los enfoques a los que podemos asociar los javadocs / fuentes con los respectivos frascos.

1. Si se trata de un proyecto no convencional:

Descargue el archivo javadocs o archivo comprimido, lo que esté disponible y colóquelo en algún directorio. Haga clic con el botón derecho en el proyecto de la aplicación en IDE Eclipse, haga clic en Propiedades y elija Java Build Path, luego seleccione tab Libraries en Java Build Path. Ahora expanda el archivo jar que desea vincular con java docs / source. Seleccione el enlace de la ubicación de Javadoc y haga clic en el botón Editar, aparece una nueva ventana donde tenemos que elegir la ruta del jar de javadocs. Haga clic en Aceptar y hemos vinculado el javadoc / fuente con los respectivos jar.

2. Si es un proyecto de maven

Si estamos utilizando el proyecto Maven, entonces vaya a los archivos jar bajo la dependencia de Maven bajo el proyecto en la vista del Explorador de proyectos, como se muestra a continuación. Ahora haga clic con el botón derecho en el archivo jar al que desea agregar el Javadoc / fuente,  elija Maven y luego haga clic en Javadoc o Fuente que desea vincular con el proyecto. Ahora IDE descargará automáticamente el javadoc / fuente requerido y lo vinculará con el jar respectivo en el proyecto.

Puede verificar esto haciendo clic con el botón derecho en el proyecto en el IDE y haciendo clic en Java Build Path, selecciona la pestaña Libraries debajo de Java Build Path y luego expande el jar deseado, aquí cuando hagas clic en el botón Editar verás la ruta de acceso Javadoc / Source con el respectivo jar como se muestra a continuación en la imagen.

3. Si es un proyecto de Maven y estamos configurando el comportamiento predeterminado:

Eclipse descargará de forma acústica el javadoc / source junto con el jar principal requerido al inicio. De forma predeterminada, se establecen instrucciones para que Maven descargue Javadoc / sources para todas las jarras vinculadas en el proyecto.

Haga clic en Windows - preferencias - seleccione Maven y haga clic en la casilla de verificación Descargar artefacto Javadoc como se muestra a continuación

Ahora haga clic en aplicar y guárdelo y ahora cuando cree un nuevo proyecto Maven, de forma predeterminada los JavaDocs se descargarán y vincularán con todos los archivos jar dependientes del proyecto.
Puede verificar haciendo clic con el botón derecho en el proyecto y Propiedades y en la ruta Java Build puede ver que los javadocs están vinculados con todos los archivos jar como se muestra a continuación.

Si su proyecto es un proyecto de Maven, entonces siempre es mejor usar el segundo enfoque porque al usar este enfoque, IDE y Maven se encargan de descargar la versión correcta de Javadoc / source y la vinculan con el jar relativo también.

El tercer enfoque es un poco costoso porque se descargarán los javadoc / sources para todos los jars dependientes, puede ser que no esté interesado en javadocs / sources para todos los jars dependientes.