注解与反射
注解
java注解(Annotation)又称java标注,是java JDK 1.5引入的一种注解记住。注解是元数据的一种形式。提供有关于程序但不属于程序本身的数据。注解对他们注解的代码没有直接影响。java中所有的注解默认继承Annotation接口
注解的使用
定义注解
声明一个class不同的是,注解的声明使用@interface关键字 如:
public @interface Test{
}
元注解
在定义时,注解类也可以使用其他的注解声明。对注解类型进行注解的注解类,我们称之为meta-annotaion(元注解)。一般的,我们在自定义注解时需要指定的元注解有两个@Target和@Retention:
@Target
注解标记另一个注解,以限制可以应用注解的 Java 元素类型。目标注解指定以下元素类型之一作为其值:
ElementType.ANNOTATION_TYPE 可以应用于注解类型。
ElementType.CONSTRUCTOR 可以应用于构造函数。
ElementType.FIELD 可以应用于字段或属性。
ElementType.LOCAL_VARIABLE 可以应用于局部变量。
ElementType.METHOD 可以应用于方法级注解。
ElementType.PACKAGE 可以应用于包声明。
ElementType.PARAMETER 可以应用于方法的参数。
ElementType.TYPE 可以应用于类的任何元素。
@Retention
注解指定标记注解的存储方式:
RetentionPolicy.SOURCE - 标记的注解仅保留在源级别中,并被编译器忽略。
RetentionPolicy.CLASS - 标记的注解在编译时由编译器保留,但 Java 虚拟机(JVM)会忽略。
RetentionPolicy.RUNTIME - 标记的注解由 JVM 保留,因此运行时环境可以使用它
注:@Retention 三个值中 SOURCE < CLASS < RUNTIME,即CLASS包含了SOURCE,RUNTIME包含 SOURCE、
列如:
//@Target(ElementType.TYPE) 只能在类上标记该注解 @Target({ElementType.TYPE,ElementType.FIELD}) // 允许在类与类属性上标记该注解 @Retention(RetentionPolicy.SOURCE) //注解保留在源码中
public @interface Test {
}
注解类型元素
在上文元注解中,允许在使用注解时传递参数。我们也能让自定义注解的主题包含annotation type element(注解类型元素)声明,他们看起来很像方法,可以定义可选的默认值 :
@Target({ElementType.TYPE,ElementType.FIELD}) //应用于类的任何元素,应用于字段和属性
@Retention(RetentionPolicy.SOURCE) //注解保留在源码中
public @interface Test {
String value(); //无默认值
int age() default 1; //有默认值
}
注意:在使用注解时,如果定义的注解中的类型元素无默认值,则必须进行传值。
@Test(“帅”) //如果只存在value元素需要传值的情况,则可以省略:元素名=
@Test(value=“帅”,age = 2)
int i;
在定义注解时如果注解的方法只有value方法时不需指定value = “xx” 的值如:
public @interface Test2 {
String value(); //无默认值
}
@Test2(“帅”)
int i;
注解使用场景
按照@Retention 元注解定义的注解存储方式,注解可以被在三种场景下使用:
SOURCE
RetentionPolicy.SOURCE ,作用于源码级别的注解,可提供给IDE语法检查、APT等场景使用
在类中使用 SOURCE 级别的注解,其编译之后的class中会被丢弃。
语法检查
限定方法参数的传入类型,一般的在定义方法时如:
public void test(int id){
}
此时调用方法test传入任意int类型的值都可以被接收test(1),这样是不行的,因为我希望传入的是R.id.xxx,修改test方法如下:
public void test( @IdRes int id){
}
此时只能传入R.id.xxx类型的值了。
APT注解处理器
APT全称为:“Anotation Processor Tools”,意为注解处理器。顾名思义,其用于处理注解。编写好的Java源文件,需要经过 javac 的编译,翻译为虚拟机能够加载解析的字节码Class文件。注解处理器是 javac 自带的一个工具,用来在编译时期扫描处理注解信息。你可以为某些注解注册自己的注解处理器。 注册的注解处理器由 javac调起,并将注解信息传递给注解处理器进行处理。注解处理器是对注解应用最为广泛的场景。在Glide、EventBus3、Butterknifer、Tinker、ARouter等等常用框架中都有注解处理器的身影。但是你可能会发现,这些框架中对注解的定义并不是 SOURCE 级别,更多的是 CLASS 级别,别忘了:CLASS包含了SOURCE,RUNTIME包含SOURCE、CLASS。关于注解处理器的实现,APT介绍
CLASS
定义为 CLASS 的注解,会保留在class文件中,但是会被虚拟机忽略(即无法在运行期反射获取注解)。此时完全符合此种注解的应用场景为字节码操作。如:AspectJ、热修复Roubust中应用此场景。
RUNTIME
注解保留至运行期,意味着我们能够在运行期间结合反射技术获取注解中的所有信息。
反射
一般的我们使用某个类时,必定知道它是什么类,用来作什么的,并且能过获得此类的引用。于是我们直接对这个类进行实例化,之后使用这个类对象进行操作。
反射则是一开始并不知道我要初始化的类对象是什么,自然也无法使用new关键字来创建对象,这时候我们使用JDK提供的反射API进行反射调用。反射就是在运行状态中,对于任意一个类,都能够知道这个类中的所有属性和方法;对于任意一个对象都能够调用它的任意方法和属性;并且能改变它的属性。是java被视为动态语言的关键。
java反射机制主要提供一下功能:
1,在运行时构建任意一个类的对象
2,在运行时获取或者修改任意一个类所具有的成员方法和变量
3,在运行时调用任意一个对象的方法(属性)
Class
反射始于Class,**Class是一个类,封装了当前对象所对应的类信息。**一个类中有属性,方法,构造器等,比如说有一个Person类,一个Food类,一个Book类,这些都是不同的类,现在需要一个类用来描述类这就是Class,他应该有类名,属性,方法构造器等,Class是用来描述类的类。
获得Class对象
获取Class对象的三种方式
1,通过类名获取 类名.class
2,通过对象获取 对象名.class
3,通过全类名获取 Class.forName(全类名) classLoader.loaderClass(全类名)
使用Class的forName静态方法
public static Class<?> forName(String className)
直接获取某一个对象的class
Class<?>klass = int.class;
Class<?>intClass = Integer.TYPE;
调用某个对象的 getClass() 方法
StringBuilder str = new StringBuilder(“123”);
Class<?> klass = str.getClass();
判断是否为某个类的实例
一般的我们使用 instanceof 关键字来判断是否为某个类的实例。同时我们也可以借助反射中Class对象的isInstance()方法来判断是否为某个类的实例,这是一个native方法
public native boolean isInstance(Object obj);
判断是否为某个类的类型
public boolean isAssignableFrom(Class<?> cls)
创建实例
通过反射来生成对象主要有两种方式。
1,使用Class对象的newInstance()方法来创建Class对象对应类的实例
Class<?> c = String.class;
Object str = c.newInstance();
2,先通过Class对象获取指定的Constructor 对象的newInstance()方法来创建实例这种方法可以用指定的构造器构造类的实例
//获取String所对应的Class对象
Class<?> c = String.class;
//获取String类带一个String参数的构造器
Constructor constructor = c.getConstructor(String.class);
//根据构造器创建实例
Object obj = constructor.newInstance(“11111”); System.out.println(obj);
获取构造器信息
得到构造器的方法
Constructor getConstructor(Class[] params) – 获得使用特殊的参数类型的public构造函数(包括父类) Constructor[] getConstructors() – 获得类的所有公共构造函数 Constructor getDeclaredConstructor(Class[] params) – 获得使用特定参数类型的构造函数(包括私有) Constructor[] getDeclaredConstructors() – 获得类的所有构造函数(与接入级别无关)
获取类构造器的用法与上述获取方法的用法类似。主要是通过Class类的getConstructor方法得到Constructor类的
一个实例,而Constructor类有一个newInstance方法可以创建一个对象实例:
public T newInstance(Object … initargs)
获取类的成员变量(字段)信息
获得方法信息的方法
Field getField(String name) – 获得命名的公共字段
Field[] getFields() – 获得类的所有公共字段
Field getDeclaredField(String name) – 获得类声明的命名的字段
Field[] getDeclaredFields() – 获得类声明的所有字段
当我们从类中获取了一个方法后,我们就可以用 invoke() 方法来调用这个方法。 invoke 方法的原型为:
public Object invoke(Object obj, Object… args)
利用反射创建数组
数组在Java里是比较特殊的一种类型,它可以赋值给一个Object Reference 其中的Array类为
java.lang.reflect.Array类。我们通过Array.newInstance()创建数组对象,它的原型是:
public static Object newInstance(Class<?> componentType, int length);
反射获取泛型真实类型
当我们对一个泛型类进行反射时,需要的到泛型中的真实数据类型,来完成如json反序列化的操作。此时需要通过 Type 体系来完成。 Type 接口包含了一个实现类(Class)和四个实现接口,他们分别是:
TypeVariable
泛型类型变量。可以泛型上下限等信息;
ParameterizedType
具体的泛型类型,可以获得元数据中泛型签名类型(泛型真实类型)
GenericArrayType
当需要描述的类型是泛型类的数组时,比如List[],Map[],此接口会作为Type的实现。
WildcardType
通配符泛型,获得上下限信息;
java type的使用