Java枚举与注解

枚举与注解

枚举

自定义枚举类

1. 构造器私有化
2. 本类内部创建一组对象
3. 对外暴露对象（public final static修饰符）
4. 可以提供get方法，但不要提供set方法

package com.hspedu.enum_;

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

//演示自定义枚举实现
class Season{
    private String name;
    private String desc;

    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("冬天","寒冷");
    //1.将构造器私有化，目的防止 直接new
    //2.去掉set方法，防止属性被修改
    //3.在Season内部，直接创建固定的对象。
    {
        System.out.println("静态代码块");
    }
    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实现枚举类

• 使用关键字enum代替class
• 如果有多个常量对象，使用“，”间隔开即可，最后一个要有分号结束
• 使用enum实现枚举，要将常量对象定义在最前面

enum Season2{
    
    SPRING("春天","温暖"),SUMMER("夏天","炎热"),AUTUMN("秋天","凉爽"),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关键字开发一个枚举类，默认会继承Enum类，而且是一个final类，使用javap反编译即可发现

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

Enum常用方法说明

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

• package com.hspedu.enum_;
  
  public class EnumMethod {
      public static void main(String[] args) {
          //使用Season2枚举类，来演示各种方法
          Season2 autumn = Season2.AUTUMN;
          //输出枚举对象的名字
          System.out.println(autumn.name());
          //ordinal() 输出的是该枚举对象的次序/编号，从0开始编号
          System.out.println(autumn.ordinal());
          //从反编译可以看出 values方法，返回 Season2[]
          //含有定义的所有枚举对象
          Season2[] values = Season2.values();
          for(Season2 season:values){//增强for循环
              System.out.println(season);
          }
          //valueOf:将字符串转换成枚举对象，要求字符串必须为已有的常量名，否则报异常
          Season2 autumn1 = Season2.valueOf("AUTUMN");
          System.out.println("autumn1"+autumn1);
          //compareTo:比较两个枚举常量，比较的就是编号,结果是两个编号的差值
          System.out.println(Season2.AUTUMN.compareTo(Season2.WINTER));
      }
  }
  

Enum使用细节

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

• enum实现枚举类，仍然是个类，所以还是可以实现接口的

• package com.hspedu.enum_;
  
  public class Enumeration03 {
      public static void main(String[] args) {
          Music.CLASSICALMUSIC.playing();
      }
  }
  
  interface IPlaying{
      public void playing();
  }
  
  enum Music implements IPlaying{
      CLASSICALMUSIC;
  
      @Override
      public void playing() {
          System.out.println("播放好听的音乐");
      }
  }
  

注解

注解的理解

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

三个基本的Annotation

1. @Override:限定某个方法，是重写父类方法，该注解只能用于方法
2. @Deprecated:用于表示某个程序元素（类，方法等）已过时
3. @SuppressWarnings:抑制编译器警告

1.@Override

• @Override放在方法上，表示重写了父类的方法，如果不加@Override,直接重写也可以
• 但是如果你写了@Override注解，编译器就会去检查该方法是否真的重写了父类的方法，如果的确重写了，则编译通过，如果没有构成重写，则编译错误

@Override源码：

补充说明：

• @Target(ElementType.METHOD)说明@Override只能修饰 方法

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

• @interface不是接口，他表示后面的这个（Override）是一个注解类

2.@Deprecated

• 修饰方法，类，字段，包，参数 等等。

• 该注解的作用可以做到新旧版本的兼容和过渡

3.@SuppressWarnings

• 当我们不希望看到警告时，可以使用@SuppressWarnings注解来抑制警告信息

• @SuppressWarnings({""}) //在{""}中，写入你希望抑制的警告信息
  

• @SuppressWarnings的作用域和你放置的位置相关，比如放在main方法上面，抑制警告的范围就是 main

元注解

1. Retention 指定注解的作用范围，三种取值：SOURCE.CLASS,RUNTIME
2. Target 指定注解可以在哪些地方使用
3. Documented 指定注解是否会在javadoc中体现
4. Inherited 指定子类会继承父类的注解

1.@Retention

• 说明：用于指定该Annotation可以保留多长时间，@Retention包含一个RetentionPolicy类型的成员变量，使用@Retention时，必须为该value成员变量指定值
• RetentionPolicy.SOURCE：编译器使用后，直接丢弃这种策略的注释
• RetentionPolicy.CLASS：编译器将把注解记录在class文件中，当运行Java程序时，JVM不会保留注解。这个也是value的默认值
• RetentionPolicy.RUNTIME：编译器将把注解记录在class文件中，当运行Java程序时，JVM会保留注解。程序可以通过反射获取该注解
• 简单来说，三者的作用范围不同，如下图：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-8PtmmcAk-1650089557382)(…/…/source/image-20220414231805820.png)]

2.@Target

• 说明：用于指定被修饰的Annotation能用于哪些程序元素。@Target也包含一个ElementType类型的成员变量。
• ElementType.Method/ElementType.FIELD等等

3.@Documented

• 说明：用于指定被修饰的Annotation类将被javadoc工具提取成文档，即在生成文档时，可以看到该注解

• 注: 定义为@Documented的注解必须设置@Retention为RetentionPolicy.RUNTIME

4.@Inherited

• 说明被它修饰的Annotation将具有继承性，如果某个类使用了被@Inherited修饰的Annotation，其子类将自动具有该注解
• 实际应用中，使用很少