11.枚举和注释

枚举类：

[枚：一个一个 举：例举，即把具体的对象一个一个例举出来]

1）枚举对应英文(enumeration,简写enum)

2)枚举是一组常量的集合。

3)可以这样理解：枚举属于一种特殊的类，里面只包含一组有限的特定的对象。

枚举的二种实现方式

1）自定义类实现枚举

2）使用enum关键字实现枚举

自定义类实现枚举

1. 不需要提供setXxx方法，因为枚举对象值通常为只读.
2. 对枚举对象/属性使用fianl+static共同修饰，实现底层优化。
3. 枚举对象名通常使用全部大写。常量的命名规范。
4. 枚举对象根据需要，也可以有多个属性

package com.hspedu.enum_;

public class Enumeration01 {
    public static void main(String[] args) {
        System.out.println(Season.SPRING);

    }
}
class Season{
    private String name;
    private String desc;
    public static  final Season SPRING = new Season("春天","温暖");
    private Season(String name,String desc){
        this.name=name;
        this.desc =desc;
    }
    public String getName(){
        return name;
    }

    public String getDesc(){
        return desc;
    }

    @Override
    public String toString() {
        return "Season{" +
                "name='" + name + '\'' +
                ", desc='" + desc + '\'' +
                '}';
    }
}

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

1）构造器私有化

2）本类内部创建一组对象

3）对外暴露对象（通过为对象添加publi fianl static修饰符）

4）可以提供get方法，但是不需提供set

enum关键字实现枚举

使用enum来实现前面的枚举案例.

package com.hspedu.enum_;

import javax.swing.*;


public class Enumeration02 {
    public static void main(String[] args) {
        System.out.println(Season.SPRING);

    }
}
enum Season2{

//    public static  final Season SPRING = new Season2("春天","温暖");
    //使用enum来实现枚举类
    //1.使用关键字enum替代class
    //2.public static final Season SPRING = new Season("春天","温暖")直接使用
    // SPRING("春天","温暖") 解读 常量名（实参列表）
    //3.如果有多个常量（对象），使用，号间隔即可
    //4.如果使用enum来实现枚举，要求将定义常量对象，写在前面

    SPRING("春天","温暖"),WINTER("冬天","寒冷");
    private String name;
    private String desc;
    private Season2(String name,String desc){
        this.name=name;
        this.desc =desc;
    }
    public String getName(){
        return name;
    }

    public String getDesc(){
        return desc;
    }

    @Override
    public String toString() {
        return "Season{" +
                "name='" + name + '\'' +
                ", desc='" + desc + '\'' +
                '}';
    }
}

• enum关键字实现枚举注意事项

1. 当我们使用enum关键字开发一个枚举类时，默认会继承Enum类，而且是一个final类
2. 传统的public static final Season2 SPRING =new Seanson2("春天","温暖");简化成SPRING("春天","温暖")，这里必须知道，它调用的是哪个构造器。
3. 如果使用无参构造器 创建 枚举对象，则实参列表和小括号都可以省略
4. 当有多个枚举对象时，使用,间隔，最后有一个分号结尾
5. 枚举对象必须放在枚举类的行首。

• enum常用方法说明

说明：使用关键字enum时，会隐式继承Enum类，这样我们就可以使用Enum类相关的方法

public abstract class Enum<E extends Enum<E>>

implements Comparable<E>,Serializable{

}

enum常用方法一览表

我们一起来举例说明enum常用的方法的使用。

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

package enum_;

public class EnumMethod {
    public static void main(String[] args) {
        //使用Season2 枚举类，来演示各种方法
        Season2 winter = Season2.WINTER;
        //输出枚举对象的名字
        System.out.println(winter.name());
        //ordianl() 输出的是该枚举对象的次序/编号，从0开始编号
        //AUTUMN枚举对象时第三个，因此输出 2
        System.out.println(winter.ordinal());
        //从反编译可以看出，values 方法，返回Season2[]
        //含有定义的所有枚举对象
        Season2[] values = Season2.values();
        for (Season2 season:values){//增强for循环
            System.out.println(season);

        }
        //valueOf:将字符串转换成枚举对象，要求字符串必须为已有的常量名，否则报异常
        Season2 autumn = Season2.valueOf("AUTUMN");
        System.out.println(autumn);
        //compareTo:比较两个枚举常量，比较的就是编号
        System.out.println(Season2.AUTUMN.compareTo(Season2.SUMMER));


    }
}

1）使用enum关键字后，就不能再继承其它类了，因为enum会隐式继承Enum,而Java是单继承机制

2）枚举类和普通类一样，可以实现接口，如下形式。

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

package enum_;


public class EnumDetail {
    public static void main(String[] args) {
        Music.CLASSMUSIC.playing();
    }
}
interface IPlaying{
    public void playing();
}
enum Music implements IPlaying{
    CLASSMUSIC;

    @Override
    public void playing() {
       System.out.println("乐器在演奏");
    }
}

注解

注解的理解

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

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

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

基本的Annotation介绍

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

三个基本的Annotation：

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

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

3）@SuppressWarnings：抑制编译器警告

• @Override 注解

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

补充说明: @interface的说明

@interface不是interface，是注解类 是jdk5.0之后加入的

package com.hspedu.annotation_;


public class Override_ {
    public static void main(String[] args) {

    }
}
class Father {
    public void fly(){
        System.out.println("Father fly...");
    }
}
class Son extends Father{
    //解读
    //1.@Override注解放在fly方法上，表示子类的fly方法时重写了父类的fly
    //2.这里如果没有写@Override还是重写了父类fly
    //3.如果你写了@Override注解，编译器就会去检查该方法是否是真的重写了父类的
    //  方法，如果的确重写了，则编译通过，如果没有构成重写，则编译错误
    //4.看看@Override的定义
    //解读 ：如果发现 @interface表示 一个注解类
    /*
    @Target(ElementType.METHOD)
    @Retention(RetentionPolicy.SOURCE)
    public @interface Override {
}
     */
    @Override //说明
    public void fly(){
        System.out.println("Son fly...");
    }
}

Override使用说明

1.@Override表示指定重写父类的方法（从编译层面验证），如果父类没有fly方法，则会报错

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

3.@Overide 只能修饰方法，不能修饰其他类，包，属性等等

4.产看@Override注解源码为@Target(ElementType.METHOD),说明只能修饰方法

5.@Target 是修饰注解的注解，称为元注解，记住这个概念

• @Deprecated 注解的案例

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