註釋

導航 Javadoc & Annotations 主題： Javadoc 註釋簡介 建立自定義註釋 元註釋 幫助編譯器

簡介

在 Java 中，註釋 是一種語言結構（在 J2SE 1.5 中引入），它提供了一種將元資料直接包含在原始碼中的機制。

註釋可以為 Java 類、屬性和方法提供元資料。從語法上看，註釋可以看作是一種特殊的修飾符，可以在其他修飾符（如 public、static 或 final）可以使用的任何地方使用。

在 Java 中新增此功能的主要驅動力之一是廣泛使用 XML 描述符來為 Java 類新增附加資訊，即元資料。EJB、JSF、Spring、Hibernate 等框架大量使用外部 XML 描述符。這些外部描述符的問題是，這些檔案超出了 Java 編譯器的範圍，因此無法使用編譯器型別檢查。在巨大的 XML 描述符檔案中，一個小的拼寫錯誤很難定位和修復。另一方面，Java 註釋使用 Java 編譯器型別檢查功能，因此註釋名稱中的拼寫錯誤將被 Java 編譯器捕獲。

總之，註釋可以是...

• 用作編譯器的資訊來源；
• 可用於編譯時或部署時處理；
• 在執行時進行檢查。

外部連結

• [1] Java™ 註釋教程