Maven n'est pas de travail dans Java 8 lors de la Javadoc, les balises sont incomplètes

La meilleure solution serait de fixer la javadoc des erreurs. Si, pour une raison qui n'est pas possible (c'est à dire: génération automatique de code source), vous pouvez désactiver cette case.

DocLint est une nouvelle fonctionnalité de Java 8, qui est résumé comme suit:

Fournir un moyen de détecter les erreurs dans les commentaires Javadoc tôt dans la
cycle de développement et d'une manière qui est facilement liée à l'
le code source.

Cette option est activée par défaut, et va exécuter tout un tas de vérifications avant de générer la documentation Javadoc. Vous avez besoin de désactiver cette fonction pour Java 8, comme spécifié dans ce fil. Vous aurez à ajouter à votre maven configuration:

<profiles>
  <profile>
    <id>java8-doclint-disabled</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</version>
        <executions>
            <execution>
                <id>attach-javadocs</id>
                <goals>
                    <goal>jar</goal>
                </goals>
                <configuration>
                    <additionalparam>${javadoc.opts}</additionalparam>
                </configuration>
            </execution>
        </executions>
    </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>${javadoc.opts}</additionalparam>
              </configuration>
            </plugin>
          </reportPlugins>
        </configuration>
      </plugin>
   </plugins>
</build>

Pour maven-javadoc-plugin 3.0.x:
Remplacer

<additionalparam>-Xdoclint:none</additionalparam>

avec

<doclint>none</doclint>

Ici est le plus concis, je suis conscient de l'ignorer doclint avertissements indépendamment de la version de java utilisée. Il n'y a pas besoin 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, 8 et 11.

Les plus brefs solution qui fonctionnera avec n'importe quelle version de Java:

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

Viens de l'ajouter à votre POM et vous êtes bon pour aller.

C'est fondamentalement @ankon réponse plus @zapp réponse.

Pour maven-javadoc-plugin 3.0.0 utilisateurs:

Remplacer

<additionalparam>-Xdoclint:none</additionalparam>

par

<doclint>none</doclint>

Je ne pense pas que juste éteindre DocLint est une bonne solution, du moins pas à long terme. Il est bon que la Javadoc est devenu un peu plus strict, donc la bonne façon de résoudre le construire problème est de résoudre le problème sous-jacent. Oui, vous aurez besoin de réparer ces fichiers de code source.

Voici les choses à regarder dehors pour que vous pourriez déjà sortir avec:

• HTML incorrect (par exemple manque une balise de fin, non échappée des supports, etc)
• Invalide {@link }s. (en va de même pour les mêmes balises comme @see)
• Invalide @author valeurs. Cette habitude d'être accepté : @author John <[email protected]> mais pas plus à cause de la non échappée des crochets.
• Tables HTML dans Javadoc maintenant besoin d'un résumé ou de la légende. Voir cette question pour les explications.

Vous devrez simplement de fixer 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 amené mes projets jusqu'à DocLint, parce que cela signifie que je peux être plus confiants que la Javadoc je produis, c'est effectivement ce que j'ai l'intention.

Il y a bien sûr le problème si vous êtes la génération Javadoc sur certains le code source vous n'avez pas produit vous-même, par exemple parce qu'il provient d'un générateur de code, par exemple wsimport. Étrange que l'Oracle n'a pas de préparer leurs propres outils pour JDK8 de la conformité avant de le relâcher JDK8. Il semble il ne sera pas fixé jusqu'à Java 9. Seulement dans ce cas particulier, je vous suggère de désactiver DocLint comme indiqué ailleurs sur cette page.

Car il dépend de la version de votre JRE qui est utilisé pour exécuter la commande maven, vous probablement ne voulez pas 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

De maven-javadoc-plugin 3.0.0 vous devez avoir l'aide de additionalJOption pour régler d'autres Javadoc option, donc si vous souhaitez Javadoc pour désactiver 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 voudrais ajouter un peu de perspicacité dans d'autres réponses

Dans mon cas

-Xdoclint:aucun

N'a pas fonctionné.

Imaginons que, dans mon projet, je n'ai pas vraiment besoin de javadoc à tous. Seulement quelques plugins avait eu un moment de la construction de la dépendance sur elle.

Donc, la façon la plus simple de résoudre mon problème était le suivant:

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

Donc, vous sauver de quelques heures que je n'ai pas l'essayer si il semble ne pas fonctionner:

 <additionalJOption>-Xdoclint:none</additionalJOption>

La balise est remplacée par des versions plus récentes.

Je suis un peu en retard à la fête, mais j'ai été forcé à la recherche de la solution de rechange aussi, retrouvé ici, et puis trouvé.

Voici ce qui fonctionne pour moi:-

export JAVA_TOOL_OPTIONS=-DadditionalJOption=-Xdoclint:none

Et de démarrer votre Maven build, n'importe quelle distribution Linux construire etc. Bonne chose à propos de ce qu'il ne nécessite pas de Maven config modification des fichiers - je ne pouvais pas le faire car mon objectif était de reconstruire un tas de Centos les paquets rpm, j'ai donc dû aller très profond.