Java註釋

習題預習

1. 什麼是Java annotations？請舉例說明註釋跟標籤的差別。
2. @Override和@Deprecated這兩個Java annotations分別代表什麼意思？在Java開發中的使用場景是什麼？
3. @SuppressWarnings、@SafeVarargs和@FunctionalInterface這三個Java annotations分別代表什麼意思？在Java開發中的使用場景是什麼？
4. @Retention和@Target這兩個Java annotations分別代表什麼意思？在Java開發中的使用場景是什麼？
5. 什麼是自定義Java annotations？請舉例說明如何實現一個自定義的Java annotations。

說明知識

Java註解（Annotations），也被稱為元數據（Metadata），是Java 5.0中引入的一種註釋機制。它們能夠為程序元素（類、方法、變量等）打上標記，並可以在編譯、運行時以及部署時進行處理，從而使得程序可以通過註解來獲取額外的信息或者進行一些特殊的操作。

Java註解的語法採用「@註解名稱（參數列表）」的形式，其中@稱為註解標記，註解名稱是註解類型的名稱。在參數列表中，註解可以包含多個屬性，每個屬性都是以名稱=值的形式給出詳細的描述信息。

下面是幾個Java註解的例子：

1. @Override: 該註解告訴編譯器該方法是一個覆蓋了父類方法的方法，如果該方法不是覆蓋父類方法而被標注，則編譯器會報錯。

2. @SuppressWarnings: 該註解告訴編譯器忽略指定的警告信息，這對於一些遺留代碼或者某些不太嚴謹的庫文件非常有用。

3. @Deprecated: 該註解告訴編譯器此處代碼已被廢棄，建議使用其他功能或者替代方案，當程序中使用了被標注的代碼時，編譯器會發出警告。

4. @FunctionalInterface: 該註解表示接口是一個函數接口，該接口只包含一個抽像方法，可以被用於Lambda表達式。

5. @Test: 該註解指定一個方法作為測試方法，JUnit測試框架會自動識別並運行被標注的方法。

總之，Java註解在Java開發中扮演著越來越重要的角色，使用註解可以提高代碼的簡潔程度，降低代碼維護成本，同時提高代碼的可讀性和可維護性。

彙總重點

1. Annotations是Java 5中引入的新特性，可以為Java程序提供元數據信息，使得程序的開發、部署、測試等工作更加靈活。
2. Annotations可以在編譯時、運行時或甚至在部署時通過反射機制來讀取信息，對程序的調試和優化工作非常有幫助。
3. 常用的Java Annotations包括Override、Deprecated、SuppressWarnings、Inherited等。
4. Override用於標注方法覆蓋了父類的方法，編譯時可以檢查是否正確覆蓋。
5. Deprecated用於標注已經過期的方法或類，建議不再使用。
6. SuppressWarnings用於關閉Java編譯器的警告信息。
7. Inherited用於標注子類是否繼承父類的Annotation。
8. 自定義註解可以通過@Target和@Retention等註解來定義作用域和保留期。
9. 註解處理器可以通過apt工具來自動化生成代碼，簡化開發工作。

知識測驗

1. 給定以下的Java annotation，該注釋用於方法上，它的功能是什麼？

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface MyAnnotation {
   String value();
}

答案：該注釋是一個自定義注釋，用於方法上，可以指定一個字符串值。

2. 給定以下的Java annotation，該注釋用於類上，它的功能是什麼？

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface MyAnnotation {
   String author() default "unknown";
   String date();
}

答案：該注釋是一個自定義注釋，用於類上，可以指定類的作者和日期。

3. 定義一個Java注釋，描述當前的方法是否為只讀方法（即不允許對數據進行更改）。
   答案：

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface ReadOnly {}

4. 定義一個Java注釋，描述當前的類是一個單例模式的類。該注釋不能用在任何接口或抽象類上。
   答案：

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface Singleton {}

5. 定義一個Java注釋，描述當前的方法被調用時，必須在指定時間段內完成，否則將拋出異常。
   答案：

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface TimeLimit {
   int seconds() default 5;
}