我不明白什么是“Javadoc”。我首先想知道 the/** */和/* */comments 之間的區別。
當我在這里看到答案時,它說了一些關于Java 中的HTML 和API的內容。這完全令人困惑,我什么都聽不懂。我只是Java的初學者,所以請幫助我...
當我使用它們時,我看到絕對沒有區別。編譯器在執行時忽略了兩條多行注釋。
uj5u.com熱心網友回復:
Javadoc 與編譯后的代碼或任何其他運行時行為無關。
它在那里,以便程式員可以對類、變數和方法進行評論。全部就地,無需外部評論或檔案。
當你有一個像 Eclipse 或 IntelliJ 這樣的 IDE 時,當你將滑鼠懸停在其他地方的方法呼叫上時,它會顯示這些注釋。
Javadoc 也可以從源代碼(.java 類)中讀取并編譯成 HTML 頁面,就像所有主要的 Java 檔案一樣。
看看這個,這是一個很好的概述:https ://www.baeldung.com/javadoc
uj5u.com熱心網友回復:
編譯器將忽略這兩個注釋,是的。編譯器的作用沒有區別。
不同之處在于您可以使用 Javadoc 工具將 Javadoc 注釋(不是普通注釋)轉換為這樣的檔案。(許多 IDE,如 Eclipse 或 IntelliJ,也會以這種格式顯示檔案,例如當您將滑鼠懸停在您正在呼叫的方法上時。)
uj5u.com熱心網友回復:
編譯到類時,普通評論會被洗掉。
Javadocs 不像常規注釋那樣保留在代碼中,它可用于自動生成 HTML 檔案,您可以發布這些檔案以供人們理解您的 API。
Javadoc 示例:
https ://docs.javacord.org/api/v/3.4.0/
轉載請註明出處,本文鏈接:https://www.uj5u.com/houduan/454954.html
