摘要：注解全解析什么是注解注解有什么作用注解是怎么干活的如何自定義注解什么是注解注解即元數(shù)據(jù)，一種描述數(shù)據(jù)的數(shù)據(jù)，可以說注解就是源代碼的元數(shù)據(jù)是一種應(yīng)用于類方法參數(shù)變量構(gòu)造器及包聲明中的特殊修飾符不能影響程序代碼的運(yùn)行，無論增加刪除注解，代碼都始

什么是注解？

注解有什么作用？

注解是怎么干活的？

如何自定義注解？

注解即元數(shù)據(jù)，一種描述數(shù)據(jù)的數(shù)據(jù)，可以說注解就是源代碼的元數(shù)據(jù)

Annotation是一種應(yīng)用于類、方法、參數(shù)、變量、構(gòu)造器及包聲明中的特殊修飾符

Annotation不能影響程序代碼的運(yùn)行，無論增加、刪除注解，代碼都始終如一的執(zhí)行

元數(shù)據(jù)(metadata)，數(shù)據(jù)的數(shù)據(jù)

元數(shù)據(jù)可以用來創(chuàng)建文檔，跟蹤代碼的依賴性，執(zhí)行編譯時(shí)格式檢查，代替已有的配置文件

元數(shù)據(jù)以標(biāo)簽的形式存在于Java代碼中，描述的信息是類型安全的(內(nèi)部字段有明確類型)

Annotation類型定義了Annotation的名字、類型成員默認(rèn)值，一個(gè)Annotation類型可以是一個(gè)特殊的java接口

使用XML描述元數(shù)據(jù)：XML是為了分離代碼和配置而引入，但有時(shí)候我們希望使用一些和代碼緊耦合的描述

Annotation出現(xiàn)之前，開發(fā)人員使用自己的方式定義元數(shù)據(jù)，如標(biāo)記interfaces,注釋,transient等

Annotation給了一個(gè)統(tǒng)一的標(biāo)準(zhǔn)規(guī)范，在許多框架中與XML結(jié)合使用，平衡兩者的利弊

看源碼@Override注解，你可能會(huì)疑惑，它什么都沒有做，那它是如何檢查在父類中有一個(gè)同名的函數(shù)

強(qiáng)調(diào)：Annotation僅僅是元數(shù)據(jù)，和業(yè)務(wù)邏輯無關(guān)

Annotation并不直接對(duì)程序的語法產(chǎn)生作用，但是會(huì)提供一些程序之外的數(shù)據(jù)或者信息，影響工具或者類庫對(duì)程序的處理或者調(diào)用的方式，從而影響程序運(yùn)行時(shí)的行為

元注解的作用就是負(fù)責(zé)注解其他注解，meta-annotation類型

@Target：用于描述注解的使用范圍，即被描述的注解可以用在什么地方

ElementType.TYPE：用于描述類、接口或enum聲明

ElementType.FIELD：用于描述實(shí)例變量，包括enum常量

ElementType.METHOD：用于描述方法

ElementType.PARAMETER：用于描述參數(shù)

ElementType.CONSTRUCTOR：用于描述構(gòu)造器

ElementType.LOCAL_VARIABLE：用于描述局部變量

ElementType.ANNOTATION_TYPE：用于描述注解類型，另一個(gè)注釋

ElementType.PACKAGE：用于記錄Java文件的package信息

ElementType.TYPE_PARAMETER：可以用在Type的聲明前

ElementType.TYPE_USE：可以用在所有使用Type的地方

初始化對(duì)象：String myString = new @NotNull String();

使用 throws 表達(dá)式：public void validateValues() throws @Critical ValidationFailedException{ }

@Retention：表示需要在什么級(jí)別保存該注釋信息，用于描述注解的生命周期，即被描述的注解在什么范圍內(nèi)有效

RetentionPolicy.SOURCE：在編譯階段丟棄,編譯之后就不再有任何意義，如@Override@SuppressWarnings

RetentionPolicy.CLASS：在類加載的時(shí)候丟棄，在字節(jié)碼文件的處理中使用，注解默認(rèn)使用這種方式

RetentionPolicy.RUNTIME：不會(huì)丟棄，運(yùn)行時(shí)也保留該注解，可以使用反射機(jī)制讀取該注解信息，自定義注解通常使用這種方式

@Documented：注解是否包含在JavaDoc中

@Inherited：是一個(gè)標(biāo)記注解，如果使用了該注解修飾的annotation注解的class，會(huì)被作用于該class的子類

自定義注解：@Todo

package com.adagio.demo;

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

/**
 * 自定義注解
 */
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Todo {
    
    public enum Priority{LOW, MEDIUM, HIGH}
    
    public enum Status{STARTED, NOT, NOT_STARTED}
    
    String author() default "Yash";
    
    Priority priority() default Priority.LOW;
    
    Status status() default Status.NOT_STARTED;

}

如果注解只有一個(gè)屬性，可以直接命名為"value",使用時(shí)無需在標(biāo)明屬性名

package com.adagio.demo;

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

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

注解元素必須有確定的值，可以在定義注解的默認(rèn)值中指定，也可以在使用注解時(shí)指定

使用反射讀取注解信息：BusinessLogic

package com.adagio.demo;

import java.lang.reflect.Method;

public class BusinessLogic {
    
    @Todo(priority = Todo.Priority.MEDIUM, author = "Yashwant", status = Todo.Status.STARTED)
    public void incompleteMethod(){
        
    }
    
    @Author("Yashwant")
    public void someMethod(){
        
    }

    public void readAnnotationInfo(){
        Class businessLogicClass = BusinessLogic.class;
        for(Method method : businessLogicClass.getMethods()){
            Todo todoAnnotation = method.getAnnotation(Todo.class);
            if(todoAnnotation != null){
                System.out.println("Method Name:" + method.getName());
                System.out.println("Author:" + todoAnnotation.author());
                System.out.println("Priority：" + todoAnnotation.priority());
                System.out.println("Status:" + todoAnnotation.author());
            }
        }
    }
    
    public static void main(String[] args) {
        System.out.println("開始讀取》》》》");
        BusinessLogic b = new BusinessLogic();
        b.readAnnotationInfo();
        System.out.println("讀取結(jié)束》》》》");
    }
}

注解的功能很強(qiáng)大，Spring和Hibernate這些框架在日志和有效性中大量使用了注解功能

注解可以應(yīng)用在使用標(biāo)記接口的地方，不同的是標(biāo)記的接口用來定義完整的類，但你可以為單個(gè)方法定義注解，如將一個(gè)方法暴露為服務(wù)

servlet3.0引入的新注解，和servlet安全相關(guān)的注解：

HandlesTypes 該注解用來表示一組傳遞給ServletContainerInitializer的應(yīng)用類

HttpConstraint 該注解代表所有HTTP方法的應(yīng)用請(qǐng)求的安全約束

HttpMethodConstraint 指明不同類型請(qǐng)求的安全約束

MultipartConfig 該注解標(biāo)注在Serblet上，表處理請(qǐng)求MIME類型是multipart/form-data

ServletSecurity 該注解標(biāo)注在Servlet繼承類上，強(qiáng)制該HTTP協(xié)議請(qǐng)求遵循安全約束

WebFilter 該注解用來聲明一個(gè)Servlet過濾器

WebInitParam 該注解用來聲明Servlet或是過濾器中的初始化參數(shù)，通常配合@WebServlet或 @WebFilter使用

WebListener 該注解為Web應(yīng)用程序上下文中不同類型的事件聲明監(jiān)聽器

WebServlet 該注解用來聲明一個(gè)Servlet的配置

參考文檔：
http://www.importnew.com/1029...
http://www.cnblogs.com/peida/...
http://www.cnblogs.com/peida/...
https://www.ibm.com/developer...