l'approche la plus simple pour obtenir des choses qui fonctionnent à la fois avec java 8 et java 7 est d'utiliser un profil dans la construction:

<profiles>
  <profile>
    <id>doclint-java8-disable</id>
    <activation>
      <jdk>[1.8,)</jdk>
    </activation>

    <build>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-javadoc-plugin</artifactId>
          <configuration>
            <additionalparam>-Xdoclint:none</additionalparam>
          </configuration>
        </plugin>
      </plugins>
    </build>
  </profile>
</profiles>

voici le moyen le plus concis que je connaisse pour ignorer les avertissements de doclint quelle que soit la version java utilisée. Il n'est pas nécessaire de dupliquer la configuration du plugin dans plusieurs profils avec de légères modifications.

<profiles>
  <profile>
    <id>doclint-java8-disable</id>
    <activation>
      <jdk>[1.8,)</jdk>
    </activation>
    <properties>
      <javadoc.opts>-Xdoclint:none</javadoc.opts>
    </properties>
  </profile>
</profiles>

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-javadoc-plugin</artifactId>
      <version>2.9.1</version>
      <executions>
        <execution>
          <id>attach-javadocs</id> <!-- The actual id should be apparent from maven output -->
          <configuration>
            <additionalparam>${javadoc.opts}</additionalparam>
          </configuration>
        </execution>
      </executions>
    </plugin>
    ...
  </plugins>
</build>

testé sur oracle / open jdk 6, 7 et 8.

ajouter dans la section propriétés globales du fichier pom:

<project>
    ...
    <properties>
        <additionalparam>-Xdoclint:none</additionalparam>
    </properties>

la solution commune fournie ici dans les autres réponses (ajoutant cette propriété dans la section plugins) n'a pas fonctionné pour une raison quelconque. Ce n'est qu'en le positionnant globalement que je pourrais construire le javadoc jar avec succès.

la solution la plus courte qui fonctionnera avec n'importe quelle version Java:

<profiles>
    <profile>
        <id>disable-java8-doclint</id>
        <activation>
            <jdk>[1.8,)</jdk>
        </activation>
        <properties>
            <additionalparam>-Xdoclint:none</additionalparam>
        </properties>
    </profile>
</profiles>

ajoutez ça à votre POM et vous pouvez y aller.

c'est essentiellement la réponse de @ankon plus la réponse de @zapp .

pour maven-javadoc-plugin 3.0.0 utilisateurs:

remplacer

<additionalparam>-Xdoclint:none</additionalparam>

par

<doclint>none</doclint>

Substitution maven-javadoc-plugin que dans la configuration, ne permet pas de résoudre le problème avec mvn site (électroniques.g lors de la phase de l'émission). Voici ce que je devais faire:

<profile>
  <id>doclint-java8-disable</id>
  <activation>
    <jdk>[1.8,)</jdk>
  </activation>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <configuration>
          <additionalparam>-Xdoclint:none</additionalparam>
        </configuration>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-site-plugin</artifactId>
        <version>3.3</version>
        <configuration>
          <reportPlugins>
            <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-javadoc-plugin</artifactId>
              <configuration>
                <additionalparam>-Xdoclint:none</additionalparam>
              </configuration>
            </plugin>
          </reportPlugins>
        </configuration>
      </plugin>
    </plugins>
  </build>
</profile>

Je ne pense pas que le simple fait d'éteindre DocLint soit une bonne solution, du moins pas à long terme. Il est bon que Javadoc soit devenu un peu plus strict, Donc la bonne façon de corriger le problème de construction est de corriger le problème sous-jacent . Oui, vous aurez finalement besoin de corriger ces fichiers de code source.

Voici les choses à surveiller que vous pourriez auparavant obtenir:

• HTML Incorrect (par exemple, un manque une balise de fin, non échappée des supports, etc)
• invalide {@link } art. (il en va de même pour les étiquettes similaires telles que @see )
• valeurs invalides @author . Ceci était accepté: @author John <john.doe@mine.com> mais plus tellement en raison des crochets Non-échappés.
• les tables HTML de Javadoc nécessitent maintenant un résumé ou une légende. Voir cette question pour explication.

Vous n'aurez tout simplement corriger vos fichiers de code source et de continuer à construire votre Javadoc jusqu'à ce qu'il peut construire sans échec. Lourd Oui, mais personnellement j'aime quand j'ai porté mes projets au niveau DocLint parce que cela signifie que je peux être plus sûr que le Javadoc que je produis est en fait ce que j'ai l'intention.

il y a bien sûr le problème si vous générez Javadoc sur un code source que vous n'avez pas produit vous-même, par exemple parce qu'il vient d'un générateur de code, par exemple wsimport . Il est étrange Qu'Oracle n'ait pas préparé ses propres outils pour la conformité JDK8 avant de publier JDK8. Il semble il ne sera pas fixé jusqu'à Java 9 . Ce n'est que dans ce cas précis que je suggère de désactiver DocLint comme indiqué ailleurs sur cette page.

vous pouvez essayer de définir la propriété failOnError (voir documentation du plugin ) à false :

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.9</version>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <goals>
                <goal>jar</goal>
            </goals>
            <configuration>
              <failOnError>false</failOnError>
            </configuration>
        </execution>
    </executions>
</plugin>

comme vous pouvez le voir dans les documents, la valeur par défaut est true .

Puisqu'il dépend de la version de votre JRE qui est utilisé pour exécuter la commande maven vous propably dont veulent désactiver DocLint par défaut dans votre pom.xml

par conséquent, à partir de la ligne de commande vous pouvez utiliser le commutateur -Dadditionalparam=-Xdoclint:none .

exemple: mvn clean install -Dadditionalparam=-Xdoclint:none

le nom de la propriété de configuration a été modifié dans la dernière version de maven-javadoc-plugin qui est 3.0.0.

par conséquent le ne fonctionnera pas. Nous devons donc la modifier comme suit.

   <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-javadoc-plugin</artifactId>
      <version>3.0.0</version>
      <configuration>
         <doclint>none</doclint>
      </configuration>
  </plugin>

à partir de maven-javadoc-plugin 3.0.0 vous auriez dû utiliser additionalJOption pour définir une option Javadoc supplémentaire, donc si vous souhaitez que Javadoc désactive doclint, vous devez ajouter la propriété suivante.

<properties>
    ...
    <additionalJOption>-Xdoclint:none</additionalJOption>
    ...
<properties>

vous devez également mentionner la version de maven-javadoc-plugin comme 3.0.0 ou plus.

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>3.0.0</version>    
</plugin>

Je ne suis pas sûr que cela va aider, mais même moi a fait face au même problème très récemment avec Oozie-4.2.0 version. Après avoir lu les réponses ci-dessus, je viens d'ajouter l'option maven à travers la ligne de commande et cela a fonctionné pour moi. Donc, juste le partage ici.

j'utilise java 1.8.0_77 , Je n'ai pas essayé avec java 1.7

bin/mkdistro.sh -DskipTests - Dmaven.javadoc.opts=' - Xdoclint: - html'

ajouté sous

JAVA_TOOL_OPTIONS= - DadditionalJOption= - Xdoclint: none

sur Jenkins job configuration > environnement de construction > injecter des variables d'environnement dans le processus de construction > contenu des propriétés

a résolu mon problème de construction de code par Jenkins Maven: -)

alors, économisez-vous quelques heures que je n'ai pas et essayez ceci si cela ne semble pas fonctionner:

 <additionalJOption>-Xdoclint:none</additionalJOption>

la balise est modifiée pour les versions plus récentes.

je voudrais ajouter un peu de perspicacité dans d'autres réponses

dans mon cas

- Xdoclint: none

n'a pas marché.

commençons par ça, dans mon projet, je n'avais pas vraiment besoin de javadoc. Seuls quelques plugins nécessaires avaient une dépendance de build time.

donc, le moyen le plus simple de résoudre mon problème était:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <configuration>
        <skip>true</skip>
    </configuration>
</plugin>

je suis un peu en retard à la fête, mais j'ai été forcé de chercher une solution aussi, j'ai fini ici, et je l'ai trouvé.

voici ce qui marche pour moi: -

export JAVA_TOOL_OPTIONS=-DadditionalJOption=-Xdoclint:none

et ensuite démarrer votre Maven build, toute distribution Linux build, etc. C'est une bonne chose que cela ne nécessite pas de modification de fichiers "Maven config - Je ne pouvais pas le faire car mon objectif était de reconstruire un tas de paquets Centos rpm, j'ai donc dû aller très profond.

pour ignorer les étiquettes manquantes @param et @return , il suffit de désactiver les étiquettes missing groupe doclint . De cette façon, le javadoc sera vérifié pour les problèmes de niveau et de syntaxe:

    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>3.0.0</version>
        <configuration>
            <doclint>all,-missing</doclint>
        </configuration>
    </plugin>

notez qu'il s'agit d'un plugin version 3.0 ou plus récente.