(高级基础)13_枚举&注解

一枚举类的使用（掌握）

主要内容:

如何自定义枚举类 
如何使用关键字enum定义枚举类 
Enum类的主要方法 
实现接口的枚举类

1.入门

类的对象只有有限个，确定的。举例如下：
星期：Monday(星期一)、…、Sunday(星期天)
性别：Man(男)、Woman(女)
季节：Spring(春节)…Winter(冬天)
支付方式：Cash（现金）、WeChatPay（微信）、Alipay(支付宝)、BankCard(银 行卡)、CreditCard(信用卡)
就职状态：Busy、Free、Vocation、Dimission
订单状态：Nonpayment（未付款）、Paid（已付款）、Delivered（已发货）、 Return（退货）、Checked（已确认）Fulfilled（已配货）、
线程状态：创建、就绪、运行、阻塞、死亡
当需要定义一组常量时，强烈建议使用枚举类

2.枚举类的使用

枚举类的实现

JDK1.5之前需要自定义枚举类 
JDK 1.5 新增的 enum 关键字用于定义枚举类 

若枚举只有一个对象, 则可以作为一种单例模式的实现方式。
枚举类的属性

枚举类对象的属性不应允许被改动, 所以应该使用 private final 修饰 
枚举类的使用 private final 修饰的属性应该在构造器中为其赋值 
若枚举类显式的定义了带参数的构造器, 则在列出枚举值时也必须对应的 传入参数

3.自定义枚举类

1. 私有化类的构造器，保证不能在类的外部创建其对象
2. 在类的内部创建枚举类的实例。声明为：public static final
3. 对象如果有实例变量，应该声明为private final，并在构造器中初始化

/*
 * 1.5之前自定义枚举
 */
public class Season {
	// 定义成员变量(常量  常量的命名采用所有字母大写)
	private final String  SNAME;
	private final String DESC;
	//构造方法私有化
	private Season(String name,String desc) {
		this.SNAME = name;
		this.DESC = desc;
	}
	//提供获取该类对象的方式 将对象作为全局常量返回
	public static final Season SPRING =  new Season("春天", "春暖花开");
	public static final Season SUM = new Season("夏天","烈日炎炎");
	public static final Season AUTUM = new Season("秋天","果实累累");
	public  static  final Season WINTER = new Season("冬天", "白雪皑皑");
	//提供获取属性的方法
	public String getSNAME() {
		return SNAME;
	}
	public String getDESC() {
		return DESC;
	}
	
}

public class Test {
	public static void main(String[] args) {
		Season spring = Season.SPRING;
		System.out.println(spring.getSNAME() +"---"+spring.getDESC());
	}
}

4.使用enum定义枚举类

使用说明
①使用 enum 定义的枚举类默认继承了 java.lang.Enum类，因此不能再继承其他类
②枚举类的构造器只能使用 private 权限修饰符
③枚举类的所有实例必须在枚举类中显式列出==(, 分隔 ; 结尾)。列出的 实例系统会自动添加 public static final 修饰==
④必须在枚举类的第一行声明枚举类对象
JDK 1.5 中可以在 switch 表达式中使用Enum定义的枚举类的对象 作为表达式, case 子句可以直接使用枚举值的名字, 无需添加枚举 类作为限定。

public enum SeasonEnum {
	// 需要将该类的对象声明在第一行  之间使用逗号（,）分隔  结束使用分号
	SPRING("春天", "春暖花开"),
	SUM("夏天","烈日炎炎"),
	AUTUM("秋天","果实累累"),
	WINTER("冬天", "白雪皑皑");
	private final String SNAME;
	private final String DESC;
	private SeasonEnum(String sname,String desc) {
		this.SNAME = sname;
		this.DESC = desc;
	}
	public String getSNAME() {
		return SNAME;
	}
	public String getDESC() {
		return DESC;
	}

}

public class Test {
	public static void main(String[] args) {
		SeasonEnum spring = SeasonEnum.SPRING;
		System.out.println(spring.getSNAME()+"---"+spring.getDESC());
	}
}

5.常用方法

values()方法：返回枚举类型的对象数组。该方法可以很方便地遍历所有的 枚举值。 
valueOf(String str)：可以把一个字符串转为对应的枚举类对象。要求字符串必须是枚举类对象的“名字”。如不是，会有运行时异常： IllegalArgumentException。 
toString()：返回当前枚举类对象常量的名

	public static void main(String[] args) {
//		values()方法：返回枚举类型的对象数组。该方法可以很方便地遍历所有的 枚举值。 
//		valueOf(String str)：可以把一个字符串转为对应的枚举类对象。要求字符 串必须是枚举类对象的“名字”。如不是，会有运行时异常： IllegalArgumentException。 
//		toString()：返回当前枚举类对象常量的名
		SeasonEnum[] sarr = SeasonEnum.values();
		for(SeasonEnum s : sarr) {
			System.out.println(s);
		}
		//获取枚举对象的第二种方式
		 SeasonEnum spring = SeasonEnum.valueOf("SPRING");
		 System.out.println(spring.getSNAME()+"---"+spring.getDESC());
	}

6.实现接口的枚举

和普通 Java 类一样，枚举类可以实现一个或多个接口 
若每个枚举值在调用实现的接口方法呈现相同的行为方式，则只 要统一实现该方法即可。 
若需要每个枚举值在调用实现的接口方法呈现出不同的行为方式, 则可以让每个枚举值分别来实现该方法

public interface Behaviour {
	void print();
	String getInfo();
}

public enum Color implements Behaviour {
	RED("红色","红红火火"),
	GREEN("绿色","绿意盎然"),
	YELLO("黄色","黄灿灿"),
	BULE("蓝色","蓝蓝蓝");
	private final String NAME;
	private final String DESC;
	private Color(String name,String desc) {
		this.NAME = name;
		this.DESC = desc;
	}
	@Override
	public void print() {
		System.out.println(this.NAME +"--"+this.DESC);
		
	}
	@Override
	public String getInfo() {
		// TODO Auto-generated method stub
		return this.NAME +"--"+this.DESC;
	}
}

public static void main(String[] args) {
		Color red = Color.RED;
		red.print();
		String info = red.getInfo();
		System.out.println(info);
		Color green = Color.valueOf("GREEN");
		green.print();
	}

二、注解(Annotation)

主要内容：

注解(Annotation)概述 
常见的Annotation示例 
自定义Annotation 
JDK中的元注解 
利用反射获取注解信息（在反射部分涉及） 
JDK 8中注解的新特性
注解 (Annotation) 概述

1.注解 (Annotation) 概述

①从 JDK 5.0 开始, Java 增加了对元数据(MetaData) 的支持, 也就是 Annotation(注解)
②Annotation 其实就是代码里的特殊标记, 这些标记可以在编译, 类加载, 运行时被读取, 并执行相应的处理。通过使用 Annotation, 程序员 可以在不改变原有逻辑的情况下, 在源文件中嵌入一些补充信息。代 码分析工具、开发工具和部署工具可以通过这些补充信息进行验证 或者进行部署。
③Annotation 可以像修饰符一样被使用, 可用于修饰包,类, 构造器, 方法, 成员变量, 参数, 局部变量的声明, 这些信息被保存在 Annotation 的 “name=value” 对中。
④在JavaSE中，注解的使用目的比较简单，例如标记过时的功能， 忽略警告等。在JavaEE/Android中注解占据了更重要的角色，例如 用来配置应用程序的任何切面，代替JavaEE旧版中所遗留的繁冗 代码和XML配置等。
⑤未来的开发模式都是基于注解的，JPA是基于注解的，Spring2.5以 上都是基于注解的，Hibernate3.x以后也是基于注解的，现在的 Struts2有一部分也是基于注解的了，注解是一种趋势，一定程度上可以说：框架 = 注解 + 反射 + 设计模式。

2.常见的Annotation示例

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

@SuppressWarnings("unchecked")//压制警告
	public static void main(String[] args) {
		 @SuppressWarnings("rawtypes")
		List list = new ArrayList();
		 list.add("aa");
	}

示例一：生成文档相关的注解

@author 标明开发该类模块的作者，多个作者之间使用,分割 
@version 标明该类模块的版本 
@see 参考转向，也就是相关主题 
@since 从哪个版本开始增加的 
@param 对方法中某参数的说明，如果没有参数就不能写 
@return 对方法返回值的说明，如果方法的返回值类型是void就不能写 
@exception 对方法可能抛出的异常进行说明 ，如果方法没有用throws显式抛出的异常就不能写 其中 
@param @return 和 @exception 这三个标记都是只用于方法的。 
    @param的格式要求：
        @param 形参名 形参类型 形参说明 
    @return 的格式要求：
        @return 返回值类型 返回值说明 
    @exception的格式要求：
        @exception 异常类型 异常说明 
@param和@exception可以并列多个

示例二：在编译时进行格式检查(JDK内置的三个基本注解)

@Override: 限定重写父类方法, 该注解只能用于方法 
@Deprecated: 用于表示所修饰的元素(类, 方法等)已过时。通常是因为 所修饰的结构危险或存在更好的选择 
@SuppressWarnings: 抑制编译器警告

@Deprecated
	public void test() {
		
	}

示例三：跟踪代码依赖性，实现替代配置文件功能
Servlet3.0提供了注解(annotation),使得不再需要在web.xml文件中进行Servlet的部署