註解這個東西我們肯定每天都能看見，也許有時候看的太多了到是會忽略註解這東西具體是如何工作的。今天在這裡用最短的篇幅快速講解下註解的原理，對這塊記的不太清楚的同學也可以再次看看，下次有人詳細問這塊的話不至於一知半解。

一句話描述：就是元資料，即一種描述資料的資料。所以，可以說註解就是原始碼的元資料。

package com.qk365.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * @Target說明了Annotation所修飾的物件範圍
 *
 * @Retention定義了該Annotation被保留的時間長短
 * 
 * @Documented可以被例如javadoc此類的工具文件化
 * 
 * @Inherited是否可繼承
 */
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
public @interface LogForController {

	/**
	 * 功能描述
	 */
	public String optMemo() default "";

	/**
	 * 操作模組
	 */
	public String optModel() default "";

}
 

關鍵字解析：

1. @Rentention用來標記自定義註解的有效範圍 ，即註解的生命週期

• RetentionPolicy.SOURCE – 在編譯階段丟棄。這些註解在編譯結束之後就不再有任何意義，所以它們不會寫入位元組碼。@Override, @SuppressWarnings都屬於這類註解。
• RetentionPolicy.CLASS – 在類載入的時候丟棄。在位元組碼檔案的處理中有用。註解預設使用這種方式。
• RetentionPolicy.RUNTIME– 始終不會丟棄，執行期也保留該註解，因此可以使用反射機制讀取該註解的資訊。我們自定義的註解通常使用這種方式。

      2.– 表示該註解用於什麼地方。如果不明確指出，該註解可以放在任何地方。以下是一些可用的引數。需要說明的是：屬性的註解是相容的，如果你想給7個屬性都添加註解，僅僅排除一個屬性，那麼你需要在定義target包含所有的屬性。

• ElementType.TYPE:用於描述類、介面或enum宣告
• ElementType.FIELD:用於描述例項變數
• ElementType.METHOD
• ElementType.PARAMETER
• ElementType.CONSTRUCTOR
• ElementType.LOCAL_VARIABLE
• ElementType.ANNOTATION_TYPE 另一個註釋
• ElementType.PACKAGE 用於記錄java檔案的package資訊

[email protected] 使用了@Documented的可以在javadoc中找到

[email protected]

[email protected] 這個東西在宣告註解的時候必須得使用，用@interface就意味著這個東西已經繼承了java.lang.annotation.Annotation，也說明了它是一個註解。

註解用途： 1.生成文件。

                    2. 跟蹤程式碼依賴性，實現替代配置檔案功能

                   3. 在編譯時進行格式檢查。

                   4.反射