注解与反射

注解

一、什么是注解

• Annotation是从JDK5.0开始引入的新技术

• Annotation的作用：

  • 不是程序本身，可以对程序作出解释（这一点和注释comment没什么区别）
  • 可以被其它程序（比如：编译器）读取

• Annotation的格式

  注解是以“@注释名”在代码中存在的，还可以添加一些参数值，例如：@SuppressWarnings(value=“unchecked”)

• Annotation在哪里使用

  可以附加在package、class、method、field等上面，相当于给他们添加了额外的辅助信息，可以通过反射机制编程实现对这些原数据的访问

二、内置注解

• @Override：定义在java.lang.Override中，此注释只适用于修饰方法，表示一个方法声明打算重写超类中的另一个方法声明

• @Deprecated：定义在java.lang.Deprecated中，此注释可以用于修饰方法，属性，类，表示不鼓励程序员使用这样的元素，通常是因为它很危险或者存在更好的选择

• @SuppressWarnings：定义在java.lang.SuppressWarnings中，用来抑制编译时的警告信息，与前面两个注释有所不同，你需要添加一个参数才能正确使用，这些参数都是已经定义好了的，选择使用即可

  • @SuppressWarnings(“all”)
  • @SuppressWarnings(“unchecked”)
  • @SuppressWarnings(value={“unchecked”,“deprecation”})
  • ……
  • 添加@SuppressWarnings前后区别：

  

package com.kongbai.annotation;

import java.util.ArrayList;

/**
 * @author kongbai
 * @version 1.0.0
 * @ClassName Test01.java
 * @Description 注解
 * @createTime 2022年04月11日 16:55:00
 */
public class Test01 extends Object{
   
    //@Override 重写的注解
    @Override
    public String toString() {
   
        return super.toString();
    }

    //@Deprecated 已过时的，不推荐使用的意思，但可以用
    @Deprecated
    public static void test() {
   
        System.out.println("Deprecated");
    }

    //@SuppressWarnings 抑制编译时的警告信息
    @SuppressWarnings("all")
    public void test02() {
   
        ArrayList arrayList = new ArrayList();
    }

    public static void main(String[] args) {
   
        test();
    }
}

三、元注解

• 元注解的作用就是负责注解其它注解，Java定义了4个标准的meta-annotation类型，他们被用来提供对其它annotation类型作说明

• 这些类型和它们所支持的类在java.lang.annotation包中可以找到（@Target，@Retention，@Documented，@Inherited）

  • @Target：用于描述注解的使用范围（即被描述的注解可以用在什么地方）
  • @Retention：表示需要在什么级别保存该注释信息，用来描述注解的生命周期
    • （SOURCE < CLASS < RUNTIME）
  • @Documented：说明该注解将被包含在javadoc中
  • @Inherited：说明子类可以继承父类中的该注解

package com.kongbai.annotation;

import java.lang.annotation.*;

/**
 * @author kongbai
 * @version 1.0.0
 * @ClassName Test02.java
 * @Description 测试元注解
 * @createTime 2022年04月11日 17:33:00
 */

@MyAnnotation
public class Test02 {
   
    @MyAnnotation
    public void test() {
   

    }
}

//定义一个注解
@Target(value = {
   ElementType.METHOD, ElementType.TYPE}) //@Target 表示注解可以用在哪些地方
@Retention(value = RetentionPolicy.RUNTIME) //@Retention 表示注解在什么地方还有效
@Documented //@Documented 表示是否将注释生成在JAVAdoc中
@Inherited //@Inherited 子类可继承父类的注解
@interface  MyAnnotation {
   

}

四、自定义注解

• 使用@interface自定义注解时，自动继承了java.lang.annotation.Annotation接口
• 分析：
  • @interface用来声明一个注解，格式：public @interface 注解名{定义内容}
  • 其中的每一个方法实际上是声明了一个配置参数
  • 方法的名称就是参数的名称
  • 返回值类型就是参数的类型（返回值只能是基本类型，Class、String、enum）
  • 可以通过default来声明参数的默认值
  • 如果只有一个参数成员，一般参数名为value
  • 注解元素必须要有值，我们定义注解元素时，经常使用空字符串，0作为默认值

package com.kongbai.annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * @author kongbai
 * @version 1.0.0
 * @ClassName Test03.java
 * @Description 自定义注解
 * @createTime 2022年04月12日 16:42:00
 */
public class Test03 {
   
    //注解可以显示赋值，如果没有默认值，则必须赋值
    @MyAnnotation2(age = 18, name = "空白")
    public void test() {
   }
    
    @MyAnnotation3("空白") //用value可以直接在注释里赋值，用name就必须写name = "空白"
    public void test2() {
   
        
    }
}

@Target({
   ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation2 {
   
    //注解的参数：参数类型+参数名();
    String name() default "";
    int age();
    int id() default -1; //如果默认值为-1，代表不存在
    String[] schools() default {
   "清华大学", "北京大学"};
}

@Target({
   ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation3 {
   
    String value(); //用value可以直接在注释里赋值，用name就必须写name = "空白"
}

反射

一、静态 VS 动态语言

1. 动态语言

   • 是一类在运行时可以改变其结构的语言：例如新的函数、对象、甚至代码可以被引进，已有的函数可以被删除或是其他结构上的变化。就是在运行是代码可以根据某些条件改变自身结构
   • 主要动态语言：Object-C、C#、JavaScript、PHP、Python等

   比如JavaScript代码：

   function f() {
        
       var x = "var a = 3; b = 5; alert(a + b)"; //alert函数：显示一个警告对话框，包括一个OK按钮
       eval(x) //将字符串"var a = 3; b = 5; alert(a + b)"执行出来
   }
   

2. 静态语言

   • 与动态语言相对应的，运行时结构不可变的语言就是静态语言。如Java、C、C++
   • Java不是动态语言，但Java可以称之为“准动态语言”。即Java有一定的动态性，我们可以利用反射机制获得类似动态语言的特性。Java的动态性让编程更加灵活

二、Java Reflection

• Reflection（反射）是Java被视为动态语言的关键，反射机制允许程序在执行期借助于Reflection API取得任何类的内部信息，并能直接操作任意对象的内部属性及方法

  Class c = Class.forName("javax.lang.String")
  

• 加载完类之后，在堆内存的方法区中就产生了一个Class类型的对象（一个类只有一个Class对象），这个对象就包含了完整的类的结构信息；可以提供这个对象看到类的结构，这个对象就像一面镜子，透过这个镜子看到类的结构，所以，我们现象的称之为：反射

三、Java反射机制研究及应用

Java反射机制提供的功能

• 在运行时判断任意一个对象所属的类
• 在运行时构造任意一个类的对象
• 在运行时判断任意一个类所具有的成员变量和方法
• 在运行时获取泛型信息
• 在运行时调用任意一个对象的成员变量和方法
• 在运行时处理注解
• 生成动态代理
• ……

四、Java反射优点和缺点

优点：

• 可以实现动态创建对象和编译，体现出很大的灵活性

缺点：

• 对性能有影响。使用反射基本上是一种解释操作，我们可以告诉JVM，我们希望做什么并且它满足我们的要求，这类操作总是慢于直接执行相同的操作

五、反射相关的注意API

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

package com.kongbai.reflection;

/**
 * @author kongbai
 * @version 1.0.0
 * @ClassName Test02.java
 * @Description 反射
 * @createTime 2022年04月21日 15:06:00
 */
public class Test02 {
   
    public static void main(String[] args) throws ClassNotFoundException {
   
        //提过反射获取类的class对象
        Class c1 = Class.forName("com.kongbai.reflection.User");
        System.out.println(c1);

        Class c2 = Class.forName("com.kongbai.reflection.User");
        Class c3 = Class.forName("com.kongbai.reflection.User");
        Class c4 = Class.forName("com.kongbai.reflection.User");

        //一个类在内存中只有一个class对象
        //一个类被加载后，类的整个结构都会被封在class对象中
        System.out.println(c2.hashCode());
        System.out.println(c3.hashCode());
        System.out.println(c4.hashCode());
    }
}

//实体类(只有一些属性） 最后的属性会和数据库映射，那就是一个真正的实体类，一般使用pojo或entity
class User {
   
    private String name;
    private int id;
    private int age;

    //无参构造
    public User() {
   
    }

    //有参构造
    public User(String name, int id, int age) {
   
        this.name = name;
        this.id = id;
        this.age = age;
    }

    public String getName() {
   
        return name;
    }

    public void setName(String name) {
   
        this.name = name;
    }

    public int getId() {
   
        return id;
    }

    public void setId(int id) {
   
        this.id = id;
    }

    public int getAge() {
   
        return age;
    }

    public void setAge(int age) {
   
        this.age = age;
    }

    @Override
    public String toString() {
   
        return "User{" +
                "name='" + name + '\'' +
                ", id=" + id +
                ", age=" + age +
                '}';
    }
}

六、Class类

在Object类中定义了以下的方法，此方法将被所有子类继承

public final Class getClass()

以上的方法返回值的类型是一个Class类，此类是Java反射的源头，实际上所谓反射从程序的运行结果来看也很好理解，即：可以通过对象反射求出类的名称