JDK 11+ et Javadoc

Exit code: 1 - javadoc: error - The code being documented uses packages in the unnamed module, but the packages defined in https://docs.oracle.com/en/java/javase/11/docs/api/ are in named modules.

Quelqu'un a-t-il pu faire fonctionner javadoc sans avoir à changer la version source en 1.8 (comme suggéré dans d'autres forums)? J'utilise JDK v11.0.5 et le problème est toujours présent (également avec JDK 12+).

Edit: Cette erreur provient de maven et a été lancée par le plugin maven-javadoc. Je n'ai pas pu le faire fonctionner pour JDK 11+ même avec la <source>8</source>configuration.

Comme suggéré dans le traqueur de problèmes OpenJDK, cela peut être contourné avec la définition de la source sur le plugin Javadoc:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <configuration>
        <source>8</source>
    </configuration>
</plugin>

javadoc produit des liens vers les packages que vous utilisez, par exemple vers les classes documentées dans .../javase/11/docs/api. Alors que vos commentaires sont dans un module sans nom, les cibles ne le sont pas et javadoc ne peut pas combiner ces deux. Il produit un package-listou un element-listfichier, vous ne pouvez donc pas mélanger des modules (packages) sans nom avec des modules nommés.

Je n'ai pas trouvé de moyen de limiter les liens que javadoc essaie de produire; vous devrez donc peut-être utiliser des modules pour votre propre projet. Cela me semble ridicule, juste pour rendre javadoc heureux. Je suppose que ce n'est qu'une des raisons pour lesquelles tant de gens s'en tiennent à Java 8.

Il y avait une importante rupture de changement depuis Java 9 pour l' utilisation de l' API Doclet

JEP 221: API Doclet simplifiée
Remplace l'ancienne API Doclet par une nouvelle API simplifiée qui exploite d'autres API standard existantes. Le doclet standard a été réécrit pour utiliser la nouvelle API Doclet

L'API existante et l'ancien doclet standard sont disponibles, mais n'ont pas été mis à jour pour prendre en charge de nouvelles fonctionnalités de langage, telles que les modules

L'ancienne API utilise le package com.sun.javadoc

L'API Doclet (également appelée API Javadoc) fournit un mécanisme permettant aux clients d'inspecter la structure au niveau source des programmes et des bibliothèques, y compris les commentaires javadoc intégrés dans la source.

Vous pouvez essayer d'utiliser la nouvelle API Doclet, voir des exemples

public class BasicDoclet implements Doclet {
@Override
public void init(Locale locale, Reporter reporter) {  }
@Override
public String getName() {
    // For this doclet, the name of the doclet is just the
    // simple name of the class. The name may be used in
    // messages related to this doclet, such as in command-line
    // help when doclet-specific options are provided.
    return getClass().getSimpleName();
}