JAVA SE -- 第十天

（全部来自“韩顺平教育”）

一、枚举（enumeration，简写enum）

枚举是一组常量的集合

1、实现方式

        a.自定义类实现枚举

        b.使用enum关键字实现枚举

二、自定义类实现枚举

1、注意事项

①不需要提供setXxx方法，因为枚举对象通常为只读

②对枚举对象/属性使用 final + static 共同修饰，实现底层优化

③枚举对象名通常使用全部大写，常量的命名规范

④枚举对象根据需要，也可以有多个属性

2、 举例

//自定义枚举类
class Season{
    private String name;
    private String desc;//描述

    //定义了四个对象，固定
    public static final Season SPRING = new Season("春天","温暖");
    public static final Season WINTER = new Season("冬天","寒冷");
    public static final Season AUTUNM = new Season("秋天","凉爽");
    public static final Season SUMMER = new Season("夏天","炎热");

    //1.将构造器私有化，目的：防止直接new
    //2.去掉setXxx方法，防止属性被修改
    //3.在Season内部，直接创建固定的对象
    //4.优化，可以加入final修饰符
    private Season(String name, String desc){
        this.name = name;
        this.desc = desc;
    }

    public String getName(){
        return name;
    }

    public String getDesc(){
        return desc;
    }

}

 3、小结

进行自定义类实现枚举，有如下特点：

①构造器私有化

②本类内部创建一组对象

③对外暴露对象（通过为对象添加public final static修饰符）

④可以提供get方法，但是不要提供set

三、enum关键字是实现枚举

1、举例

//enum关键字实现枚举类
enum Season2{
    private String name;
    private String desc;//描述

    //public static final Season SPRING = new Season("春天","温暖");
    //public static final Season WINTER = new Season("冬天","寒冷");
    //public static final Season AUTUNM = new Season("秋天","凉爽");
    //public static final Season SUMMER = new Season("夏天","炎热");
    //如果使用了enum来实现枚举类
    //1.使用关键字enum替代class
    //2.public static final Season SPRING = new Season("春天","温暖")直接使用SPRING("春            
    //  天","温暖")   解读  常量名（实参列表）
    //3.如果有多个常量（对象），使用，号间隔即可
    //4.如果使用enum来实现枚举，要求将定义常量对象，写在前面
    //5.如果使用的是无参构造器，创建常量对象，则可以省略()
    SPRING("春天","温暖"),WINTER("冬天","寒冷"),AUTUNM("秋天","凉爽"),SUMMER("夏天","炎热");

    private String name;
    private String desc;//描述

    private Season2(){//无参构造器
    
    }

    private Season2(String name, String desc){
        this.name = name;
        this.desc = desc;
    }

    public String getName(){
        return name;
    }

    public String getDesc(){
        return desc;
    }

}

2、注意事项

①使用 enum关键字开发一个枚举类时，默认会继承Enum类，而且是一个final类

②传统的public static final Season SPRING = new Season("春天","温暖")；简化成SPRING("春天","温暖")，这里必须知道，它调用的是哪个构造器

③如果使用无参构造器创建枚举对象，则实参列表和小括号都可以省略

④当有多个枚举对象时，使用，间隔，最后有一个分号结尾

⑤枚举对象必须放在枚举类的行首

3、enum常用方法说明

说明：使用关键字enum时，会隐式继承Enum类，所以可以使用类相关的方法。【源码定义如下】

public abstract class Enum>
    implements Comparable,Serializable{
}

 1) toString:Enum 类已经重写过了，返回的是当前对象名,子类可以重写该方法，用于返回对象的属性信息
2) name：返回当前对象名（常量名），子类中不能重写
3) ordinal：返回当前对象的位置号，默认从 0 开始
4) values：返回当前枚举类中所有的常量
5) valueOf：将字符串转换成枚举对象，要求字符串必须为已有的常量名，否则报异常！
6) compareTo：比较两个枚举常量，比较的就是编号！

 4、enum实现接口

①使用enum关键字后，就不能再继承其他类了，因为enum会饮食继承Enum，而Java是单继承机制

②枚举类和普通类一样，可以实现接口，形式如下：

enum 类名 implements 接口1，接口2{}

四、注解

1、注解的理解

①注解（Annotation）也被称为元数据（Metadata），用于修饰解释 包、类、方法、属性、构造器、局部变量等数据信息

②和注释一样，注解不影响程序逻辑，但注解可以被编译或运行，相当于嵌入在代码中的补充信息

③在JavaSE中，注解的使用目的比较简单，例如标记过时的功能，忽略警告等。在JavaSE中注解占据了更重要的角色，例如用来配置应用程序的任何切面，代替Java EE旧版中所遗留的繁冗代码和XML配置等。

 2、基本的Annotation介绍

使用Annotation时要在其前面增加@符号，并把该Annotation当成一个修饰符使用。用于修饰它支持的程序元素

三个基本的Annotation：

①@Override：限定某个方法，是重写父类方法，该注解只能用于方法

②@Deprecated：用于表示某个程序元素（类，方法等）已过时

③@SuppressWarnings：抑制编译器警告

3、基本的Annotation应用案例

①@Override注解

 使用说明：

a.@Override表示指定重写父类的方法，，如果父类没有fly方法，则会报错

b.如果不写@Override注解，而父类仍有public void fly(){}，仍然构成重写

c.@Override只能修饰方法，不能修饰其它类，包，属性等等

d.查看@Override注解源码为@Target(ElementType.METHOD)，说明只能修饰方法

e.@Target是修饰注解的注解，称为元注解

 ②@Deprecated注解

说明：

a.用于表示某个程序元素（类，方法等）已过时

b.可以修饰方法，类，字段，包，参数 等等

c.@Target(value={CONSTRUCTOR,FIELD,LOCAL_VARIABLE,METHOD,PACKAGE,PARAMETER,TYPE})

d.@Deprecated的作用可以做到新旧版本的兼容和过渡

 ③@SuppressWarnings

@SuppressWarnings({"xxx","xxx"....})

可以指定的警告类型：

all，抑制所有警告
boxing，抑制与封装/拆装作业相关的警告
cast，抑制与强制转型作业相关的警告
dep-ann，抑制与淘汰注释相关的警告
deprecation，抑制与淘汰的相关警告
fallthrough，抑制与 switch 陈述式中遗漏 break 相关的警告
finally，抑制与未传回 finally 区块相关的警告
hiding，抑制与隐藏变数的区域变数相关的警告
incomplete-switch，抑制与 switch 陈述式(enum case)中遗漏项目相关的警告
javadoc，抑制与 javadoc 相关的警告
nls，抑制与非 nls 字串文字相关的警告
null，抑制与空值分析相关的警告
rawtypes，抑制与使用 raw 类型相关的警告
resource，抑制与使用 Closeable 类型的资源相关的警告
restriction，抑制与使用不建议或禁止参照相关的警告
serial，抑制与可序列化的类别遗漏 serialVersionUID 栏位相关的警告
static-access，抑制与静态存取不正确相关的警告
static-method，抑制与可能宣告为 static 的方法相关的警告
super，抑制与置换方法相关但不含 super 呼叫的警告
synthetic-access，抑制与内部类别的存取未最佳化相关的警告
sync-override，抑制因为置换同步方法而遗漏同步化的警告
unchecked，抑制与未检查的作业相关的警告
unqualified-field-access，抑制与栏位存取不合格相关的警告
unused，抑制与未用的程式码及停用的程式码相关的警告

 

五、JDK的元Annotation（了解即可）

 1、基本介绍

JDK的元Annotation用于修饰其他Annotation

2、种类

①Retention    //指定注解的作用范围，三种SOURCE，CLASS，RUNTIME

②Target    //指定注解可以在哪些地方使用

③Documented     //指定该注解是否会在javadoc体现

④Inherited     //子类会继承父类注解

3、@Retention注解

说明：

只能用于修饰一个Annotation定义，用于指定该Annotation可以保留多长时间，@Retention

包含一个 RetentionPolicy类型的成员变量, 使用 @Rentention 时必须为该 value 成员变量指定值:
@Retention 的三种值
a.RetentionPolicy.SOURCE: 编译器使用后，直接丢弃这种策略的注释
b.RetentionPolicy.CLASS: 编译器将把注解记录在 class 文件中. 当运行 Java 程序时, JVM 不会保留注解。 这是默认值

c.RetentionPolicy.RUNTIME:编译器将把注解记录在 class 文件中. 当运行 Java 程序时, JVM 会保留注解. 程序可以通过反射获取该注解

4、@Target注解 

 5、@Documented注解

 6、@Inherited注解