JDK 11+ та 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.

Хтось зміг змусити javadoc працювати без зміни вихідної версії на 1,8 (як це пропонується на інших форумах)? Я використовую JDK v11.0.5 і проблему все ще існує (також з JDK 12+).

Редагувати: Ця помилка виникла з Maven і кинута плагіном maven-javadoc. Мені не вдалося змусити його працювати для JDK 11+ навіть із <source>8</source>конфігурацією.

Як було запропоновано у програмі для відстеження питань OpenJDK, це можна вирішити, визначивши джерело на плагіні Javadoc:

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

javadoc створює посилання на пакунки, які ви використовуєте, наприклад, на класи, задокументовані в .../javase/11/docs/api. Поки ваші коментарі знаходяться в неназваному модулі, цілі немає, і javadoc не може поєднати ці два. Він створює package-listабо element-listфайл, або файл, тому ви не можете змішувати неназвані модулі (пакети) з названими модулями.

Я не знайшов способу обмежити посилання, які намагається створити javadoc; тож можливо вам доведеться використовувати модулі для власного проекту. Це здається мені смішним, просто для того, щоб зробити щастя javadoc. Я думаю, це лише одна з причин того, що так багато людей дотримуються Java 8.

Існував значний розрив змін з Java 9 для використання Doclet API

JEP 221: Спрощений API Doclet
Замінює старий API Doclet на новий спрощений API, який використовує інші стандартні існуючі API. Стандартний doclet був переписаний для використання нового API Doclet

Існуючий API та старий стандартний доклет доступні, але не були оновлені для підтримки нових мовних функцій, таких як модулі

Старий API використовує пакет com.sun.javadoc

API Doclet (також його називають API Javadoc) забезпечує механізм для клієнтів перевіряти структуру програм та бібліотек на рівні джерела, включаючи коментарі javadoc, вбудовані в джерело.

Ви можете спробувати скористатися новим API Doclet, переглянути приклади

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();
}