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) | 返回描述指定修饰符中的访问修饰符标志的字符串。 |
以上是 Java反射API研究(4)——Class中的重要对象 的全部内容, 来源链接: utcz.com/z/391920.html