第八章：枚舉類與注解

8.1：枚舉類的使用

? 類的對(duì)象只有有限個(gè)，確定的。我們稱此類為枚舉類。當(dāng)需要定義一組常量是，強(qiáng)烈建議使用枚舉類。如果枚舉類中只有一個(gè)對(duì)象，則可以作為單例模式的實(shí)現(xiàn)方式。

1. 如何定義枚舉類

   • 方式一：JDK5.0之前，自定義枚舉類。

     public class SeasonTest {public static void main(String[] args) {Season spring = Season.SPRING;System.out.println(spring); // Season{seasonName=春天,seasonDesc=春暖花開}}
     }
     //自定義枚舉類
     class Season{//1.聲明Season對(duì)象的屬性:private final修飾private final String seasonName;private final String seasonDesc;//2.私有化類的構(gòu)造器,并給對(duì)象屬性賦值private Season(String seasonName,String seasonDesc){this.seasonName = seasonName;this.seasonDesc = seasonDesc;}//3.提供當(dāng)前枚舉類的多個(gè)對(duì)象：public static final的public static final Season SPRING = new Season("春天","春暖花開");public static final Season SUMMER = new Season("夏天","夏日炎炎");public static final Season AUTUMN = new Season("秋天","秋高氣爽");public static final Season WINTER = new Season("冬天","冰天雪地");//4.其他訴求1：獲取枚舉類對(duì)象的屬性public String getSeasonName() {return seasonName;}public String getSeasonDesc() {return seasonDesc;}//4.其他訴求1：提供toString()@Overridepublic String toString() {return "Season{" +"seasonName='" + seasonName + '\'' +", seasonDesc='" + seasonDesc + '\'' +'}';}
     }
     

   • 方式二：JDK5.0，可以使用enum關(guān)鍵字定義枚舉類。

     public class SeasonTest1 {public static void main(String[] args) {Season1 summer = Season1.SUMMER;System.out.println(summer); // Season{seasonName=春天,seasonDesc=春暖花開}System.out.println(Season1.class.getSuperclass()); // Enum}
     }
     //使用enum關(guān)鍵字枚舉類
     enum Season1 implements Info{//1.提供當(dāng)前枚舉類的對(duì)象，多個(gè)對(duì)象之間用","隔開，末尾對(duì)象";"結(jié)束SPRING("春天","春暖花開"),SUMMER("夏天","夏日炎炎"),AUTUMN("秋天","秋高氣爽"),WINTER("冬天","冰天雪地");//2.聲明Season對(duì)象的屬性:private final修飾private final String seasonName;private final String seasonDesc;//2.私有化類的構(gòu)造器,并給對(duì)象屬性賦值private Season1(String seasonName,String seasonDesc){this.seasonName = seasonName;this.seasonDesc = seasonDesc;}//4.其他訴求1：獲取枚舉類對(duì)象的屬性public String getSeasonName() {return seasonName;}public String getSeasonDesc() {return seasonDesc;}//4.其他訴求1：提供toString()@Overridepublic String toString() {return "Season1{" +"seasonName='" + seasonName + '\'' +", seasonDesc='" + seasonDesc + '\'' +'}';}
     }
     

2. Enum類中常用的方法

   • values()：返回枚舉類型的對(duì)象數(shù)組。該方法可以很方便地遍歷所有的枚舉值。
   • valueOf(String str)：返回枚舉類中對(duì)象名str的對(duì)象，如果沒有就拋異常。
   • toString()：返回當(dāng)前枚舉類對(duì)象常量名稱。

   Season1 summer = Season1.SUMMER;
   //toString():返回枚舉類對(duì)象的名稱
   System.out.println(summer.toString());
   //values():返回所有的枚舉類對(duì)象構(gòu)成的數(shù)組
   Season1[] values = Season1.values();
   for(int i = 0;i < values.length;i++){System.out.println(values[i]);
   }
   //valueOf(String objName):返回枚舉類中對(duì)象名是objName的對(duì)象。
   Season1 winter = Season1.valueOf("WINTER");
   System.out.println(winter);
   

3. 使用enum關(guān)鍵字定義的枚舉類實(shí)現(xiàn)接口的情況

   • 情況一：實(shí)現(xiàn)接口，在enum類中實(shí)現(xiàn)抽象方法。
   • 情況二：讓枚舉類的對(duì)象分別實(shí)現(xiàn)接口中的抽象方法。

8.2：注解

1. 理解注解(Annotation)

   • 從JDK 5.0開始，Java增加了對(duì)元數(shù)據(jù)MetaData的支持，也就是Annotation(注解)。
   • Annotation其實(shí)就是代碼里的特殊標(biāo)記，這些標(biāo)記可以在編譯，類加載，運(yùn)行時(shí)被讀取，并執(zhí)行相應(yīng)的處理。通過使用Annotation，程序員可以在不改變?cè)羞壿嫷那闆r下，在源文件中嵌入一些補(bǔ)充信息。

2. 注解實(shí)例

   • @Override：限定重寫父類方法，該注解只能用于方法。

     class Person{private String name;private int age;public Person() {}public Person(String name, int age) {this.name = name;this.age = age;}public void walk() {System.out.println("人走路");}
     }class Student extends Person{@Overridepublic void walk() {System.out.println("學(xué)生走路");}
     }
     

   • @Deprecated：用于表示所修飾的元素(類，方法等)已過時(shí)。通常是因?yàn)樗揎椀慕Y(jié)構(gòu)危險(xiǎn)或存在更好的選擇。

     @Deprecated
     public Date(int year, int month, int date) {this(year, month, date, 0, 0, 0);
     }
     

   • @SuppressWarnings：抑制編譯器警告。

     @SuppressWarnings("unused")
     int num = 10;
     @SuppressWarnings({"unused", "rawtypes"})
     ArrayList list = new ArrayList();
     

3. 自定義Annotation

   • 注解類型聲明為：@interface。
   • 自定義注解自動(dòng)繼承了java.lang.annotation.Annotation接口。
   • 注解的成員變量在Annotation定義中以無參數(shù)方法的形式來聲明。其方法名和返回值定義了該成員的名字和類型。我們稱為配置參數(shù)。類型只能是八種基本數(shù)據(jù)類型、String、Class、enum、Annotation類型。
   • 內(nèi)部定義成員，通常使用value表示。
   • 可以指定成員的默認(rèn)值，使用default定義。
   • 如果定義的注解含有配置參數(shù)，那么使用時(shí)必須指定參數(shù)值，除非它有默認(rèn)值。格式是參數(shù)名 = 參數(shù)值，如果只有一個(gè)參數(shù)成員，且名稱為value，可以省略value=。
   • 如果自定義注解沒有成員，表名是一個(gè)標(biāo)識(shí)作用。

   public @interface MyAnnotation {String value() default "hello";
   }
   

   注意：自定義注解必須配上注解的信息處理流程才有意義。

4. JDK中的元注解

   • JDK的元Annoation用于修飾其他Annotation定義。

   • JDK 5.0提供了4個(gè)標(biāo)準(zhǔn)的meta-annontation類型，分別是：

     1. Retention

        ? 只能用于修飾一個(gè)Annotation定義，用于指定該Annotation的生命周期，@Rentention包含一個(gè)RetentionPolicy類型的成員變量，使用@Rentention時(shí)必須為該value成員變量指定值：

        • RetentionPolicy.COURCE：在源文件中有效(即源文件保留)，編譯器直接丟棄這種策略的注釋。
        • RetentionPolicy.CLASS：在class文件中有效(即class保留)，當(dāng)運(yùn)行Java程序時(shí)，不會(huì)保留注解。這是默認(rèn)值。
        • RetentionPolicy.RUNTIME：在運(yùn)行時(shí)有效(即運(yùn)行時(shí)保留)，當(dāng)運(yùn)行Java程序時(shí)，JVM會(huì)保留注釋。程序可以通過反射獲取該注釋。

     2. Target

        ? 用于修飾Annotation定義，用于指定被修飾的Annotation能用于修飾哪些程序元素。@Target也包含一個(gè)名為value的成員變量。
        

     3. Documented

        ? 用于指定被該元Annotation修飾的Annotation類將被javadoc工具提取成文檔。默認(rèn)情況下，javadoc是不包括注解的。

        ? 定義為Documented的注解必須設(shè)置Retention值為RUNTIME。

     4. Inherited

        ? 被它修飾的Annotation將具有繼承性。如果某個(gè)類使用了被@Inherited修飾的Annotation，則其子類將自動(dòng)具有該注解。

5. JDK 8中注解的新特性

   • 可重復(fù)注解

     1. 在MyAnnotation上聲明@Repeatable，成員值為MyAnnotations.class
     2. MyAnnotation的Target和Retention等元注解與MyAnnotations相同

     @Inherited
     @Repeatable(MyAnnotations.class)
     @Retention(RetentionPolicy.RUNTIME)
     @Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE,TYPE_PARAMETER,TYPE_USE})
     public @interface MyAnnotation {String value() default "hello";
     }
     

     @Inherited
     @Retention(RetentionPolicy.RUNTIME)
     @Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE,TYPE_PARAMETER,TYPE_USE})
     public @interface MyAnnotations {MyAnnotation[] value();
     }
     

     @MyAnnotation(value = "hi")
     @MyAnnotation(value = "abc")
     class Person{
     }
     

   • 類型注解

     1. ElementType.TYPE_RARAMETER：表示該注解能寫在類型變量的聲明語句中。
     2. ElementType.TYPE_USE：表示該注解能寫在使用類型的任何語句中。