Discussion :

[Methode]

Bonjour,

Sous Maven la commande mvn eclipse:clean eclipse:eclipse -dDownloadSources=true -dDownloadJavaDocs=true permet de télécharger à la fois le jar de l'artifact en question mais aussi les sources et la javadoc censés y être rattaché tout en formatant proprement le projet sous eclipse.

Or, les sources et la javadoc sont bien souvent téléchargées sous forme de fichier jar ce qui est bien plus pratique qu'un dossier avec plein de fichiers dedans. Cependant, quand elles sont indisponibles eclipse nous le fait savoir non pas par un BUILD FAILURE mais par un simple warning.

Première question : C'est alors à l'utilisateur de rattacher lui-même les sources et la javadoc ?

Deuxième question : Comment générer le fichier xxxx-src.jar et le fichier xxx-docs.jar à partir d'un projet java dont on a les sources ?

Troisième question : Y a t-il des conventions à respecter ? (nom des archives, arborescence des archives, archive spécifique pour la doc ou intégrée dans la source)

Quatrième question : Quelqu'un a t-il une vision plus globale du problème ?

Voilà pour les questions et merci pour vos réponses.

[gboissinot]

Bonjour,

Première remarque,
Les arguments sont -DdownloadSources=true -DdownloadJavaDocs=true, c’est à dire un D majuscule pour signaler un system property et les propriétés downloadSources et downloadJavaDocs qui commencent par une minuscule

Pour un artefact donnée, la commande télécharge l’artefact de sources et de javadocs s’ils existent et met à jour en conséquence la configuration de Eclipse

Réponses :

La commande met a jour automatiquement le fichier .classpath de Eclipse avec pour chaque librairie une entry qui se présente ainsi si le jar de sources ou de javadoc existent

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
 
  <classpathentry kind="var" path="M2_REPO/commons-beanutils/commons-beanutils/1.7.0/commons-beanutils-1.7.0.jar" sourcepath="M2_REPO/commons-beanutils/commons-beanutils/1.7.0/commons-beanutils-1.7.0-sources.jar">
    <attributes>
      <attribute value="jar:file:/D:/Orchestra_data/thalescontrol/maven_repository/commons-beanutils/commons-beanutils/1.7.0/commons-beanutils-1.7.0-javadoc.jar!/" name="javadoc_location"/>
    </attributes>
  </classpathentry>

Les artefacts sources et javadocs sont présents dans les repository Maven au même niveau que l’artefact binaire dont ils correspondent,

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
 
groupId
  artifactId
      version
                artifactId-version.jar
                artifactId-version-sources.jar
                artifactId-version-javadoc.jar

Le contenu du jar "artifactId-version-sources.jar", il faut suivre l'usage courant qui consiste a garder l'arborescence de package.
De même, pour l'artefact de javadoc.

Si les artefacts de sources et de javadocs ne sont pas présents dans les repository Maven, et que vous avez les sources; il vous ai toujours possible de les déployer dans votre repository local ou dans un repository distant en gardant le nommage des classifiers "sources" et "javadoc"

--
Gregory

[Methode]

Merci pour ta réponse.

Cela confirme bien ce que je pensais. Après si je dispose des sources sous forme de fichiers (api/docs....). Je dois les archiver en .jar afin que cela respecte le formalisme imposé par Maven ? Même question pour la javadoc....

[tnodev]

Bonjour
Une question bête ...

Pourquoi un jar pour les sources et un autre pour la javadoc ?
Un seul ne suffirait-il pas ??

[Methode]

Justement, je crois que la "meilleure " façon de faire c 'est bien séparer les deux...