枚举、注解、反射、内省（Java）

枚举

简介：

JDK1.5引入了新的类型——枚举。
在JDK1.5 之前，我们定义常量都是： public static fianl… 。很难管理。
枚举，可以把相关的常量分组到一个枚举类型里，而且枚举提供了比常量更多的方法。用于定义有限数量的一组同类常量，例如：
错误级别：低、中、高、急
一年的四季：春、夏、秋、冬
商品的类型：美妆、手机、电脑、男装、女装…
在枚举类型中定义的常量是该枚举类型的实例。

枚举的定义

权限修饰符
enum 枚举名称 {
实例1,实例2，实例3，实例4;
}

案例：

//带参数的枚举案例
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;
    }
}
//不带参数的枚举案例
public enum Level1 {
    LOW,MEDIUM,HIGH;
}

枚举的常用方法：（Enum抽象类常用方法）

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

注意事项

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

简介：

Java 注解（Annotation）又称 Java 标注，是 JDK5.0 引入的一种注释机制。 Java
语言中的类、方法、变量、参数和包等都可以被标注。和注释不同，Java 标注可以通过反射获取标注内容。
在编译器生成类文件时，标注可以被嵌入到字节码中。Java 虚拟机可以保留标注内容，在运行时可以获取到标注内容。
当然它也支持自定义 Java 标注。

主要用于：
编译格式检查
反射中解析
生成帮助文档
跟踪代码依赖等

快速理解注解的含义：就是一种可以加载进代码的注释

@Override:重写，使用在重写的方法前面
@Deprecated:废弃：使用该注解后，该方法使用时会出现一个删除线，用来提示程序员这个方法不建议在使用
@SafeVarargs：忽略任何使用参数为泛型变量的方法或构造函数调用产生的警告。
@FunctionalInterface：函数式接口 *
@Repeatable：标识某注解可以在同一个声明上使用多次
SuppressWarnings：抑制编译时的警告信息。 *
三种使用方式
@SuppressWarnings(“unchecked”) [^ 抑制单类型的警告] @SuppressWarnings(“unchecked”,“rawtypes”) [^ 抑制多类型的警告] @SuppressWarnings(“all”) [^ 抑制所有类型的警告]
参数列表：

元注解

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

注意事项

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

自定义注解

注解架构:

Annotation与RetentionPolicy 与ElementType
每 1 个 Annotation 对象，都会有唯一的 RetentionPolicy 属性；至于 ElementType 属性，则有 1~n 个。
(02) ElementType(注解的用途类型)
“每 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、注解中的每一个方法，实际上是声明的注解配置参数
（1）方法的名称就是配置参数的名称
（2）方法的返回值类型，就是配置参数的类型。。只能是：基本类型/Class/String/enum
（3）可以通过default语句来声明参数的默认值
（4）如果只有一个参数成员，一般参数名为value
（5）注解元素必须要有值，我们定义注解元素时，经常使用空字符串、0作为默认值。

  @Documented
   @Target(ElementType.TYPE)
    @Retention(RetentionPolicy.RUNTIME) 
    public @interface MyAnnotation1 {    
    参数类型 参数名() default 默认值; 
    }

上面的作用是定义一个 Annotation，我们可以在代码中通过 “@MyAnnotation1” 来使用它。 @Documented @Target, @Retention, @interface 都是来修饰 MyAnnotation1 的。
含义：
(01)@interface 使用 @interface 定义注解时，意味着它实现了 java.lang.annotation.Annotation 接口，即该注解就是一个Annotation。
定义 Annotation 时，@interface 是必须的。
注意：它和我们通常的implemented 实现接口的方法不同。Annotation 接口的实现细节都由编译器完成。通过 @interface定义注解后，该注解不能继承其他的注解或接口。
(02) @Documented 类和方法的 Annotation 在缺省情况下是不出现在
javadoc 中的。如果使用 @Documented 修饰该 Annotation，则表示它可以出现在 javadoc 中。
定义Annotation 时，@Documented 可有可无；若没有定义，则 Annotation 不会出现在 javadoc 中。
(03)@Target(ElementType.TYPE) 前面我们说过，ElementType 是 Annotation 的类型属性。而 @Target 的作用，就是来指定 Annotation 的类型属性。 @Target(ElementType.TYPE) 的意思就是指定该 Annotation 的类型是 ElementType.TYPE。
这就意味着，MyAnnotation1 是来修饰"类、接口（包括注释类型）或枚举声明"的注解。定义 Annotation 时，@Target 可有可无。若有 @Target，则该
Annotation 只能用于它所指定的地方；若没有 @Target，则该 Annotation 可以用于任何地方。
(04) @Retention(RetentionPolicy.RUNTIME) 前面我们说过，RetentionPolicy 是 Annotation 的策略属性，而 @Retention 的作用，就是指定 Annotation 的策略属性。 @Retention(RetentionPolicy.RUNTIME) 的意思就是指定该 Annotation 的策略是
RetentionPolicy.RUNTIME。这就意味着，编译器会将该 Annotation 信息保留在 .class 文件中，并且能被虚拟机读取。定义 Annotation 时，@Retention 可有可无。若没有 @Retention，则默认是 RetentionPolicy.CLASS。

反射

概述：

JAVA反射机制是在运行状态中，获取任意一个类的结构 , 创建对象 , 得到方法，执行方法 , 属性 !；这种在运行状态动态获取信息以及动态调用对象方法的功能被称为java语言的反射机制。

类加载器：

Java类加载器（Java Classloader）是Java运行时环境（Java Runtime Environment）的一部分，负责动态加载Java类到Java虚拟机的内存空间中。
java默认有三种类加载器，BootstrapClassLoader、ExtensionClassLoader、App ClassLoader。
BootstrapClassLoader（引导启动类加载器）：
嵌在JVM内核中的加载器，该加载器是用C++语言写的，主要负载加载JAVA_HOME/lib下的类库，引导启动类加载器无法被应用程序直接使用。无法通过Java代码直接使用
ExtensionClassLoader（扩展类加载器）：
ExtensionClassLoader是用JAVA编写，且它的父类加载器是Bootstrap。
是由sun.misc.Launcher$ExtClassLoader实现的，主要加JAVA_HOME/lib/ext目录中的类库。
它的父加载器是BootstrapClassLoader App ClassLoader（应用类加载器）： App ClassLoader是应用程序类加载器，负责加载应用程序classpath目录下的所有jar和class文件。它的父加载器为Ext ClassLoader

三个类加载器的子父关系：

类通常是按需加载，即第一次使用该类时才加载。由于有了类加载器，Java运行时系统不需要知道文件与文件系统。学习类加载器时，掌握Java的委派概念很重要。
双亲委派模型：如果一个类加载器收到了一个类加载请求，它不会自己去尝试加载这个类，而是把这个请求转交给父类加载器去完成。每一个层次的类加载器都是如此。因此所有的类加载请求都应该传递到最顶层的启动类加载器中，只有到父类加载器反馈自己无法完成这个加载请求（在它的搜索范围没有找到这个类时，子类加载器才会尝试自己去加载。委派的好处就是避免有些类被重复加载。

类加载器的源码：

加载配置文件：

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;

public class Demo1 {
    public static  void main(String[] args) throws IOException {
        //得到一个类加载器的输入流
      InputStream is =  Demo1.class.getClassLoader().getResourceAsStream("config");
      BufferedReader br = new BufferedReader(new InputStreamReader(is));
      String text = br.readLine();
      System.out.println(text);
      br.close();

    }
}

特殊的：
默认的加载路径是src下的文件，但是当项目中存在一个resource root 时，就会优先加载resource root 下的文件

所有类型的Class对象

Class叫做类的类型
要想了解一个类,必须先要获取到该类的字节码文件对象. 在Java中，每一个字节码文件，被夹在到内存后，都存在一个对应的Class类型的对象

得到Class的几种方式

如果在编写代码时, 指导类的名称, 且类已经存在, 可以通过包名.类名.class 得到一个类的类对象

如果拥有类的对象, 可以通过 Class 对象.getClass() 得到一个类的类对象

Person p = new Person();
Class<Person>c2 = (Class<Person>)p.getClass();

3.  如果在编写代码时, 知道类的名称 , 可以通过        Class.forName(包名+类名): 得到一个类的 类对象(可以在类不存在的时候使用，但是程序只有在运行的时候报错)

获取Constructor

通过class对象，获取一个类的构造方法

import java.lang.reflect.Constructor;
import java.lang.reflect.InvocationTargetException;

public class Demo1 {
    public static  void main(String[] args) throws ClassNotFoundException, NoSuchMethodException, IllegalAccessException, InvocationTargetException, InstantiationException {
        Class<Person> personClass = (Class<Person>) Class.forName("Person");
        //找到无参的构造方法
         Constructor<Person> c1 = personClass.getConstructor();
         Person p = c1.newInstance();
        System.out.println(p);
        //找到有参数的构造方法
        Constructor<Person>c2 = personClass.getConstructor(int.class,String.class);
        //使用两个参数的构造方法创建对象
        Person person = c2.newInstance(18,"张三");
        System.out.println(person);
    }
}

看运行效果：

注意一点啊：如果类中的构造方法时私有的方法，是不可以在其他的类中调用的
那么我们还想使用获取的Constructor来创建对象的话我们需要忽略权限的检查：
使用语句：构造器. setAccessible(boolean flag) 如果flag为true 则表示忽略访问权限检查 !(可以访问任何权限的方法)但是构造方法必须时获取所有权限的构造方法 getDeclaredConstructor(参数类型的class对象数组) 所获得的构造方法才可以。

反射中的方法

获取method

1、getMethod(String methodName , class… clss)
根据参数列表的类型和方法名,得到一个方法(public修饰的)
2. getMethods(); 得到一个类的所有方法 (public修饰的)
3. getDeclaredMethod(String methodName , class… clss) 根据参数列表的类型和方法名, 得到一个方法(除继承以外所有的:包含私有, 共有, 保护, 默认)
4. getDeclaredMethods(); 得到一个类的所有方法 (除继承以外所有的:包含私有, 共有, 保护, 默认)

Method 执行方法

invoke(Object o,Object… para) :
调用方法 ,
参数1. 要调用方法的对象
参数2. 要传递的参数列表 getName()
获取方法的方法名称 setAccessible(boolean flag)
如果flag为true 则表示忽略访问权限检查 !(可以访问任何权限的方法)

获取属性

通过class对象获取一个类的属性

getDeclaredField(String filedName) 根据属性的名称, 获取一个属性对象 (所有属性)
getDeclaredFields() 获取所有属性
getField(String filedName) 根据属性的名称, 获取一个属性对象 (public属性)
getFields() 获取所有属性 (public)

Field属性的对象类型

常用方法:
1. get(Object o );
参数: 要获取属性的对象获取指定对象的此属性值
2. set(Object o , Object value);
参数1. 要设置属性值的对象参数2. 要设置的值设置指定对象的属性的值
3. getName() 获取属性的名称
4.setAccessible(boolean flag)
如果flag为true 则表示忽略访问权限检查 !(可以访问任何权限的属性)

获取注解信息

Annotation[] annotations01 = Class/Field/Method.getAnnotations();
for (Annotation annotation : annotations01) {
System.out.println(annotation);
}

根据类型获取类/属性/方法的注解对象

注解类型对象名 = (注解类型) c.getAnnotation(注解类型.class);

内省（经过反射延申出来的API）

通过内省获取方法的机制

Introspector

获取Bean类信息方法: BeanInfo getBeanInfo(Class cls)
通过传入的类信息, 得到这个Bean类的封装对象 .

BeanInfo

常用的方法:
MethodDescriptor[] getPropertyDescriptors():
获取bean类的 get/set方法数组

MethodDescriptor

常用方法:
1. Method getReadMethod();
获取一个get方法
2. Method getWriteMethod(); 获取一个set方法
有可能返回null 注意 ,加判断 !

特别注意的是：
如果你的类中有一个boolean类型的属性，假设叫做flag,经过内省之后得到的get方法不是getflag而是isflag…

淘先锋技术网

枚举、注解、反射、内省（Java）

枚举

枚举的定义

枚举的常用方法：（Enum抽象类常用方法）

实现接口的枚举类

注意事项

注解

简介：

内置注解（系统自带的注解，可以直接拿来用）

元注解

自定义注解

定义格式：

注意事项

反射

概述：

类加载器：

加载配置文件：

所有类型的Class对象

得到Class的几种方式

获取Constructor

反射中的方法

获取method

Method 执行方法

获取属性

通过class对象获取一个类的属性

Field属性的对象类型

获取注解信息

根据类型获取类/属性/方法的注解对象

内省（经过反射延申出来的API）

Introspector

BeanInfo

MethodDescriptor