注解
Java中的注解（Annotation）是一種元數據形式，用于向編譯器或JVM提供有關程序元素（如類、方法、變量、參數和包）的附加信息。注解不會直接影響程序的行為或結構，但它們可以被編譯器、開發工具或運行時環境用于生成代碼、進行驗證、執行處理或提供信息。以下是關于Java注解的幾個關鍵點：
1. 注解的種類
1.1.內置標準注解：
@Override：指示一個方法覆蓋了超類中的方法。@Deprecated：標記已過時的元素，建議不再使用。@SuppressWarnings：抑制編譯器警告。
1.2.元注解：給注解用的注解
用于創建自定義注解的注解，包括：
1.2.1.@Retention：
指定注解保留策略(解析時間)，如RetentionPolicy.SOURCE（只保留在源碼中）、RetentionPolicy.CLASS（保留在class文件中）或RetentionPolicy.RUNTIME（運行時可通過反射訪問）。
1.2.1.1. SOURCE : 編譯時（Compile Time）
編譯時解析的注解在源代碼被編譯成字節碼時被處理。這些注解主要用于生成額外的代碼、檢查代碼的正確性或進行其他靜態分析。例如，@Override, @Deprecated, 和一些編譯器使用的注解如Lombok的@Data就是在編譯時期被解析的。編譯器或注解處理器（如APT, Annotation Processing Tool）會讀取這些注解并據此執行相應的操作。
1.2.1.2.CLASS : 類加載時（Class Load Time）
這類注解在類被加載到Java虛擬機（JVM）時被解析。例如，一些框架或庫會在類加載階段利用這些注解來配置類的行為，如Spring框架使用@Component, @Service, @Autowired等注解來實現依賴注入和bean的裝配，這些注解會在應用上下文初始化，即類加載時被解析和處理。
1.2.1.3.RUNTIME : 運行時（Runtime）
運行時解析的注解在應用程序運行過程中可以被讀取和處理。這意味著注解信息在程序執行期間始終可用，可以通過反射API來訪問這些注解。例如，@Retention(RetentionPolicy.RUNTIME)注解的那些注解可以在程序運行時通過反射被檢測到，常用于自定義注解處理、日志記錄、權限控制等場景。
1.2.2.@Target：
指定注解可以應用到哪些程序元素上。
它接受一個ElementType類型的枚舉值數組作為參數，ElementType枚舉定義了一系列可能的目標元素類型。以下是ElementType的一些主要選項：
- ElementType.TYPE: 類、接口（包括注解類型）或枚舉聲明。
- ElementType.FIELD: 類或接口中的字段聲明（包括枚舉常量）。
- ElementType.METHOD: 類或接口中的方法聲明。
- ElementType.PARAMETER: 方法參數聲明。
- ElementType.CONSTRUCTOR: 類的構造函數聲明。
- ElementType.LOCAL_VARIABLE: 本地變量聲明。
- ElementType.ANNOTATION_TYPE: 另一個注解的聲明。
- ElementType.PACKAGE: 包聲明。
- ElementType.TYPE_PARAMETER: 類型參數聲明（Java 8及以后版本）。
- ElementType.TYPE_USE: 任何類型使用的地方，如泛型參數、類型轉換、靜態成員的類型等（Java 8及以后版本）。
1.2.3.@Documented：
指示該注解應被包含在生成的API文檔中。
1.2.4.@Inherited：
允許子類繼承父類上的注解。
1.2.5.@Repeatable：
自Java 8起，允許同一注解在同一聲明上多次使用。
1.3.自定義注解：
開發者可以定義自己的注解，通過@interface關鍵字實現，用于滿足特定的編程需求或框架集成。
public @interface MyAnnotation {}
1.3.1.注解的參數
定義注解參數
-
參數類型：注解參數必須是基本類型、String、Class、枚舉類型、注解類型或者這些類型的數組。不能使用其他復雜類型如自定義類作為參數。
-
默認值：每個注解參數都可以有一個默認值，如果沒有提供默認值且該參數又是必需的，則在使用注解時必須顯式指定參數值。
-
參數命名：參數命名遵循Java的標識符規則，通常采用小駝峰命名法。
示例定義
public @interface MyAnnotation {String name() default ""; // 默認值為空字符串int age(); // 必須提供值，沒有默認值Class<?> clazz() default Object.class; // 默認值為Object類ElementType[] targets(); // 參數可以是數組類型
}
使用注解參數
在應用注解時，通過參數名指定參數值，如果是數組類型的參數，可以使用花括號 {} 來包裹多個值。
@MyAnnotation(name = "Alice", age = 25, clazz = String.class, targets = {ElementType.FIELD, ElementType.METHOD})
public class MyClass {// ...
}
特殊參數類型
- Class類型參數：允許指定一個類或接口類型。
- 枚舉類型參數：限制參數為預定義的一組值。
- 注解類型參數：允許注解作為參數，用于嵌套注解的情況。
- 數組類型參數：支持傳遞多個相同類型的值，如上面的
targets參數。
1.3.2.value參數
在Java注解中，value是一個特殊的參數名。當一個注解只有一個參數，并且該參數名為value時，你可以省略參數名直接指定值。這種設計讓注解的使用更加簡潔易讀。下面是具體說明和示例：
特殊之處
- 默認識別：如果一個注解僅定義了一個參數，并且這個參數的名字是
value，那么在使用該注解時，可以直接寫值而不必指定參數名。編譯器會自動將這個值賦給value參數。 - 多參數注解中的
value: 即使一個注解定義了多個參數，如果其中包含名為value的參數，你仍然可以在只有一個值需要傳遞時省略value=。但是，如果有多個值需要指定，則所有參數都必須明確指出參數名。
示例定義
public @interface MySingleValueAnnotation {String value(); // 注意這里只有一個名為value的參數
}
使用示例
@MySingleValueAnnotation("Some text") // 直接寫值，不需要寫value=
public class MyClass {// ...
}// 對于非字符串或基本類型，同樣適用
@MySingleValueAnnotation(123) // 假設value參數類型為int
public void myMethod() {// ...
}
2.訪問注解信息
在Java中，通過反射處理注解是一種常見的做法，主要用于在運行時 ( 即使用@Retention(RUNTIME)定義的注解 ) 動態地檢查和操作那些被注解標記的類、方法、字段等元素。以下是一些基本步驟和示例，展示如何使用反射來獲取和使用注解信息：
2.1. 獲取注解實例
首先，你需要獲取到你想要檢查的類、方法或字段的 Class 對象。之后，可以使用這個 Class 對象提供的幾個方法來檢查和獲取注解：
isAnnotationPresent(Class<? extends Annotation> annotationClass)：檢查是否具有指定類型的注解。getAnnotation(Class<? extends Annotation> annotationClass)：獲取指定類型的注解實例，如果沒有則返回null。getAnnotations()或getDeclaredAnnotations()：獲取所有注解或直接聲明的注解數組。
示例：獲取類上的注解
假設我們有一個自定義的注解 @MyAnnotation，并應用到了某個類 MyClass 上。
@MyAnnotation(value = "Hello, World!")
public class MyClass {// ...
}
獲取這個類上的 MyAnnotation 實例：
Class<MyClass> clazz = MyClass.class;
if (clazz.isAnnotationPresent(MyAnnotation.class)) {MyAnnotation myAnnotation = clazz.getAnnotation(MyAnnotation.class);System.out.println("注解的值: " + myAnnotation.value());
}
示例：獲取方法上的注解
同樣的，如果 MyAnnotation 應用于某個方法上：
public class MyClass {@MyAnnotation(value = "Method Annotation")public void myMethod() {// ...}
}
獲取方法上的注解：
Method method = MyClass.class.getMethod("myMethod");
if (method.isAnnotationPresent(MyAnnotation.class)) {MyAnnotation myAnnotation = method.getAnnotation(MyAnnotation.class);System.out.println("方法注解的值: " + myAnnotation.value());
}
示例：基于注解值動態操作
根據注解的信息，你可以進一步決定程序的執行邏輯，例如：
if (myAnnotation != null && "Special Value".equals(myAnnotation.value())) {// 執行特定的操作
} else {// 執行默認操作
}
注意事項
- 確保你的注解有運行時保留策略 (
@Retention(RetentionPolicy.RUNTIME))，否則它們不會在運行時可見。 - 當使用反射處理注解時，考慮性能影響，特別是在頻繁操作或大型項目中。
- 利用注解可以極大地增強代碼的靈活性和可配置性，但過度使用或設計不當也可能導致代碼難以理解和維護。
3. 注解的作用
- 提供配置信息：注解可以替代XML或其他外部配置文件，直接在代碼中提供配置細節。
- 代碼文檔化：增強代碼的自我解釋性，提供方法用途、參數意義等信息。
- 編譯時檢查：通過編譯時注解處理器進行類型安全檢查、格式驗證等。
- 框架集成：許多Java框架（如Spring）使用注解來配置依賴注入、事務管理等。
- 代碼生成：一些工具可以讀取注解并據此自動生成代碼片段，如序列化/反序列化代碼、getter/setter等。
- 運行時處理：通過反射，應用程序可以在運行時發現和處理注解，實現動態行為。
+獨立端)
