第11章 枚举和注解

11.1 需求

要求创建季节对象

11.2 问题

传统方式可以无限new季节对象，但实际季节只有春夏秋冬且不变
即：

1. 季节的值是有限的（spring、summer、autumn、winter）
2. 只读，不修改

11.3 枚举 enumeration

1. 枚举是一组常量的集合
2. 枚举属于一种特殊的类，里面只包含一组有限的特定的对象

11.4 枚举两种实现方式

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

11.5 自定义类

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

public class Enumeration {
	public static void main(String[] args) {
		System.out.println("Season.SPRING");
		System.out.println("Season.SUMMER");
		System.out.println("Season.AUTUMN");
		System.out.println("Season.WINTER");
	}
}

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("冬天", "寒冷");

	//构造器私有化，删除set方法
	private class 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() {
		//略
	}
	
}

11.6 小结

1. 构造器私有化（防止new，更改属性）
2. 本类内部创建一组对象
3. 对外暴露对象用public static final 修饰
4. 可提供get方法，set方法删除

11.7 enum关键字类

public class Enumeration {
	public static void main(String[] args) {
		System.out.println("Season.SPRING");
		System.out.println("Season.SUMMER");
		System.out.println("Season.AUTUMN");
		System.out.println("Season.WINTER");
	}
}

enum Season {
	private String name;
	private String desc;

	//定义
	SPRING("春天", "温暖"),SUMMER("夏天", "炎热"),AUTUMN("秋天", "凉爽")WINTER("冬天", "寒冷");

	//构造器私有化，删除set方法
	private class 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() {
		//略
	}
	
}

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

1. 当使用enum关键字开发枚举类时，默认继承Enum类，而且是final类，javap反编译证明
   

2. SPRING(“春天”, “温暖”) 等价于 public static final Season SPRING = new Season(“春天”, “温暖”)；

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

4. 多个枚举对象时，逗号间隔，最后分号结尾

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

11.8 enum常用方法说明

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

11.9 enum常用方法应用实例

1. toString: 子类重写
2. name: 返回当前对象名（常量名），子类中不能重写
3. ordinal：返回当前对象的位置号，默认0开始编译
4. values：返回当前枚举类中所有的常量
5. valuesOf：将字符串转换为枚举对象，要求字符串必须为已有的常量名，否则异常
6. comepareTo：用编号比较两个枚举常量

public class EnumMethod {
	public static void main(String[] args) {
		Season autumn = Season.AUTUMN;

		//输出枚举对象名字
		System.out.println(autumn.name);
		//输出枚举对象编号
		System.out.println(autumn.ordinal);
		//输出所有枚举对象
		Season[] values = Season.values();
		for(Season season: values) { //增强for循环
									//依次从values数组中取出数据，赋给season，取出完毕则退出
			System.out.println(season);
		}
		//将字符串转化为枚举对象
		//根据输入的“AUTUMN“ 到 season类的枚举对象中去查找
		//找到返回，找不到报错
		Season autumn1 = Season.valueOf("AUTUMN");
		System.out.println("找到了，为： " + autumn1);
		//比较枚举对象
		System.out.println(Season.AUTUMN.compareTo(Season.SUMMER));
		
	}
}

enum Season {
	private String name;
	private String desc;

	//定义
	SPRING("春天", "温暖"),SUMMER("夏天", "炎热"),AUTUMN("秋天", "凉爽")WINTER("冬天", "寒冷");

	//构造器私有化，删除set方法
	private class 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() {
		//略
	}
	
}

11.10 enum 实现接口

1. 使用enum关键字后，因单继承机制，已经隐式继承了Enum类，就不能再继承其他类
2. 实现接口，形式：enum 类名 implements 接口1， 接口2 {}

11.11 注解

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

11.12 基本注解介绍

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

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

11.13 应用案例

11.13.1 @Override

1. @Override 表示指定重写父类方法（编译层面验证）
2. @Override 没写，父类有相关方法，也构成重写
3. 只能修饰方法
4. 源代码：@Target 是修饰注解的注解，成为元注解

11.13.2 @Deprecated

1. 用于表示某个程序元素已过时
2. 可以修饰方法、类、字段、包、参数等，看源码
3. 可以做到新旧版本的兼容和过渡

11.13.3 @SuppressWarnings

1. unchecked 忽略没有检查的警告
2. rawtypes 忽略没有指定泛型的警告
3. unused 忽略没有使用某个变量的警告错误
4. 可以修饰的程序元素：查看@Target

11.14 JDK的元注解

11.14.1 基本介绍

修饰注解的注解称为元注解

11.14.2 种类

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