注解

什么是注解

• Annotation是從JDK5.0開始引入的新技術(shù)
• Annotation的作用：
  • 1.不是程序本身，可以對程序做出解釋（這一點和注釋（comment）沒什么區(qū)別）
  • 2.可以被其他程序（比如：編譯器等）讀取

Annotation的格式：

​ 注解是以"@注釋名"在代碼中存在的，還可以添加一些參數(shù)值，例如：

​ @SuppressWarnings（value=“unchecked”）

Annotation在哪里使用

​ 可以附加到package，class，method，field等上面，相當于給他們添加了額外的輔助信息，我們可以通過反射機制編程實現(xiàn)對這些元數(shù)據(jù)的訪問

內(nèi)置注解

@Override：定義在Java.lang.Override中，此注釋只適用于修飾方法，表示一個方法聲明打算重寫超類中的另一個方法聲明

public class Test extends Object{
	//@Override 重寫注解，必須是重寫超類的方法，不然會發(fā)生編譯器上的錯誤
    @Override
    public String toString() {
        return super.toString();
    }
}

@Deprecated：定義在Java.lang.Deprecated中，此注釋可以用于修飾方法，屬性，類，表示不鼓勵程序員使用這樣的元素，通常是因為它很危險或者存在更好的選擇

	@Deprecated   //意思為方法已經(jīng)過時，存在危險，或者有更好的方法
    public static void test01(){
        System.out.println("過時的");
    }
    public static void main(String[] args) {
        test01();
    }

雖然是過時或存在危險，但是依然可以調(diào)用此方法，

根據(jù)上面的圖片也會看到，如果被@Deprecated注釋上的方法，在調(diào)用的時候，會畫一點橫線

@suppressWarnings：定義在java.lang.SuppressWarnings中，用來抑制編譯時的警告信息，

​ 與前兩個注釋有所不同，你需要添加一個參數(shù)才能正常使用，這些參數(shù)都是已經(jīng)定義好了的，我們選擇性的使 用就好了

√@SuppressWarnings(“all”)

√@SuppressWarnings(“unchecked”)

√@SuppressWarnings(value={“unchecked”,“deprecation”})

√等等

元注解

元注解的作用就是負責注解其他注解，Java定義了4個標準的meta-annotation類型，他們被用來提供對其他annotation類型作說明

這些類型和它們所支持的類在Java.lang.annotation包中可以找到（@Target，@Retention，@Documented，@Inherited）

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

@Retention：表示需要在什么級別保存該注釋信息，用于描述注解的生命周期

（SOURCE<CLASS<RUNTIME）

@Document:說明該注解將被包含在Javadoc中

@Inherited：說明子類可以繼承父類中的該注解

//測試元注解
    @MyAnnotation
public class Test02 {
}
//定義一個注解
//Target  表示我們的注解可以用到哪些地方
@Target(value = {ElementType.METHOD,ElementType.TYPE}) //METHOD注解可以在方法TYPE可以在類
//Retention 表示我們的注解在什么地方還有效
//runtime>class>sources
@Retention(value = RetentionPolicy.RUNTIME)
//Documented 表示是否將我們的注解生成在Javadoc中
@Documented
//子類可以繼承父類的注解
@Inherited
 @interface MyAnnotation{
}

自定義注解

使用**@interface**自定義注解時，自動繼承了java.lang.annotation.Annotation接口

分析：

@interface用來聲明一個注解，格式：public @interface 注解名{ 定義內(nèi)容 }

其中的每一個方法實際上是聲明了一個配置參數(shù)

方法的名稱就是參數(shù)的名稱

返回值類型就是參數(shù)的類型（返回值只能是基本類型，Class，String，enum）

可以通過default來聲明參數(shù)的默認值

如果只有一個參數(shù)成員，一般參數(shù)名為value

注解元素必須要有值，我們定義注解元素時，經(jīng)常使用空字符串，0作為默認值

實例

public class Test03 {
    //注解可以顯示賦值，如果沒有默認值，我們就必須給注解賦值
    @MyAnntotation2(schools = {"河北軟件","寬城職教"})
    public void Test(){}
    @MyAnntotation3("ccl")  //可以省略value
    public void Test1(){}
}
//多次參數(shù)的注解
@Target({ElementType.TYPE,ElementType.METHOD})  //可以用到哪里
@Retention(RetentionPolicy.RUNTIME)   // 表示在什么地方有效
@interface MyAnntotation2{
    //注解的參數(shù):參數(shù)類型+參數(shù)名（）;
    String name() default "";
    int age() default 0;
    int id() default -1; //如果默認值為-1，代表不存在
    String[] schools();
}
//一個參數(shù)的注解
@Target({ElementType.TYPE,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnntotation3{
    String value() ;
}

如果注解的參數(shù)只要有一個的時候，可以將參數(shù)名設(shè)為value，這樣在寫注解的時候，括號里可以省略value參數(shù)名，而別的參數(shù)名需要寫上

@interface MyAnntotation3{
    String value() ;
}

總結(jié)

本篇文章就到這里了，希望能給你帶來幫助，也希望您能夠多多關(guān)注腳本之家的更多內(nèi)容！

最新評論