day31_枚舉類丶註解

枚舉類

什麼是枚舉類？

類的對象只有有限個，確定的。

星期：Monday(星期一)、......、Sunday(星期天)
性別：Man(男)、Woman(女)
季節：Spring(春節)......Winter(冬天)
支付方式：Cash（現金）、WeChatPay（微信）、Alipay(支付寶)、BankCard(銀行卡)、CreditCard(信用卡)
就職狀態：Busy、Free、Vocation、Dimission
訂單狀態：Nonpayment（未付款）、Paid（已付款）、Delivered（已發貨）、 Return（退貨）、Checked（已確認）Fulfilled（已配貨）、
線程狀態：創建、就緒、運行、阻塞、死亡

應用場景

當需要定義一組常量時，強烈建議使用枚舉類

枚舉類的實現

JDK1.5之前需要自定義枚舉類
DK 1.5 新增的 enum 關鍵字用於定義枚舉類
若枚舉只有一個對象, 則可以作爲一種單例模式的實現方式。

枚舉類的屬性

枚舉類對象的屬性不應允許被改動, 所以應該使用 private final 修飾
枚舉類的使用 private final 修飾的屬性應該在構造器中爲其賦值
若枚舉類顯式的定義了帶參數的構造器, 則在列出枚舉值時也必須對應的傳入參數

定義枚舉類步驟：

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

示例：

//自定義枚舉類
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.其他訴求1：獲取枚舉類對象的屬性
    public String getSeasonName() {
        return seasonName;
    }

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

JDK1.5之後定義註解

package com.atguigu.java;


public class SeasonTest1 {
    public static void main(String[] args) {
        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("****************");
        Thread.State[] values1 = Thread.State.values();
        for (int i = 0; i < values1.length; i++) {
            System.out.println(values1[i]);
        }

        //valueOf(String objName):返回枚舉類中對象名是objName的對象。
        Season1 winter = Season1.valueOf("WINTER");
        //如果沒有objName的枚舉類對象，則拋異常：IllegalArgumentException
//        Season1 winter = Season1.valueOf("WINTER1");
        System.out.println(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;

    //2.私有化類的構造器,並給對象屬性賦值

    private Season1(String seasonName,String seasonDesc){
        this.seasonName = seasonName;
        this.seasonDesc = seasonDesc;
    }

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

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


//    @Override
//    public void show() {
//        System.out.println("這是一個季節");
//    }
}

使用說明

使用 enum 定義的枚舉類默認繼承了 java.lang.Enum類，因此不能再繼承其他類
枚舉類的構造器只能使用 private 權限修飾符
枚舉類的所有實例必須在枚舉類中顯式列出(, 分隔 ; 結尾)。列出的實例系統會自動添加 public static final 修飾
必須在枚舉類的第一行聲明枚舉類對象
JDK 1.5 中可以在 switch 表達式中使用Enum定義的枚舉類的對象作爲表達式, case 子句可以直接使用枚舉值的名字, 無需添加枚舉類作爲限定。

Enum類的主要方法：

values()方法：返回枚舉類型的對象數組。該方法可以很方便地遍歷所有的枚舉值。
valueOf(String str)：可以把一個字符串轉爲對應的枚舉類對象。要求字符串必須是枚舉類對象的“名字”。如不是，會有運行時異常： IllegalArgumentException。
toString()：返回當前枚舉類對象常量的名稱

注意：

和普通 Java 類一樣，枚舉類可以實現一個或多個接口
若每個枚舉值在調用實現的接口方法呈現相同的行爲方式，則只要統一實現該方法即可。
若需要每個枚舉值在調用實現的接口方法呈現出不同的行爲方式, 則可以讓每個枚舉值分別來實現該方法

註解(Annotation)

註解 (Annotation) 概述

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

使用註解

使用 Annotation 時要在其前面增加 @ 符號, 並把該 Annotation 當成一個修飾符使用。用於修飾它支持的程序元素

示例一：生成文檔相關的註解

@author 標明開發該類模塊的作者，多個作者之間使用,分割
@version 標明該類模塊的版本
@see 參考轉向，也就是相關主題
@since 從哪個版本開始增加的
@param 對方法中某參數的說明，如果沒有參數就不能寫
@return 對方法返回值的說明，如果方法的返回值類型是void就不能寫

@exception 對方法可能拋出的異常進行說明，如果方法沒有用throws顯式拋出的異常就不能寫其中

@param @return 和 @exception 這三個標記都是隻用於方法的。
@param的格式要求：@param 形參名形參類型形參說明
@return 的格式要求：@return 返回值類型返回值說明
@exception的格式要求：@exception 異常類型異常說明
@param和@exception可以並列多個

示例二：在編譯時進行格式檢查(JDK內置的三個基本註解)

@Override: 限定重寫父類方法, 該註解只能用於方法
@Deprecated: 用於表示所修飾的元素(類, 方法等)已過時。通常是因爲所修飾的結構危險或存在更好的選擇
@SuppressWarnings: 抑制編譯器警告

示例三：跟蹤代碼依賴性，實現替代配置文件功能

Servlet3.0提供了註解(annotation),使得不再需要在web.xml文件中進行Servlet的部署
spring框架中關於“事務”的管理

自定義 Annotation

定義新的 Annotation 類型使用 @interface 關鍵字
自定義註解自動繼承了java.lang.annotation.Annotation接口
Annotation 的成員變量在 Annotation 定義中以無參數方法的形式來聲明。其方法名和返回值定義了該成員的名字和類型。我們稱爲配置參數。類型只能是八種基本數據類型、String類型、Class類型、enum類型、Annotation類型、 以上所有類型的數組。
可以在定義 Annotation 的成員變量時爲其指定初始值, 指定成員變量的初始值可使用 default 關鍵字
如果只有一個參數成員，建議使用參數名爲value
如果定義的註解含有配置參數，那麼使用時必須指定參數值，除非它有默認值。格式是“參數名 = 參數值”，如果只有一個參數成員，且名稱爲value，可以省略“value=”
沒有成員定義的 Annotation 稱爲標記; 包含成員變量的 Annotation 稱爲元數據 Annotation

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

JDK 中的元註解

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

Retention
Target
Documented
Inherited

@Retention: 只能用於修飾一個 Annotation 定義, 用於指定該 Annotation 的生命週期, @Rentention 包含一個 RetentionPolicy 類型的成員變量, 使用 @Rentention 時必須爲該 value 成員變量指定值:

RetentionPolicy.SOURCE:在源文件中有效（即源文件保留），編譯器直接丟棄這種策略的註釋
RetentionPolicy.CLASS:在class文件中有效（即class保留），當運行 Java 程序時, JVM 不會保留註解。這是默認值
RetentionPolicy.RUNTIME:在運行時有效（即運行時保留），當運行 Java 程序時, JVM 會 保留註釋。程序可以通過反射獲取該註釋。

@Target: 用於修飾 Annotation 定義, 用於指定被修飾的 Annotation 能用於修飾哪些程序元素。 @Target 也包含一個名爲 value 的成員變量。

@Documented: 用於指定被該元 Annotation 修飾的 Annotation 類將被 javadoc 工具提取成文檔。默認情況下，javadoc是不包括註解的。定義爲Documented的註解必須設置Retention值爲RUNTIME。

@Inherited: 被它修飾的 Annotation 將具有繼承性。如果某個類使用了被 @Inherited 修飾的 Annotation, 則其子類將自動具有該註解。比如：如果把標有@Inherited註解的自定義的註解標註在類級別上，子類則可以繼承父類類級別的註解實際應用中，使用較少

day31_枚舉類丶註解

枚舉類

JDK1.5之後定義註解

註解(Annotation)

使用註解

自定義 Annotation

JDK 中的元註解

微服務實踐k8s&dapr開發部署實驗（2）狀態管理

Win10 LTSC 2019 安裝後的一些步驟

Python 潮流週刊#52：Python 處理 Excel 的資源

day49_Cookie丶Session

day50_JSP

day52_EL丶JSTL

day47_HTTP請求消息丶Request對象

day45_XML

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結