七、枚举和注解-CSDN博客

本文链接：https://blog.csdn.net/m0_45256868/article/details/138367063

文章目录

- - 七.枚举和注解
  - - - 1.枚举（enum）
      - 2.注解（Annotation ）

七.枚举和注解

1.枚举（enum）

当有些类只有几个有限的值，而且只读不修改，可以使用枚举enum
枚举是一组常量的集合，可以理解为是一种特殊的类，里边只包含有限的特定的对象

两种实现

自定义实现枚举

将构造器私有化，目的防止直接new
去掉setXXX方法，防止属性被修改，可以提供getXX方法
在类内部，直接创建固定的对象（枚举对象名通常全部大写，这是常量的命名规则）
优化，可加入final修饰（public static final）

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 SUMMER = new Season("夏天", "炎热");
    private Season(String name, String desc) {
        this.name = name;
        this.desc = desc;
    }
}

//调用
public class Enumeration03 {
    public static void main(String[] args) {
        System.out.println(Season2.AUTUMN);
        System.out.println(Season2.SUMMER);
    }
}

使用关键字enum
- 使用关键字enum替代class
- public static final Season SPRING = new Season(“春天”, “温暖”);可以直接换成SPRING(“春天”, “温暖”)；
- 如果有多个常量（对象），使用"，"间隔
- 使用enum来实现枚举，要求将定义常量对象放在最前面
```
enum  Season2 {//类
    SPRING("春天", "温暖"), WINTER("冬天", "寒冷"), AUTUMN("秋天", "凉爽"),
    SUMMER("夏天", "炎热"), What(), Other;
    private String name;
    private String desc;//描述
    private Season2() {//无参构造器，前边的private可以去掉，默认值
    }
    private Season2(String name, String desc) {
        this.name = name;
        this.desc = desc;
    }
}

//调用
public class Enumeration03 {
    public static void main(String[] args) {
        System.out.println(Season2.AUTUMN);
        System.out.println(Season2.SUMMER);
    }
}
```
- 注意事项
  - 当我们使用 enum 关键字开发一个枚举类时，默认会继承 Enum 类, 而且是一个 final 类
  - 枚举enum中构造器默认为私有：枚举被设计成是单例模式，即枚举类型会由JVM在加载的时候，实例化枚举对象，你在枚举类中定义了多少个就会实例化多少个，JVM为了保证每一个枚举类元素的唯一实例，是不会允许外部进行new的，所以会把构造函数默认设计成 private
  - 如果使用无参构造器创建枚举对象，则实参列表和小括号都可以省略

小技巧：普通for循环的快捷模板fori 增强for循环的快捷模板iter

枚举类的方法

Season2 autumn = Season2.AUTUMN;

//输出枚举对象的名字
System.out.println(autumn.name());//AUTUMN

//ordinal() 输出的是该枚举对象的次序/编号，从0开始编号
//AUTUMN 枚举对象是第三个，因此输出 2
System.out.println(autumn.ordinal());//2

//含有定义的所有枚举对象
Season2[] values = Season2.values();
System.out.println("===遍历取出枚举对象(增强for)====");
for (Season2 season: values) {//增强for循环
    System.out.println(season);
}//Season{name='春天', desc='温暖'}
//Season{name='冬天', desc='寒冷'}
//Season{name='秋天', desc='凉爽'}
//Season{name='夏天', desc='炎热'}

//valueOf：将字符串转换成枚举对象，要求字符串必须为已有的常量名，否则报异常
//执行流程
//1. 根据你输入的 "AUTUMN" 到 Season2的枚举对象去查找
//2. 如果找到了，就返回，如果没有找到，就报错
Season2 autumn1 = Season2.valueOf("AUTUMN");
System.out.println("autumn1=" + autumn1);
//autumn1=Season{name='秋天', desc='凉爽'}

System.out.println(autumn == autumn1);//true

//compareTo：比较两个枚举常量，比较的就是编号
//就是把 Season2.AUTUMN 枚举对象的编号 和 Season2.SUMMER枚举对象的编号比较,相等返回0，不等返回-1
System.out.println(Season2.AUTUMN.compareTo(Season2.SUMMER));//-1

枚举实现接口

使用enum关键字之后，就不能再继承其他类了，因为enum隐式继承Enum类，而java是单继承机制
枚举类和普通类一样，可以实现接口

interface IPlaying {
    public void playing();
}
enum Music implements IPlaying {
    CLASSICMUSIC;
    @Override
    public void playing() {
        System.out.println("播放好听的音乐...");
    }
}

2.注解（Annotation ）

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

基本注解

使用注解前要添加@符号，并把该 Annotation 当成一个修饰符使用。用于修饰它支持的程序元

素
**@Override：**限定某个方法，是重写父类方法（编译层面），该注解只能用于方法
```
/*  @Override源码，可以看出它是一个注解类（有@interface）
	@Target(ElementType.METHOD)
	@Retention(RetentionPolicy.SOURCE)
	public @interface Override {
	}
*/
```
- 如果不写 @Override 还是重写了父类的方法
- 如果写了@Override注解，编译器就会去检查该方法是否真的重写了父类的方法，如果的确重写了，则编译通过，如果没有构成重写，则编译错误
- 如果发现 @interface 表示一个注解类
- @Target是修饰注解的注解，称为元注解

@Deprecated: 用于表示某个程序元素(类, 方法等)已过时

/* @Deprecated源码，可以看出它是一个注解类（有@interface）
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
public @interface Deprecated {
}
 */

表示不推荐使用，但是仍然可以使用
可以修饰方法，类，字段, 包, 参数等等
可以做版本升级过渡使用

@SuppressWarnings: 抑制编译器警告

/*   @SuppressWarnings源码，可以看出它是一个注解类（有@interface）
@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})
@Retention(RetentionPolicy.SOURCE)
public @interface SuppressWarnings {
    String[] value();
}
*/

当我们不希望看到这些警告的时候，可以使用 SuppressWarnings注解来抑制警告信息
在{“”} 中，可以写入你希望抑制(不显示)警告信息

//可以指定的警告类型有
//          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，抑制与未用的程式码及停用的程式码相关的警告

SuppressWarnings 作用范围是和你放置的位置相关，放置在 main方法，那么抑制警告的范围就是 main，通常我们可以放置具体的语句, 方法, 类

四种元注解：JDK 的元注解用于修饰其他注解类，作用不大，看源码时知道是什么就行
- Retention //指定注解的作用范围，三种 SOURCE,CLASS,RUNTIME
- Target // 指定注解可以在哪些地方使用
- Documented //指定该注解是否会在 javadoc 体现
- Inherited //子类会继承父类注解