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

Adakah yang bisa membuat javadoc berfungsi tanpa harus mengubah versi sumber menjadi 1.8 (seperti yang disarankan di forum lain)? Saya menggunakan JDK v11.0.5 dan masalah ini masih ada (juga dengan JDK 12+).

Sunting: Kesalahan ini berasal dari maven dan dilemparkan oleh maven-javadoc-plugin. Saya belum dapat membuatnya berfungsi untuk JDK 11+ bahkan dengan <source>8</source>konfigurasi.

Seperti yang disarankan dalam pelacak masalah OpenJDK ini dapat dikerjakan dengan mendefinisikan sumber pada plugin Javadoc:

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

javadoc menghasilkan tautan ke paket yang Anda gunakan, misalnya ke kelas yang didokumentasikan .../javase/11/docs/api. Meskipun komentar Anda dalam modul yang tidak disebutkan namanya, targetnya tidak, dan javadoc tidak dapat menggabungkan keduanya. Ini menghasilkan salah satu package-listatau element-listfile, sehingga Anda tidak dapat mencampur modul (paket) yang tidak disebutkan namanya dengan modul bernama.

Saya tidak menemukan cara untuk membatasi tautan yang coba diproduksi oleh javadoc; jadi Anda mungkin harus menggunakan modul untuk proyek Anda sendiri. Bagi saya ini konyol, hanya untuk membuat javadoc senang. Saya kira ini hanyalah salah satu alasan mengapa begitu banyak orang tetap menggunakan Java 8.

Ada signifikan breaking perubahan sejak Java 9 untuk menggunakan Doclet API

JEP 221: API Doclet Sederhana
Menggantikan lama dengan API sederhana yang memanfaatkan standar lain, API yang ada. Doclet standar telah ditulis ulang untuk menggunakan Doclet API baru

API yang ada dan dokumen standar lama tersedia, tetapi belum diperbarui untuk mendukung fitur bahasa baru, seperti modul

API lama menggunakan paket com.sun.javadoc

Doclet API (juga disebut Javadoc API) menyediakan mekanisme bagi klien untuk memeriksa struktur tingkat sumber program dan perpustakaan, termasuk komentar javadoc yang tertanam dalam sumber.

Anda dapat mencoba menggunakan API Doclet baru, lihat contoh

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