枚举和注解

枚举和注解

枚举

• 枚举介绍

  1. 枚举对应英文(enumeration,简写enum)
  2. 枚举是一组常量的集合
  3. 可以这样理解：枚举属于一种特殊的类，里面包含了一组有限的特定的对象

• 枚举的二种实现方式

  1. 自定义类实现枚举
  2. 使用enum关键字实现枚举

自定义类实现枚举

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

//自定义实现枚举
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 AUTUMN = new Season("秋天", "凉爽");
    public static final Season SYMMER = 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;
    }

    @Override
    public String toString() {
        return "Season{" +
                "name='" + name + '\'' +
                ", desc='" + desc + '\'' +
                '}';
    }
}
 public static void main(String[] args) {
        System.out.println(Season.AUTUMN);
        System.out.println(Season.SPRING);
    }

• 小结：进行自定义类实现枚举，有如下特点：
  1. 构造器私有化
  2. 本类内部创建一组对象
  3. 对外暴露对象(通过为对象添加public final static修饰符)
  4. 可以提供get方法，但是不要提供set

enum关键字实现枚举

//enum实现枚举
enum  Season {
    //1.使用关键字enum替代class
    //2. public static final Season SPRING = new Season("春天", "温暖")直接使用
    //SPRING("春天", "温暖") 解读：常量名(实参列表)
    //3.如果有多个常量(对象)，使用逗号间隔即可
    //4.如果使用enum来实现枚举，要求将定义常量对象，写在前面
    SPRING("春天", "温暖"),WINTER("冬天", "寒冷"),AUTUMN("秋天", "凉爽"),SYMMER("夏天", "炎热");
    private String name;//季节名
    private String desc;//描述

    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 + '\'' +
                '}';
    }
}

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

enum常用方法说明

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

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

public static void main(String[] args) {
        //创建Season枚举类对象
        Season autumn = Season.AUTUMN;
        //输出枚举对象的属性信息
        System.out.println(autumn.toString());
        //输出枚举对象的名字
        System.out.println(autumn.name());
        //输出的是该枚举对象的次序/编号，从0开始编号
        //AUTUMN枚举对象是第三个，因此输出2
        System.out.println(autumn.ordinal());
        //从反编译可以看到values方法，返回Season数组
        //含有定义的所有枚举对象
        Season[] values = Season.values();
        for (Season value : values) {//增强for
            System.out.println(value);
        }
        //valueOf：将字符串转换成枚举对象，要求字符串必须为已有的常量名，否则报异常！
        //1.根据你输入“AUTUMN”到Season枚举对象去查找
        //2.如果找到了，就返回，如果没有找到就报错
        Season autumn1 = Season.valueOf("AUTUMN");
        System.out.println(autumn1);
        //compareTo：比较两个枚举常量，比较的就是位置号！
        //1.就是把两个枚举对象编号比较
        //2.编号相减
        System.out.println(Season.AUTUMN.compareTo(Season.SPRING));
    }

• enum实现接口
  1. 使用enum关键字后，就不能再继承其他类了，因为enum会隐式继承Enum，而Java是单继承继承
  2. 枚举类和普通类一样，可以实现接口

注解

• 注解的理解

  1. 注解(Annotation)也称为元数据(Metadata)，用于修饰解释包、类、方法、属性、构造器、局部变量等数据信息
  2. 和注释一样，注解不影响程序逻辑，但注解可以被编译或运行，相当于嵌入在代码中的补充信息
  3. 在JavaSE中，注解的使用目的比较简单，例如标记过时的功能，忽略警告等。在Java中注解占据了更重要的角色，例如用来配置应用程序的任何切面，代替JavaEE旧版中所遗留的繁冗代码和XML配置等

• 基本的Annotation介绍

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

• 三个基本的Annotation：
  1. @Override：限定某个方法，是重写父类方法，该注解只能用于方法
  2. @Deprecated：用于表示某个程序元素(类，方法等)已过时
  3. @SuppressWarnings：抑制编译器警告

Override

• Override使用说明
  1. @Override表示指定重写父类的方法(从编译层面验证)，如果父类没有该方法，则会报错
  2. 如果不写@Override注解，而父类仍有该方法，仍然构成重写
  3. @Override只能修饰方法，不能修饰其他类，包，属性等等
  4. 查看@Override注解源码为@Target(ElementType.METHOD)，说明只能修饰方法
  5. @Target是修饰注解的注解，称为元注解

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

Deprecated

• Deprecated使用说明
  1. 用于表示某个程序元素(类，方法等)已经过时
  2. 可以修饰方法，类，字段，包，参数等等
  3. @Deprecated的作用可以做到新旧版本的兼容和过渡

//1.@Deprecated修饰某个元素，表示该元素已经过时
//2.即不在推荐使用，但是仍然可以使用
//3.可以修饰方法，类，字段，包，参数等等
//4.可以做版本升级过渡使用
@Deprecated
class A{
    @Deprecated
    public int n1=10;
    @Deprecated
    public void i(){

    }
}
public static void main(String[] args) {
        A a = new A();
        a.n1;
        System.out.println(a.i(););
    }

SuppressWarnings

• SuppressWarnings说明各种值
  1. all抑制所有警告
  2. unchecked是忽略没有检查的警告
  3. rawtypes是忽略没有指定泛型的警告(传参时没有指定泛型的警告错误)
  4. unused是忽略没有使用某个变量的警告错误
  5. 生成@SuppressWarnings时，不用背，直接点击左侧的黄色提示，就可以选择(注意可以指定生成的位置)

//1.当我们不希望看到这些警告的时候，可以使用SuppressWarnings注解来抑制警告信息
    //2.在{""}中，可以写入你希望抑制(不显示)警告信息
    //3.抑制警告类型有很多
    //4.关于SuppressWarnings作用范围是和你放置的位置相关
    //比如放置在main方法，那么抑制警告的范围就是main
    //通常我们可以放置具体的语句，方法，类
    @SuppressWarnings("all")
    public static void main(String[] args) {
        List<String> list=new ArrayList<>();
        list.add("");
        list.add("");
        list.add("");
        System.out.println(list.get(1));
    }

元注解(了解)

• 元注解的基本介绍

JDK的元Annotation用于修饰其他Annotation

• 元注解的种类(使用不多，了解，不用深入研究)
  1. Retention//指定注解的作用范围，三种SOURCE,CLASS,RUNTIME
  2. Target//指定注解可以在哪些地方使用
  3. Documented//指定该注解是否会在javadoc体现
  4. Inherited//子类会继承父类注解