Java枚舉類和注解梳理

本文轉載自查看原文 2019-10-12 17:05 1126 Java

1. 枚舉類

1. 枚舉類的使用

枚舉類的理解：類的對象只有有限個，確定的。我們稱此類為枚舉類。
當需要定義一組常量時，強烈建議使用枚舉類。
如果枚舉類中只有一個對象，則可以作為單例模式的實現方式。

1.2 如何定義枚舉類

方式一：JDK1.5之前，自定義枚舉類；
方式二：JDK1.5之后，可以使用enum關鍵詞定義枚舉類。

自定義枚舉類的三個原則：

私有化類的構造器，保證不能再類的外部創建其對象；
在類的內部創建類枚舉類的實例。聲明為：public static final
對象如果有實例變量，應該聲明為private final，並在構造器中初始化。

自定義枚舉類舉例：SeasonTest類

package com.atguigi.java;

public class SeasonTest {
    public static void main(String[] args) {
        Season spring = Season.SPRING;
        System.out.println(spring); // Season{seasonName='春天', seasonDesc='春暖花開'}
    }
}

// 自定義枚舉類
class Season{
    // 1. 聲明Season對象的屬性：private final修飾
    private final String seasonName;
    private final String seasonDesc;

    // 2. 私有化類的構造器，並給對象屬性賦值
    private Season(String seasonName, String seasonDesc){
        this.seasonName = seasonName;
        this.seasonDesc = seasonDesc;
    }

    // 3. 提供當前枚舉類的多個對象：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. 其他訴求：獲取枚舉類對象的屬性
    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }
    // 5. 其他訴求：提供toString
    @Override
    public String toString() {
        return "Season{" +
                "seasonName='" + seasonName + '\'' +
                ", seasonDesc='" + seasonDesc + '\'' +
                '}';
    }
}

1.3 使用enum關鍵字定義枚舉類

package com.atguigi.java;

/**
 * 使用enum關鍵字定義枚舉類
 * 說明：定義的枚舉類默認繼承於java.lang.Enum類
 */
public class SeasonTest1 {
    public static void main(String[] args) {
        Season1 summer = Season1.SUMMER;
        System.out.println(summer); // Season1{seasonName='夏天', seasonDesc='夏日炎炎'}

        System.out.println(Season1.class.getSuperclass()); // class java.lang.Enum
    }
}

//使用enum關鍵字枚舉類
enum Season1{
    // 1.提供當前枚舉類的對象，多個對象之間用","隔開，末尾對象";"結束
    SPRING ("春天", "春暖花開"),
    SUMMER("夏天", "夏日炎炎"),
    AUTUMN("秋天", "秋高氣爽"),
    WINTER("冬天", "冰天雪地");

    // 2. 聲明Season對象的屬性：private final修飾
    private final String seasonName;
    private final String seasonDesc;


    // 3. 私有化類的構造器，並給對象屬性賦值
    private Season1(String seasonName, String seasonDesc){
        this.seasonName = seasonName;
        this.seasonDesc = seasonDesc;
    }

    // 4. 其他訴求：獲取枚舉類對象的屬性
    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }
    // 5. 其他訴求：提供toString

    @Override
    public String toString() {
        return "Season1{" +
                "seasonName='" + seasonName + '\'' +
                ", seasonDesc='" + seasonDesc + '\'' +
                '}';
    }
}

使用enum關鍵字定義枚舉類時，如果沒有重寫toString()，那么下面的代碼執行的是結果是SUMMER。
```
Season1 summer = Season1.SUMMER;
System.out.println(summer);
```

1.4 Enum類的常用方法

 Season1 summer = Season1.SUMMER;

//toString():返回枚舉類對象的名稱
System.out.println(summer.toString());

System.out.println("****************");

//values():返回所有的枚舉類對象構成的數組
Season1[] values = Season1.values();
for(int i = 0;i < values.length;i++){
    System.out.println(values[i]);
    //values[i].show();
}
System.out.println("****************");

//valueOf(String objName):返回枚舉類中對象名是objName的對象。
Season1 winter = Season1.valueOf("WINTER"); // Season1{seasonName='冬天', seasonDesc='冰天雪地'}
//如果沒有objName的枚舉類對象，則拋異常：IllegalArgumentException
//        Season1 winter = Season1.valueOf("WINTER1");
System.out.println(winter);

1.5 枚舉類實現接口

情況一：實現接口，在enum類中實現抽象方法，跟普通的實現接口方式一樣。
情況二：實現接口后，每個對象重寫方法，從而實現每個對象調用同一方法產生不同結果。

定義接口Info，接口中定義方法show()。枚舉類中的每個對象實現重寫show()方法。實現的結果是不同的枚舉類對象電泳同一個方法得到不同結果。

package com.atguigi.java;

/**
 * 使用enum關鍵字定義枚舉類
 * 說明：定義的枚舉類默認繼承於java.lang.Enum類
 */
public class SeasonTest1 {
    public static void main(String[] args) {
        Season1 summer = Season1.SUMMER;
        summer.show(); // 寧夏
        Season1 winter = Season1.valueOf("WINTER");
        winter.show(); // 大約在冬季
    }
}

interface Info{
    void show();
}

//使用enum關鍵字枚舉類
enum Season1 implements Info{
    // 1.提供當前枚舉類的對象，多個對象之間用","隔開，末尾對象";"結束
    SPRING ("春天", "春暖花開"){
        @Override
        public void show() {
            System.out.println("春天在哪里？");
        }
    },
    SUMMER("夏天", "夏日炎炎"){
        @Override
        public void show() {
            System.out.println("寧夏");
        }
    },
    AUTUMN("秋天", "秋高氣爽"){
        @Override
        public void show() {
            System.out.println("秋天不回來");
        }
    },
    WINTER("冬天", "冰天雪地"){
        @Override
        public void show() {
            System.out.println("大約在冬季");
        }
    };

    // 2. 聲明Season對象的屬性：private final修飾
    private final String seasonName;
    private final String seasonDesc;


    // 3. 私有化類的構造器，並給對象屬性賦值
    private Season1(String seasonName, String seasonDesc){
        this.seasonName = seasonName;
        this.seasonDesc = seasonDesc;
    }

    // 4. 其他訴求：獲取枚舉類對象的屬性
    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }
    // 5. 其他訴求：提供toString

    @Override
    public String toString() {
        return "Season1{" +
                "seasonName='" + seasonName + '\'' +
                ", seasonDesc='" + seasonDesc + '\'' +
                '}';
    }
}

2. 注解

2.1 注解的理解

從JDK5.0開始，Java增加了對元數據（MetaData）的支持，也就是Annotation（注解）。
Annotation其實就是代碼里的特殊標記，這些標記可以在編譯，類加載，運行時被讀取，並執行相應的處理。通過使用Annotation，程序員可以在不改變原有邏輯的情況下，，在源文件中嵌入一些補充信息。代碼分析工具、開發工具和部署工具可以通過這些補充信息進行驗證或者進行部署。
Annotation可以想修飾符一樣被使用，可用於修飾包，類，構造器，方法，成員變量，參數，局部變量的聲明，這些信息被保存在Annotation的name = value對中。
在JavaSE中，注解的使用目的比較簡單，例如標記過時的功能，忽略警告等。在JavaEE/Android中注解占據了更重要的角色，例如用來配置應用程序的任何切面，代替JavaEE中舊版中所遺留的繁冗代碼和XML配置等。
框架 = 注解 + 反射 + 設計模式

2.2 常用Annotation使用

生成文檔相關注解；
在編譯時進行格式檢查（JDK內置的三個基本注解）
- @Overrive：限定重寫父類的方法，該注解只能用於方法；
- @Deprecated：用於表示所修飾的元素（類、方法）已過時，通常是因為所修飾的結構危險或存在更好的選擇；
- @SuppressWarning：抑制編譯器警告。
跟蹤代碼依賴性，實現替代配置文件的功能

Servlet3.0提供了注解，使得不在需要在web.xml文件中進行Servlet得部署。

Spring框架中關於“事務”的管理

2.3 如何自定義注解

定義新的Annotation類型使用@interface關鍵字
自定義注解自動實現了java.lang.annotation.Annotation接口；
Annotation的成員變量在Annotation定義中以無參數方法的形式來聲明。其方法名和返回值定義了該成員的名稱和類型；
可以在定義Annotation的成員變量時為其指定初始值，指定成員變量的初始值可以是使用default關鍵字；
如果只有一個參數成員，建議使用參數名為value；
沒有成員定義的Annotation稱為標記；包含成員變量的Annotation稱為元數據Annotation。
注意：自定義注解必須配上注解的信息處理流程(使用反射)才有意義。

package java.atguigu.java1;

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

2.4 JDK中的元注解

JDK中的元Annotation用於修飾其他Annotation定義，JDK5.0中提供了4個標准的meta-annotation類型，分別是：

Retention、Target、Documented、Inherited。

@Retention：只能用於修飾一個Annotation定義，用於指定該Annotation的生命周期，@Retention包含一個RetentionPolicy類型的成員變量，使用這個注解時必須為該value成員變量指定值：
- RetentionPolicy.SOURCE：在源文件中有效（即源文件保留），編譯器直接丟棄這種策略的注解；
- RetentionPolicy.CLASS：在class文件中有效（即class保留），當運行程序時，JVM不會保留注解。這是默認值
- RetentionPolicy.RUNTIME：在運行時有效（即運行時保留），當運行 Java程序時，JVM會保留注解。程序通過反射獲取該注解。
```
public enum RetentionPolicy{
	SOURCE,
	CLASS,
	RUNTIME
}
```
@Target：用於修飾Annotation定義，用於指定被修飾的Annotation能用於修飾哪些程序元素。@Target也包含一個名為value的成員變量。

2.5 JDK8中注解的新特性

Java8對注解處理提供了兩點改進：可重復的注解和可用於類型的注解。此外，反射也得到了加強，在Java8中能夠得到方法參數的名稱。這會簡化標注在方法參數上的注解。

可重復注解示例：

類型注解
- JDK8之后，關於元注解@Target的參數類型ElementType枚舉值多了兩個：TYPE_PARAMETER，TYPE_USE。
- 在Java8之前，注解只能在聲明的地方使用，Java8開始，注解可以應用在任何地方。
- ElementType.TYPE_PARAMETER表示該注解能寫在類型變量的聲明語句中（如：泛型聲明）。
- ElementType.TYPE_USE表示該注解能寫在使用類型的任何語句中。

public class TestTypeDefine<@TypeDefine() U> {
private U u;
public <@TypeDefine() T> void test(T t){
}
}
@Target({ElementType.TYPE_PARAMETER})
@interface TypeDefine{
}

@MyAnnotation
public class AnnotationTest<U> {
    @MyAnnotation
    private String name;
    public static void main(String[] args) {
        AnnotationTest<@MyAnnotation String> t = null;
        int a = (@MyAnnotation int) 2L;
        @MyAnnotation
        int b = 10;
    }
    public static <@MyAnnotation T> void method(T t) {
    }
    public static void test(@MyAnnotation String arg) throws @MyAnnotation Exception {
    }
}
@Target(ElementType.TYPE_USE)
@interface MyAnnotation {
}

免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。

猜您在找 【Java】枚舉類和注解 Java之枚舉類和注解 Java-枚舉類與注解 Java枚舉類、注解和反射 Java枚舉類與注解詳解——一篇文章讀懂枚舉類與注解詳 Java基礎——枚舉與注解 java枚舉類（enum） Java 枚舉和類的區別 java枚舉類 java中的枚舉類