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-plugin ฉันไม่สามารถใช้งานกับ 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: Doclet API แบบง่าย
แทนที่Doclet APIเก่าด้วย API แบบง่ายใหม่ที่ใช้ประโยชน์จาก API อื่น ๆ ที่มีอยู่มาตรฐาน doclet มาตรฐานได้รับการเขียนใหม่เพื่อใช้ Doclet API ใหม่

API ที่มีอยู่และ doclet มาตรฐานเก่าพร้อมใช้งาน แต่ยังไม่ได้รับการอัปเดตเพื่อรองรับคุณสมบัติภาษาใหม่เช่นโมดูล

API เก่ากำลังใช้แพ็คเกจcom.sun.javadoc

Doclet API (หรือที่เรียกว่า Javadoc API) เป็นกลไกสำหรับลูกค้าในการตรวจสอบโครงสร้างระดับซอร์สของโปรแกรมและไลบรารีรวมถึงความคิดเห็น javadoc ที่ฝังอยู่ในซอร์ส

คุณสามารถลองใช้ Doclet API ใหม่ดูตัวอย่าง

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