Java反射API研究(4)——Class中的重要对象

一、Constructor与Method的父类：Executable

　　Executable表示一个可执行类，构造方法与普通方法都是Executable

AnnotatedType[]	getAnnotatedExceptionTypes()
AnnotatedType[]	getAnnotatedParameterTypes()
AnnotatedType	getAnnotatedReceiverType()
abstract AnnotatedType	getAnnotatedReturnType()
<T extends Annotation> T	getAnnotation(Class<T> annotationClass)
<T extends Annotation> T[]	getAnnotationsByType(Class<T> annotationClass)
Annotation[]	getDeclaredAnnotations()
abstract Class<?>	getDeclaringClass()	返回 Class 对象，该对象表示声明由此Executable对象表示的类。
abstract Class<?>[]	getExceptionTypes()	返回一组表示声明要抛出的异常类型的 Class 对象，这些异常是由此Executable对象表示的底层方法抛出的。
Type[]	getGenericExceptionTypes()	返回一组 Type 对象，这些对象表示声明要由此Executable对象抛出的异常。
Type[]	getGenericParameterTypes()	按照声明顺序返回一组 Type 对象，这些对象表示此Executable对象所表示的方法的形参类型。
abstract int	getModifiers()	以整数形式返回此Executable对象所表示构造方法的 Java 语言修饰符。
abstract String	getName()	以字符串形式返回此构造方法的名称。
abstract Annotation[][]	getParameterAnnotations()	按照声明顺序返回一组数组，这些数组表示通过此Executable对象表示的方法的形参上的注释。
int	getParameterCount()	返回参数数量
Parameter[]	getParameters()	返回该Executable对象上所有的参数对象
abstract Class<?>[]	getParameterTypes()	按照声明顺序返回一组Class对象，这些对象表示此Executable对象所表示构造方法的形参类型。
abstract TypeVariable<?>[]	getTypeParameters()	按照声明顺序返回一组 TypeVariable 对象，这些对象表示通过此 GenericDeclaration 对象所表示的一般声明来声明的类型变量。
boolean	isSynthetic()	如果此Executable是一个复合方法，则返回 true；否则返回 false。
boolean	isVarArgs()	如果声明此构造方法可以带可变数量的参数，则返回 true；否则返回 false。
abstract String	toGenericString()	返回描述此Executable的字符串,其中包括类型参数。

二、Constructor<T>

Constructor<T>
boolean	equals(Object obj)
AnnotatedType	getAnnotatedReceiverType()
AnnotatedType	getAnnotatedReturnType()
<T extends Annotation> T	getAnnotation(Class<T> annotationClass)
Annotation[]	getDeclaredAnnotations()
Class<T>	getDeclaringClass()
Class<?>[]	getExceptionTypes()
Type[]	getGenericExceptionTypes()
Type[]	getGenericParameterTypes()
int	getModifiers()
String	getName()
Annotation[][]	getParameterAnnotations()
int	getParameterCount()
Class<?>[]	getParameterTypes()
TypeVariable<Constructor<T>>[]	getTypeParameters()
int	hashCode()
boolean	isSynthetic()
boolean	isVarArgs()
T	newInstance(Object... initargs)	使用此 Constructor 对象表示的构造方法来创建该构造方法的声明类的新实例，并用指定的初始化参数初始化该实例。
String	toGenericString()	返回描述此 Constructor 的字符串，其中包括类型参数。

　　类的构造器对象，通过Class对象的getConstructors()、getConstructor(Class<?>... parameterTypes)（只返回public的构造方法），getDeclaredConstructor(Class<?>... parameterTypes)、getDeclaredConstructors()（可包括非public构造方法）获取。

　　重要方法是newInstance(Object... initargs)，这个可以用于调用非默认构造方法来创建该类的实例。

　　对于不可访问的非public方法，可以调用父类AccessibleObject的setAccessible(boolean flag) 方法来强制访问。

三、Method

boolean	equals(Object obj)
AnnotatedType	getAnnotatedReturnType()
<T extends Annotation> T	getAnnotation(Class<T> annotationClass)
Annotation[]	getDeclaredAnnotations()
Class<?>	getDeclaringClass()
Object	getDefaultValue()	返回由此 Method 实例表示的注释成员的默认值。
Class<?>[]	getExceptionTypes()
Type[]	getGenericExceptionTypes()
Type[]	getGenericParameterTypes()
Type	getGenericReturnType()	返回表示由此 Method 对象所表示方法的正式返回类型的 Type 对象。
int	getModifiers()
String	getName()
Annotation[][]	getParameterAnnotations()
int	getParameterCount()
Class<?>[]	getParameterTypes()
Class<?>	getReturnType()	返回一个Class对象，该对象描述了此Method对象所表示的方法的正式返回类型。
TypeVariable<Method>[]	getTypeParameters()
int	hashCode()
Object	invoke(Object obj, Object... args)	对带有指定参数的指定对象调用由此 Method 对象表示的底层方法。
boolean	isBridge()	如果此方法是 bridge 方法，则返回 true；否则，返回 false。
boolean	isDefault()	是否是默认方法，对应于接口中的默认方法。
boolean	isSynthetic()
boolean	isVarArgs()
String	toGenericString()

　　关注其中的invoke(Object obj, Object... args)方法，第一个是要调用这个方法的对象，剩下的方法的参数，返回值就是该函数的返回值。

　　通过Class对象的getMethod(String name, Class<?>... parameterTypes)、getMethods()（包含继承的public方法）、getDeclaredMethod(String name, Class<?>... parameterTypes)、getDeclaredMethods()（不包含继承的方法，但包含非public方法）来返回该类的Method对象。

　　同样可调用setAccessible(boolean flag)来强制调用非public方法。

四、函数的参数Parameter对象

boolean	equals(Object obj)
AnnotatedType	getAnnotatedType()
<T extends Annotation> T	getAnnotation(Class<T> annotationClass)
Annotation[]	getAnnotations()
<T extends Annotation> T[]	getAnnotationsByType(Class<T> annotationClass)
<T extends Annotation> T	getDeclaredAnnotation(Class<T> annotationClass)
Annotation[]	getDeclaredAnnotations()
<T extends Annotation> T[]	getDeclaredAnnotationsByType(Class<T> annotationClass)
Executable	getDeclaringExecutable()	返回该参数所在的Executable对象
int	getModifiers()	返回该参数的标识符
String	getName()	返回该参数的名称
Type	getParameterizedType()	返回参数化类型
Class<?>	getType()	返回该参数的Class
int	hashCode()
boolean	isImplicit()	如果该参数在代码中是隐式声明的，则返回true，否则false。
boolean	isNamePresent()	该参数的名称是否保存在class文件中，需要编译时加参数-parameter
boolean	isSynthetic()
boolean	isVarArgs()

　　调用Executable对象的getParameters()方法来返回该可执行对象上的所有参数列表。

　　

五、Field对象

　　表示一个类中的属性

boolean	equals(Object obj)
Object	get(Object obj)	返回指定对象上此 Field 表示的字段的值。
AnnotatedType	getAnnotatedType()
<T extends Annotation> T	getAnnotation(Class<T> annotationClass)
<T extends Annotation> T[]	getAnnotationsByType(Class<T> annotationClass)
T	getT(Object obj)	获取一个静态或实例T类型的值。
Annotation[]	getDeclaredAnnotations()
Class<?>	getDeclaringClass()
Type	getGenericType()
int	getModifiers()
String	getName()
Class<?>	getType()	返回一个 Class 对象，它标识了此 Field 对象所表示字段的声明类型。
int	hashCode()
boolean	isEnumConstant()	如果此字段表示枚举类型的元素，则返回 true；否则返回 false。
boolean	isSynthetic()
void	set(Object obj, Object value)	将指定对象变量上此 Field 对象表示的字段设置为指定的新值。
void	setT(Object obj, T z)	将字段的值设置为指定对象上的一个T类型值。
String	toGenericString()

　　通过Class对象的getField(String name)、getFields()（包含继承的public属性）、getDeclaredField(String name)、getDeclaredFields()（本类的所有属性，包含非public的）来获取Field对象。

　　可调用setAccessible(boolean flag)来强制修改非public属性。

六、补充上面除了Parameter外其他几个的父类：AccessibleObject

<T extends Annotation> T	getAnnotation(Class<T> annotationClass)
<T extends Annotation> T	getDeclaredAnnotation(Class<T> annotationClass)
Annotation[]	getAnnotations()
Annotation[]	getDeclaredAnnotations()
<T extends Annotation> T[]	getAnnotationsByType(Class<T> annotationClass)
<T extends Annotation> T[]	getDeclaredAnnotationsByType(Class<T> annotationClass)
boolean	isAnnotationPresent(Class<? extends Annotation> annotationClass)
boolean	isAccessible()	获取此对象的 accessible 标志的值。
static void	setAccessible(AccessibleObject[] array, boolean flag)	使用单一安全性检查（为了提高效率）为一组对象设置 accessible 标志的便捷方法。
void	setAccessible(boolean flag)	将此对象的 accessible 标志设置为指示的布尔值。

七、数组相关类型Array 　　

static Object	get(Object array, int index)	返回指定数组对象中索引组件的值。
static T	getT(Object array, int index)	以T形式返回指定数组对象中索引组件的值。如果array不是T类型的，则get时进行扩展转换，但如果发生收缩转换，则抛出 IllegalArgumentException。
static int	getLength(Object array)	以int形式返回指定数组对象的长度。
static Object	newInstance(Class<?> componentType, int... dimensions)	创建一个具有指定的组件类型和维度的新数组。
static Object	newInstance(Class<?> componentType, int length)	创建一个具有指定的组件类型和长度的新数组。
static void	set(Object array, int index, Object value)	将指定数组对象中索引组件的值设置为指定的新值。
static void	setT(Object array, int index, T z)	将指定数组对象中索引组件的值设置为指定的新T值。如果array不是T类型的，则set时进行扩展转换，但如果发生收缩转换，则抛出 IllegalArgumentException。

八、修饰符Modifier

Modifier	还有同名常量	Modifier 类提供了static方法和常量，对类和成员访问修饰符进行解码。
static boolean	isAbstract(int mod)	整数参数是否包括 abstract 修饰符
static boolean	isFinal(int mod)	整数参数是否包括 final 修饰符
static boolean	isInterface(int mod)	整数参数是否包括 interface 修饰符
static boolean	isNative(int mod)	整数参数是否包括 native 修饰符
static boolean	isPrivate(int mod)	整数参数是否包括 private 修饰符
static boolean	isProtected(int mod)	整数参数是否包括 protected 修饰符
static boolean	isPublic(int mod)	整数参数是否包括 public 修饰符
static boolean	isStatic(int mod)	整数参数是否包括 static 修饰符
static boolean	isStrict(int mod)	整数参数是否包括 strictfp 修饰符
static boolean	isSynchronized(int mod)	整数参数是否包括 synchronized 修饰符
static boolean	isTransient(int mod)	整数参数是否包括 transient 修饰符
static boolean	isVolatile(int mod)	整数参数是否包括 volatile 修饰符
static String	toString(int mod)	返回描述指定修饰符中的访问修饰符标志的字符串。