枚举、注解与反射

1.枚举

JDK1.5 引入了新的类型 —— 枚举。

在 JDK1.5 之前，我们定义常量都是： public static fianl.... 。很难管理。

枚举，可以把相关的常量分组到一个枚举类型里，而且枚举提供了比常量更多的方法。

用于定义有限数量的一组同类常量，例如：

错误级别：

低、中、高、急

一年的四季：

春、夏、秋、冬

商品的类型：

美妆、手机、电脑、男装、女装 ...

在枚举类型中定义的常量是该枚举类型的实例

定义格式

权限修饰符 enum 枚举名称 {

           实例 1, 实例 2 ，实例 3 ，实例 4;

}

注：

• 使用enum创建枚举类时，其父类默认是java.lang.Enum

• 类内部的枚举类默认是static的

//父类是 java.lang.Enum
public enum SeasonE {
    //直接定义对象的变量 必须写在最前面 变量之间用逗号分割 最后一个使用分号
    // 相当于
    // private static final SeasonE SPRING = new SeasonE("春天", "春暖花开")
    // 如果没有属性的话 直接写常量名即可 （参考Thread类内部的Statu）
    SPRING("春天", "春暖花开"),
    SUNMER("夏天", "夏日炎炎");

    // 构造器 默认是私有的 不能加除paivate权限外的其他权限
    SeasonE(String name, String desc) {
        this.name = name;
        this.desc = desc;
    }

    //属性 private不能省
    private String name;
    private String desc;
	
    //提供get方法  不提供set方法
    public String getName() {
        return name;
    }
    
    public String getDesc() {
        return desc;
    }
}

 枚举类的主要方法

Enum抽象类常见方法

主要方法应用

toString() 

//返回当前枚举类对象常量的名称  
Thread.State aNew = Thread.State.NEW;
String s = aNew.toString();
输出：
//   NEW

valueOf(String str)

// 根据提供的名称 返回内部的常量对象 如果不存在 抛出异常 IllegalArgumentException非法参数异常
Thread.State blocked  = Thread.State.valueOf("BLOCKED");
System.out.println(blocked);

输出：
//   BLOCKED     

实现接口的枚举类

所有的枚举都继承自 java.lang.Enum 类。由于 Java 不支持多继承，所以枚举对象不能再继承其他类。

每个枚举对象，都可以实现自己的抽象方法

enum  OrderStatus implements InterfaceTest{
	
    //如果想要实现的逻辑不一样 在对象后直接重写 
    NEW(0,"新建"){
        @Override
        public void show() {
            
        }
    },
    COMMITTED(1,"已提交订单"){
        @Override
        public void show() {
            
        }
    },
    HASPAY(2,"已付款"){
        @Override
        public void show() {
            
        }
    },
    HASSEND(3,"已发货"){
        @Override
        public void show() {
            
        }
    },
    HASGET(4,"确认收货"){
        @Override
        public void show() {
            
        }
    },
    HASFINASH(5,"订单已完成"){
        @Override
        public void show() {
            
        }
    };
   
    private int code;
    private String msg;
    OrderStatus(int code, String msg) {
        this.code = code;
        this.msg = msg;
    }

}

interface InterfaceTest{
    void show();
}

注意事项

1.一旦定义了枚举，最好不要妄图修改里面的值，除非修改是必要的。

2.枚举类默认继承的是 java.lang.Enum 类而不是 Object 类

3.枚举类不能有子类，因为其枚举类默认被 fifinal 修饰

4.只能有 private 构造方法

5.switch 中使用枚举时，直接使用常量名，不用携带类名

6.不能定义 name 属性，因为自带 name 属性

7.不要为枚举类中的属性提供 set 方法，不符合枚举最初设计初衷。

注解

Java 注解（ Annotation ）又称 Java 标注，是 JDK5.0 引入的一种注释机制。

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

JDK5.0的新特性
注解(Annotation)其实就是代码里的特殊标记，这些标记可以在编译期，类加载，运行时被读取，并执行相应的处理，
注解可以像修饰符一样被使用, 可修饰 包，类，构造器，方法，属性，参数，局部变量
注解一般配合反射使用，在运行期通过反射读取注解 ，然后进行相应的操作
注解的 本质就是接口 ，默认的注解都继承 java.lang.Annotation 接口，所以在使用的时候都是接口的实现类
 

元注解

@Retention

标识这个注解怎么保存，是只在代码中，还是编入 class 文件中，或者是在运行时可

以通过反射访问。

源码 只有一个属性 是一个枚举类 RetentionPolicy，里面的三个属性代表生命周期的三个状态

public @interface Retention {
    RetentionPolicy value();
}

public enum RetentionPolicy {
    SOURCE,
    CLASS, //默认
    RUNTIME
}

 @Target

标记这个注解应该是哪种 Java 成员。

源码 只有一个属性 是一个ElementType枚举类型的数组，这个类里面定义了注解可以修饰的结构

public @interface Target {
    ElementType[] value();
}
public enum ElementType {
    /* 类 接口 枚举类*/
    TYPE,
    
    /*属性*/
    FIELD,
    
    /*方法*/
    METHOD,
    
    /*参数*/
    PARAMETER,
    
	/*构造器*/
    CONSTRUCTOR,
    
     /*局部变量*/
    LOCAL_VARIABLE,
    
	/*注解*/
    ANNOTATION_TYPE,
    
    /*包*/
    PACKAGE,
    
    /*JDK8新特性 表示注解可以标注在类型变量的声明语句中 （如泛型声明）**/
    TYPE_PARAMETER,
    
    /*JDK8新特性 表示注解可以标注在使用类型的任何语句中**/
    TYPE_USE
}

 @Documented

标记这些注解是否包含在用户文档中 javadoc 。

定义了@Documented的注解的生命周期的值(@Retention)必须指定为RUNTIME

@Inherited

标记这个注解是自动继承的 

1. 子类会继承父类使用的注解中被 @Inherited 修饰的注解

2. 接口继承关系中，子接口不会继承父接口中的任何注解，不管父接口中使用的注解有没有

被 @Inherited 修饰

3. 类实现接口时不会继承任何接口中定义的注解

/*意思就是：
    当我的自定义注解加了@Inherited元注解时，我的Dad类加了这个自定义注解，那么默认Dad的子类Son也有自定义注解，反之子类就没有这个注解*/

@MyTestInter("h1")
class Dad{
    
}

class Son extends Dad{
    
}

//自定义注解
@Inherited
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@interface MyTestInter{
   
    String value() default "sds";
    
}

JDK内置的3个编译期注解

• @Override ：修饰方法 限定方法的重写 （类和接口）
• @Deprecated ： 修饰类 方法 属性等… 表示已过时 通常是因为所修饰的结构危险或者存在更好的选择
• @SuppressWarnings : 抑制编译器警告

 自定义注解

定义格式：

@interface 自定义注解名{}

注意：

1. 定义的注解，自动继承了java.lang,annotation.Annotation接口

2. 注解中的每一个方法，实际是声明的注解配置参数

           方法的名称就是 配置参数的名称

           方法的返回值类型，就是配置参数的类型。只能是：基本类型/Class/String/enum

3. 可以通过default来声明参数的默认值

4. 如果只有一个参数成员，一般参数名为value

5. 注解元素必须要有值，我们定义注解元素时，经常使用空字符串、0作为默认值。

6.属性的类型可以是简单类型、String、简单类型/String数组、Class类型、枚举、枚举数组类不可以是自定义的引用类型(如Person List类等)

例子： 

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE,ElementType.TYPE_PARAMETER})
public @interface MyAnnotation {

    String[] value(); //String类型的数组
    int index();  //简单类型
    Class[] clazz(); //Class类型的数组
    Tenum[] TENUMS(); //枚举类型的数组
    TAnnotation T_ANNOTATION(); //注解类型的数组
}

------ 使用
@MyAnnotation(value = {"test1","wsh"},index = 1,clazz = Calendar.class,TENUMS = Tenum.TESTF,T_ANNOTATION = @TAnnotation("test"))
public class Person {

}

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

反射

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

反射相关API

java.lang.Class ：代表一个类
java.lang.reflect.Method ：代表类的方法
java.lang.reflect.Field ： 代表类的成员变量
java.lang.reflect.Constructor：代表类的构造器
java.lang.annotation接口

代表着反射的基本思路，我们先去获取一个类的Class对象，然后通过Class对象去获取它的构造器，方法，属性，然后去创建对象调用方法

Class类

• 在类的加载过程中，.java文件变为.class文件，然后class文件通过类的加载器加载到JVM中去，就生成一个Class类的一个实例，这个就是大的Class对象，所以说这个大的Class对象在内存中只有一个，因为类只会加载一次

• Class类的实例称为类对象

 

获得Class对象（类对象）的四种方式

1. 如果在编写代码时 , 指导类的名称 , 且类已经存在 , 可以通过

        包名 . 类名 .class 得到一个类的 类对象

2. 如果拥有类的对象 , 可以通过

       Class 对象 .getClass() 得到一个类的 类对象

3. 如果在编写代码时 , 知道类的名称 , 可以通过

       Class.forName( 包名 + 类名 ): 得到一个类的 类对象

上述的三种方式 , 在调用时 , 如果类在内存中不存在 , 则会加载到内存 ! 如果类已经在内存中存在 , 不 会重复加载, 而是重复利用 !

(一个class文件 在内存中不会存在两个类对象 )

特殊的类对象

基本数据类型的类对象 :

        基本数据类型.class

        包装类.type

基本数据类型包装类对象 : 包装类.class

 

Class clazz1 = Person.class;

Person person = new Person();
Class clazz2 = person.getClass();
//经常用于 判断这个对象所属的类 

Class clazz3 = Class.forName("全类名"); 

//注意 我们自定义的类使用的基本都是 System Class Loader 系统类加载器
//所以可以借用我们自定义的其他类的类加载器去加载类 生成一个Class对象
ClassLoader classLoader = Test.class.getClassLoader();
Class class4 = classLoader.loadClass("反射.Person"); 

Class类的方法

getName()    获得全类名
getSimpleName()   获得类名
getPackage()    返回类的包对象
getFields/Methods   返回本类和父类中声明为public的属性和方法
newInstance()   创建指定类的对象 ,调用的是类的无参构造器
getDeclaredField(String fieldname)   通过属性名 获得属性对象
getDeclaredFields()   只能获取本类中所有的属性，返回一个Field数组
getDeclaredMethod(String methodName, Class ... argType)  根据方法名、参数列表获得一个方法对象
getDeclaredMethods()    获得类中所有的方法
getDeclaredConstructor(Class ... argType)   根据构造器的参数列表获得一个构造器对象
getDeclaredConstructors()    获 得本类中的所有的构造器，返回Constructor数组
getClassLoader()    获取当前类的类加载器
isXXX()   判断当前的Class对象的类型是否是某个类型
toString()   输出当前Class对象的类型信息 + 全类名
isAnnotationPresent(Class annotationClass)   判断某个类对象是否含有指定的注解
 

获取Constructor

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

1. 通过指定的参数类型 , 获取指定的单个构造方法

        getConstructor(参数类型的class对象数组)

例如 :

构造方法如下 : Person(String name,int age)

得到这个构造方法的代码如下 :

Constructor c = p.getClass().getConstructor(String.class,int.class);

2. 获取构造方法数组

      getConstructors();

3. 获取所有权限的单个构造方法

      getDeclaredConstructor(参数类型的class对象数组)

4. 获取所有权限的构造方法数组

    getDeclaredConstructors();  

Constructor创建对象

常用方法 :

      newInstance(Object... para)

调用这个构造方法 , 把对应的对象创建出来

参数 : 是一个 Object 类型可变参数 , 传递的参数顺序 必须匹配构造方法中形式参数列表的顺

序 !

      setAccessible(boolean flag)

如果 flag 为 true 则表示忽略访问权限检查 !( 可以访问任何权限的方法)

 

获取Method

通过Class对象获取一个类的方法

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 则表示忽略访问权限检查 !( 可以访问任何权限的方法 )

//method 的常用方法

Class<Son> clazzSon = Son.class;
Method[] methods = clazzSon.getDeclaredMethods();
for (Method method : methods) {
   // Object invoke = method.invoke(, ); 为某个对象执行方法
--    
    String s = method.toString(); //获取方法的整个声明
--    
    System.out.println(method.getName()); //只获取方法名
--    
    Annotation[] declaredAnnotations = method.getDeclaredAnnotations(); //获取方法上的所有注解
--    
    Class<?>[] parameterTypes = method.getParameterTypes(); //获取方法的参数
--   
    int modifiers = method.getModifiers(); // 获取方法的所有修饰符
    System.out.println(Modifier.toString(modifiers));
--    
    Class<?>[] exceptionTypes = method.getExceptionTypes(); //获取方法声明中抛出的所有异常
--    
    Class<?> returnType = method.getReturnType(); //获取方法的返回值

 获取Field

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

1. getDeclaredField(String filedName)

          根据属性的名称 , 获取一个属性对象 ( 所有属性 )

2. getDeclaredFields()

         获取所有属性

3. getField(String filedName)

        根据属性的名称 , 获取一个属性对象 (public 属性 )

4. getFields()

       获取所有属性 (public)

Field的常用方法

1. get(Object o );

    参数 : 要获取属性的对象

        获取指定对象的此属性值

2. set(Object o , Object value);

        参数 1. 要设置属性值的 对象

        参数 2. 要设置的值

        设置指定对象的属性的值

3. getName()

       获取属性的名称

4. setAccessible(boolean flag)

       如果 flag 为 true 则表示忽略访问权限检查 !( 可以访问任何权限的属性 )

 

for (Field field : declaredFields) {
    
String s1 = field.toString();//获取整个定义 所有修饰符+类型+全类名.属性名
    
String name = field.getName();//获取属性名
    
Class<?> type = field.getType();//获取属性的类型 返回一个Class类型
    
int modifiers = field.getModifiers(); //获取属性的修饰符 返回int值 调用Modifier.toString()获取权限修饰符 转换为
String s = Modifier.toString(modifiers); //
    
Annotation[] annotations = field.getDeclaredAnnotations(); //获取属性上的所有注解 返回一个集合
    
field.isAnnotationPresent(Class class) //判断属性上是否含有某一个注解

获取注解信息

获取类/属性/ 方法的全部注解对象

Annotation[] annotations01 = Class/Field/Method.getAnnotations();

for (Annotation annotation : annotations01) {

             System.out.println(annotation);

}

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

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