Java語言中的類、方法、變數、引數和包等都可以被標註。和Javadoc不同，Java標註可以通過反射獲取標註內容。在編譯器生成類檔案時，標註可以被嵌入到位元組碼中。Java虛擬機器可以保留標註內容，在執行時可以獲取到標註內容。 當然它也支援自定義Java標註。

內建註解

• Override - 檢查該方法是否是過載方法。如果發現其父類，或者是引用的介面中並沒有該方法時，會報編譯錯誤。
• Deprecated - 標記過時方法。如果使用該方法，會報編譯警告。
• SuppressWarnings - 指示編譯器去忽略註解中宣告的警告。

當然啦，我們主要的目的是學習自定義註解

下面給出一個例子，主要是關於我們在連線資料庫的自定義註解

package com.annotion;

import java.lang.annotation.*;

/**
 * @Target代表註解可以使用的地方
 * ElementType代表元素型別，它是一個列舉
 * FIELD代表可以用在例項域上。
 *
 * @Retention 其中的RetentionPolicy表示保留策略，它也是一個列舉型別，包含三種策略，（預設是CLASS）
 * ①SOURCE 表示 註解將被編譯器丟棄（也就是隻能在原始碼中存在，編譯成class檔案後，就沒了） （例如我們常用的@Override）
 * ②CLASS 表示 註解將在被編譯器在類檔案中記錄，但在執行時不需要被虛擬機器保留.
 * （在編譯成.class檔案後依然存在，但是在虛擬機器中執行的時候就沒有了）
 * ③RUNTIME 表示註解將由編譯器在類檔案中記錄，在執行時由虛擬機器保留，因此它們可以反射性的讀取。
 * （在虛擬機器中執行的時候任然存在，但是程式可以通過反射獲取這些資訊。）
 *
 * @Inherited
 
表示這個註解可以被子類繼承
 *
 * @Document表示當執行javadoc的時候，本註解會生成相關文件
 */
@Target({ElementType.METHOD,ElementType.TYPE,ElementType.FIELD,ElementType.PARAMETER,ElementType.CONSTRUCTOR})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface JDBCConfig {

    String ip();
    int port() default
 
 3306;
    String database();
    String encoding();
    String loginName();
    String password();

}

接著通過反射連線我們的資料庫

*package com.annotion;

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;

/**
* @author home-pc
* @create2018 -03 -31 -10:32
*/
@JDBCConfig(ip=”127.0.0.1”,database = “test”,encoding = “UTF-8”,loginName = “root”,password = “admin”)
public class TestAnnotation {
static {
try {
Class.forName(“com.mysql.jdbc.Driver”);
}catch (ClassNotFoundException e){
e.printStackTrace();
}
}

/**
 * 通過反射
 * @return
 * @throws SQLException
 * @throws NoSuchFieldException
 * @throws SecurityException
 */
public static Connection getConnection()throws SQLException,NoSuchFieldException,SecurityException{
    JDBCConfig config = TestAnnotation.class.getAnnotation(JDBCConfig.class);
    String ip = config.ip();
    int port = config.port();
    String database = config.database();
    String encoding = config.encoding();
    String loginName = config.loginName();
    String password = config.password();
    String url = String.format("jdbc:mysql://%s:%d/%s?characterEncoding=%s", ip, port, database, encoding);
    return DriverManager.getConnection(url,loginName,password);
}

public static void main(String[] args)throws NoSuchFieldException,SecurityException,SQLException, NoSuchMethodException {
    Connection connection=getConnection();
    System.out.println(connection);
}

}
*

總結：註解很重要的一點是通過註解把我們註解的內容保留在位元組碼檔案中或者執行的虛擬機器中，以便在執行時獲得標註的內容。