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

Herkes kaynak sürümünü 1.8 (diğer forumlarda önerildiği gibi) değiştirmek zorunda kalmadan javadoc çalışmasını mümkün mü? JDK v11.0.5 kullanıyorum ve sorun hala devam ediyor (ayrıca JDK 12+ ile).

Düzenleme: Bu hata maven kaynaklanır ve maven-javadoc-eklentisi tarafından atılır. <source>8</source>Konfigürasyonda bile JDK 11+ için çalışmasını sağlayamadım .

As OpenJDK sorun izleyicide önerilen bu Javadoc eklenti üzerinde kaynağını tanımlayan birlikte çalışılan:

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

javadoc kullandığınız paketlere, örneğin belgelenmiş sınıflara bağlantılar üretir .../javase/11/docs/api. Yorumlarınız adlandırılmamış bir modüldeyken, hedefler değildir ve javadoc bu ikisini birleştiremez. Bir package-listveya element-listdosya üretir , bu nedenle adlandırılmamış modülleri (paketleri) adlandırılmış modüllerle karıştıramazsınız.

Javadoc'un üretmeye çalıştığı bağlantıları sınırlandırmanın bir yolunu bulamadım; kendi projeniz için modüller kullanmanız gerekebilir. Javadoc'u mutlu etmek için bu bana saçma geliyor. Sanırım bu, birçok insanın Java 8'e yapışmasının nedenlerinden sadece biri.

Önemli yoktu kırılma beri değişim Java 9 Doclet API kullanarak için

JEP 221: Basitleştirilmiş Doclet API'sı
Eski Doclet API'sini diğer standart, mevcut API'lardan yararlanan yeni basitleştirilmiş bir API ile değiştirir. Standart doclet yeni Doclet API'sını kullanmak için yeniden yazıldı

Mevcut API ve eski standart dokümantasyon mevcut, ancak modüller gibi yeni dil özelliklerini destekleyecek şekilde güncellenmedi

Eski API, com.sun.javadoc paketini kullanıyor

Doclet API'sı (Javadoc API olarak da bilinir), istemcilere, kaynağa katıştırılmış javadoc yorumları da dahil olmak üzere programların ve kitaplıkların kaynak düzeyinde yapısını denetleme mekanizması sağlar.

Yeni Doclet API'sını kullanmayı deneyebilirsiniz, örneklere bakın

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