JAVA学习十四：枚举、注解、反射

一、枚举

1.简介
JDK1.5引入了新的类型—枚举。
在JDK1.5之前，我们定义常量都是：public static final。。。很难管理
枚举，可以把相关的常量分组到一个枚举类型里，而且枚举提供了比常量更多的方法。

用于定义有限数量的一组同类常量，例如：
错误级别：
低、中、高、急
一年四季：
春、夏、秋、冬
商品类型：
美妆、手机、电脑、女装…
在枚举类型中定义的常量是该枚举类型的实例。

2.定义格式
权限修饰符 enum 枚举名称 {
实例1，实例2，实例3；
}

代码：

public enum Level2 {

    LOW(1),MEDIUM(50),HIGH(100);
    private int levelValue;

    private Level2(int levelValue){
        this.levelValue = levelValue;
    }

    public int getLevelValue() {
        return levelValue;
    }

    public void setLevelValue(int levelValue) {
        this.levelValue = levelValue;
    }
}

3.枚举类的主要方法（Enum抽象类常见方法）

返回类型	方法名称	方法说明
int	compareTo(E o)	比较此枚举与指定对象的顺序
boolean	equals(Object other)	当指定对象等于此枚举常量时，返回true
Class<?>	getDeclaringClass()	返回与此枚举常量的枚举类型对应的Class对象
String	name()	返回此枚举常量的名称，在其枚举声明中对其进行声明
int	ordinal()	返回枚举常量的序数（它在枚举声明中的位置，其中初始常量序数为零）
String	toString()	返回枚举常量的名称，它包含在声明中
static<T extends Enum> T	static valueOf(Class enumType,String name)	返回带指定名称的指定枚举类型的枚举常量

我们所有enum都是继承Enum抽象类的，其中只有一个方法可以重写，就是toString。
4.实现接口的枚举类
所有的枚举都继承自java.lang.Enum类，由于Java不支持多继承，所以枚举对象不能再继承其他类。
每个枚举对象，都可以实现自己的抽象方法。

public interface LShow{
	void show();
}
publiuc enum Level implements LShow{
	LOW(){
		public void show(){
		System.out.println(“低级别”);
		}
	},MEDIUM(){
		public void show(){
		System.out.println(“中级别”);
		}
	}
}

5.注意事项
*一旦定义了枚举，最好不要妄图修改里面的值，除非修改是必须的。
*枚举类默认继承的是java.lang.Enum类而不是Object类
*枚举不能有子类，因为其枚举类默认被final修饰
*只能有private构造方法
*switch中使用枚举时，直接使用常量名，不用携带类名
*不能定义name属性，因为自带name属性
*不要为枚举类中的属性提供set方法，不符合枚举最初设计初衷。

二、注解

1.简介
Java注解（Annotation）又称Java标注，是JDK5.0引入的一种注释机制。
Java语言中的类、方法、变量、参数和包等都可以被标注。和注释不同，Java标志可以通过反射获取标注内容。
在编译器生成类文件时，标注可以被嵌入到字节码中。Java虚拟机可以保留标注内容，在运行时可以获取到标注内容。当然它也支持自定义Java标注。
主要用于：
*编译格式检查
*反射中解析
*生成帮助文档
*跟踪代码依赖
*等

2.学习重点
理解Annotation的关键，是理解Annotation的语法和用法。
学习步骤：
1.概念
2.怎么使用内置注解
3.怎么自定义注解
4.反射中怎么获取注解内容
3.内置注解

Override：重写
*定义在java.lang.Override
Deprecated：废弃
*定义在java.lang.Deorecated
@SafeVarargs
*Java7开始支持，忽略任何使用参数为泛型变量的方法或构造函数调用产生的警告。
@FunctionalInterface： 函数式接口 *
*Java 8 开始支持，标识一个匿名函数或函数式接口。
@Repeatable：标识某注解可以在同一个声明上使用多次
*Java 8 开始支持，标识某注解可以在同一个声明上使用多次。
SuppressWarnings：抑制编译时的警告信息。 *
*定义在java.lang.SuppressWarnings
*三种使用方式
1. @SuppressWarnings("unchecked") [^ 抑制单类型的警告]
2. @SuppressWarnings("unchecked","rawtypes") [^ 抑制多类型的警告]
3. @SuppressWarnings("all") [^ 抑制所有类型的警告]

*参数列表：
关键字 用途

all 抑制所有警告
boxing 抑制装箱、拆箱操作时候的警告
cast 抑制映射相关的警告
dep-ann 抑制启用注释的警告
deprecation 抑制过期方法警告
fallthrough 抑制确在switch中缺失breaks的警告
finally 抑制finally模块没有返回的警告
hiding 抑制相对于隐藏变量的局部变量的警告
incomplete-switch 忽略没有完整的switch语句
nls 忽略非nls格式的字符
null 忽略对null的操作
rawtypes 使用generics时忽略没有指定相应的类型
restriction 抑制禁止使用劝阻或禁止引用的警告
serial 忽略在serializable类中没有声明serialVersionUID变量
static-access 抑制不正确的静态访问方式警告
synthetic-access 抑制子类没有按最优方法访问内部类的警告
unchecked 抑制没有进行类型检查操作的警告
unqualified-field-access 抑制没有权限访问的域的警告
unused 抑制没被使用过的代码的警告

4.元注解
4.1简介
作用在其他注解的注解

4.2有哪些？
@Retention - 标识这个注解怎么保存，是只在代码中，还是编入class文件中，或者是在运行时可
以通过反射访问。
@Documented - 标记这些注解是否包含在用户文档中 javadoc。
@Target - 标记这个注解应该是哪种 Java 成员。
@Inherited - 标记这个注解是自动继承的

1. 子类会继承父类使用的注解中被@Inherited修饰的注解
2. 接口继承关系中，子接口不会继承父接口中的任何注解，不管父接口中使用的注解有没有
   被@Inherited修饰
   3.类实现接口时不会继承任何接口中定义的注解

5.自定义注解
注解架构

1. Annotation与RetentionPolicy 与ElementType 。
   每 1 个 Annotation 对象，都会有唯一的 RetentionPolicy 属性；至于 ElementType 属性，则有 1~n
   个。
   (02) ElementType(注解的用途类型)

1. 子类会继承父类使用的注解中被@Inherited修饰的注解
2. 接口继承关系中，子接口不会继承父接口中的任何注解，不管父接口中使用的注解有没有
   被@Inherited修饰
3. 类实现接口时不会继承任何接口中定义的注解
   “每 1 个 Annotation” 都与 “1～n 个 ElementType” 关联。当 Annotation 与某个 ElementType 关联
   时，就意味着：Annotation有了某种用途。例如，若一个 Annotation 对象是 METHOD 类型，则该
   Annotation 只能用来修饰方法。

package java.lang.annotation;
public enum ElementType {
  TYPE,        /* 类、接口（包括注释类型）或枚举声明 */
  FIELD,        /* 字段声明（包括枚举常量） */
  METHOD,       /* 方法声明 */
  PARAMETER,      /* 参数声明 */
  CONSTRUCTOR,     /* 构造方法声明 */
  LOCAL_VARIABLE,   /* 局部变量声明 */
  ANNOTATION_TYPE,   /* 注释类型声明 */
  PACKAGE       /* 包声明 */
}

(03) RetentionPolicy（注解作用域策略）。
“每 1 个 Annotation” 都与 “1 个 RetentionPolicy” 关联。
a) 若 Annotation 的类型为 SOURCE，则意味着：Annotation 仅存在于编译器处理期间，编译器
处理完之后，该 Annotation 就没用了。 例如，" @Override" 标志就是一个 Annotation。当它修
饰一个方法的时候，就意味着该方法覆盖父类的方法；并且在编译期间会进行语法检查！编译器处
理完后，"@Override" 就没有任何作用了。
b) 若 Annotation 的类型为 CLASS，则意味着：编译器将 Annotation 存储于类对应的 .class 文件
中，它是 Annotation 的默认行为。
c) 若 Annotation 的类型为 RUNTIME，则意味着：编译器将 Annotation 存储于 class 文件中，并
且可由JVM读入。

package java.lang.annotation;
public enum RetentionPolicy {
  SOURCE,       /* Annotation信息仅存在于编译器处理期间，编译器处理完之后就没有该
Annotation信息了 */
  CLASS,       /* 编译器将Annotation存储于类对应的.class文件中。默认行为 */
  RUNTIME       /* 编译器将Annotation存储于class文件中，并且可由JVM读入 */
}

定义格式

@interface 自定义注解名{}

注意事项

1. 定义的注解，自动继承了java.lang,annotation.Annotation接口
2. 注解中的每一个方法，实际是声明的注解配置参数
   方法的名称就是 配置参数的名称
   方法的返回值类型，就是配置参数的类型。只能是：基本类型/Class/String/enum
3. 可以通过default来声明参数的默认值
4. 如果只有一个参数成员，一般参数名为value
5. 注解元素必须要有值，我们定义注解元素时，经常使用空字符串、0作为默认值。
   代码：

package com.java.meiju;

import java.lang.annotation.*;

/**
 * 元注解及自定义注解使用
 */
@MyAnnotation("张三")
public class Demo2 {
    public static void main(String[] args) {

    }

    public  void add(){}
}
//注解是否包含在文档中
@Documented
//用途类型：可以使用在类，方法上
@Target({ElementType.TYPE,ElementType.METHOD})
//保存策略：保存在JVM、.class文件和编译时的JAVA文件中（最大范围）
@Retention(RetentionPolicy.RUNTIME)
//可以继承
@Inherited
@interface MyAnnotation{
    //其实就是通过注解传入数值，String为返回值类型，value()就是传递的参数
    //只有value属性可以不加参数名称直接传递。如@MyAnnotation("张三")
    //但是如果换个属性如value2，那么必须加参数名@MyAnnotation(value2="张三")
    String value();//这是注解的属性，本质也是个抽象方法
    int num() default 1;//如果想不传递参数。可以给内部参数设置默认值，格式default 值
}