compact1, compact2, compact3

java.lang

Class Class<T>

java.lang.Object

java.lang.Class<T>

参数类型

T -类仿照这个 类对象类型。例如，对 String.class类型 Class<String>。如果模拟的类是未知的 Class<?>。

All Implemented Interfaces:

Serializable， AnnotatedElement， GenericDeclaration， Type

public final class Class<T>
extends Object
implements Serializable, GenericDeclaration, Type, AnnotatedElement

类的实例代表一个运行 类 java应用程序的类和接口。枚举是一种阶级和注释是一种接口。每个数组属于一种体现为 类对象是所有数组的元素类型和维数的共享类。原始的java类型（ boolean， byte， char， short， int， long， float，和 double），和关键词 void也表示为 类对象。

类没有公共构造函数。相反类对象由java虚拟机自动构造当类被加载和调用方法的类装载器的defineClass。

下面的示例使用一个类对象将一个对象的类的名称：

     void printClassName(Object obj) {
         System.out.println("The class of " + obj +
                            " is " + obj.getClass().getName());
     }
 

它也可能为命名的类型得到类对象（或无效）使用类字面。看到The Java™ Language Specification部分15.8.2。例如:

System.out.println("The name of class Foo is: "+Foo.class.getName());

从以下版本开始：

JDK1.0

另请参见：

ClassLoader.defineClass(byte[], int, int)， Serialized Form

方法摘要

Modifier and Type	Method and Description
<U> 类<? extends U>	asSubclass(类<U> clazz) 把这 类对象代表通过指定类对象表示的类的子类。
T	cast(Object obj) 将对象转换为类或接口的 类对象表示。
boolean	desiredAssertionStatus() 返回将被分配给该类的断言状态，如果它在调用该方法时被初始化。
static 类<?>	forName(String className) 返回与给定的字符串名称的类或接口相关的 类对象。
static 类<?>	forName(String name, boolean initialize, ClassLoader loader) 返回 类对象相关的类或接口的给定的字符串名称，使用给定的类装载器。
AnnotatedType[]	getAnnotatedInterfaces() 返回表示指定的类型 类对象表示的实体超接口的使用 AnnotatedType对象数组。
AnnotatedType	getAnnotatedSuperclass() 返回一个 AnnotatedType表示指定类型的对象表示的实体 类父类的使用。
<A extends Annotation> A	getAnnotation(类<A> annotationClass) 如果存在此注释，则返回此元素的指定类型的注释，否则为空。
Annotation[]	getAnnotations() 返回此元素上的注释。
<A extends Annotation> A[]	getAnnotationsByType(类<A> annotationClass) 返回与此元素关联的注释。
String	getCanonicalName() 返回规范名称的底层阶级的java语言规范定义。
类<?>[]	getClasses() 返回一个数组包含代表所有的公共类和接口的 类对象表示的类成员 类对象。
ClassLoader	getClassLoader() 返回类的类装载器。
类<?>	getComponentType() 返回表示数组的组件类型的 类。
Constructor<T>	getConstructor(类<?>... parameterTypes) 返回一个 Constructor对象反映指定的公共构造函数的 类对象表示的类。
Constructor<?>[]	getConstructors() 返回一个数组包含 Constructor物体反射所有的 类对象表示的类的公共构造函数。
<A extends Annotation> A	getDeclaredAnnotation(类<A> annotationClass) 返回此元素的指定类型的注释，如果这样的注释是直接存在的，否则为空。
Annotation[]	getDeclaredAnnotations() 返回直接在该元素上的注释。
<A extends Annotation> A[]	getDeclaredAnnotationsByType(类<A> annotationClass) 如果这样的注释直接存在或间接存在，则返回指定类型的该元素的注释（s）。
类<?>[]	getDeclaredClasses() 返回一个数组 类物体反射所有的类和接口声明为这 类对象表示的类成员。
Constructor<T>	getDeclaredConstructor(类<?>... parameterTypes) 返回一个 Constructor对象反映指定的构造函数的类或接口的 类对象表示。
Constructor<?>[]	getDeclaredConstructors() 返回 Constructor物体反射所有的构造函数通过 类对象表示的类中声明一个数组。
Field	getDeclaredField(String name) 返回一个对象，反映了 Field指定声明字段的类或接口的 类对象表示。
Field[]	getDeclaredFields() 返回 Field物体反射所有字段的类或接口的 类对象表示声明数组。
方法	getDeclaredMethod(String name, 类<?>... parameterTypes) 返回一个 方法对象反映指定声明方法的类或接口的 类对象表示。
方法[]	getDeclaredMethods() 返回一个数组包含 方法物体反射所有声明的方法的类或接口的 类对象，代表包括公众、保护，默认（包）的访问，和私有方法，但不包括继承的方法。
类<?>	getDeclaringClass() 如果该类或接口的 类对象代表的是另一个类的一个成员，返回表示它的类被宣布 类对象。
类<?>	getEnclosingClass() 返回底层类的立即封闭类。
Constructor<?>	getEnclosingConstructor() 如果这 类对象代表在构造函数中局部或匿名类，返回表示立即封闭底层类的构造函数 Constructor对象。
方法	getEnclosingMethod() 如果这 类对象表示方法内的局部或匿名类，返回表示立即封闭底层类的方法 方法对象。
T[]	getEnumConstants() 返回此枚举类或空的元素，如果这类对象并不代表一个枚举类型。
Field	getField(String name) 返回一个 Field对象反映的类或接口的 类对象表示的指定公共成员。
Field[]	getFields() 返回一个数组包含 Field物体反射的类或接口的 类对象代表所有可访问的公共领域。
Type[]	getGenericInterfaces() 返回表示接口，通过该对象表示的类或接口直接实现的 Types。
Type	getGenericSuperclass() 返回表示实体的直接父类的 Type（类、接口、简单类型或void）的 类代表。
类<?>[]	getInterfaces() 确定由该对象表示的类或接口实现的接口。
方法	getMethod(String name, 类<?>... parameterTypes) 返回一个 方法对象反映的类或接口的 类对象表示的指定公共成员方法。
方法[]	getMethods() 返回一个数组包含 方法物体反射所有的类或接口的 类对象表示的公共方法，包括那些由类或接口的超类和超接口继承的声明。
int	getModifiers() 返回该类或接口的java语言的修饰，在整数编码。
String	getName() 返回单位名称（类，接口，数组类，原始类型，或无效）的 类对象表示，作为一个 String。
软件包	getPackage() 获取此类的包。
ProtectionDomain	getProtectionDomain() 返回该类的 ProtectionDomain。
URL	getResource(String name) 查找给定名称的资源。
InputStream	getResourceAsStream(String name) 查找给定名称的资源。
Object[]	getSigners() 得到这类的签名。
String	getSimpleName() 返回在源代码中给定的底层类的简单名称。
类<? super T>	getSuperclass() 返回表示的实体（类、接口类的 类，原始类型或void）的 类代表。
String	getTypeName() 返回此类型的名称的信息字符串。
TypeVariable<类<T>>[]	getTypeParameters() 返回 TypeVariable对象表示的类型变量的声明通过 GenericDeclaration对象表示的泛型声明一个数组，在声明顺序。
boolean	isAnnotation() 如果这 类对象表示注释类型返回true。
boolean	isAnnotationPresent(类<? extends Annotation> annotationClass) 如果在这个元素上存在指定类型的注释，则返回真，否则为假。
boolean	isAnonymousClass() 返回 true当且仅当底层阶级是一个匿名类。
boolean	isArray() 决定如果这 类对象表示数组类。
boolean	isAssignableFrom(类<?> cls) 确定是否是相同的类或接口的 类对象表示，或是父类或超类或接口，由指定的 类参数表示。
boolean	isEnum() 如果这个类被声明为源代码中的枚举返回true。
boolean	isInstance(Object obj) 确定指定 Object是分配的 类表示的对象的兼容。
boolean	isInterface() 确定指定 类对象表示一个接口类型。
boolean	isLocalClass() 返回 true当且仅当底层的类是一个类。
boolean	isMemberClass() 返回 true当且仅当底层的类是一个类成员。
boolean	isPrimitive() 确定指定 类对象代表一个原始类型。
boolean	isSynthetic() 返回 true如果这个类是一个综合类；否则返回 false。
T	newInstance() 创建这个 类对象表示的类的一个新实例。
String	toGenericString() 返回一个描述这个 类字符串，包括修饰符和类型参数信息。
String	toString() 将对象转换为字符串。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

方法详细信息

toString

public String toString()

将对象转换为字符串。字符串表示为字符串“类”或“接口”，紧随其后的是一个空间，然后由该类的完全限定名的格式返回 getName。如果这 类对象代表一个原始类型，此方法返回的原始类型的名称。如果这 类对象表示无效，此方法返回“无效”。

重写：

toString 方法重写，继承类 Object

结果

这个类对象的字符串表示。

toGenericString

public String toGenericString()

返回一个描述这个 类字符串，包括修饰符和类型参数信息。字符串格式化为列表类型修饰符，如果有的话，其次是那种类型（原始类型和 class， 枚举， interface，或 @ interface，适当的空字符串），其次是类型的名称，后跟一个角括号逗号分隔的类型的类型参数列表，如果任何。一个空格用来分隔修饰语，并从一种类型中分离任何修饰语。的改性剂发生在典型的顺序。如果有任何类型的参数，该类型参数列表是省略。

请注意，由于正在生成一个类型的运行时表示的信息，不存在于源代码或源代码上的非法的改性剂可能存在。

结果

描述 类字符串，包括修饰符和类型参数信息

从以下版本开始：

一点八

forName

public static 类<?> forName(String className)
                        throws ClassNotFoundException

返回与给定的字符串名称的类或接口相关的 类对象。调用此方法等效于：

Class.forName(className, true, currentLoader)

哪里 currentLoader表示当前类的类装载器的定义。

例如，下面的代码片段返回运行时类描述符指定的类java.lang.Thread：

Class t = Class.forName("java.lang.Thread")

一个叫forName("X")导致阶级命名X被初始化。

参数

className -所需的类的完全限定名。

结果

具有指定名称的类的 类对象。

异常

LinkageError如果连接失败

ExceptionInInitializerError -如果该方法激发的初始化失败

ClassNotFoundException -如果类不能定位

forName

public static 类<?> forName(String name,
                               boolean initialize,
                               ClassLoader loader)
                        throws ClassNotFoundException

返回 类对象相关的类或接口的给定的字符串名称，使用给定的类装载器。一个类或接口的完全限定名称（在相同的格式返回 getName）这种方法尝试定位、负载和链路的类或接口。指定的类加载程序用于加载类或接口。如果参数 loader是空的，类的加载通过引导类加载器。类的初始化只有 initialize参数 true如果没有初始化之前。

如果name表示简单类型或无效，将尝试在未命名的包的名字是name定位一个用户定义的类。因此，这种方法不能用来获得任何代表原始类型或无效的类对象。

如果name表示数组类，数组类的成员类型加载但未初始化。

例如，在一个实例方法中表达式：

Class.forName("Foo")

等价于：

Class.forName("Foo", true, this.getClass().getClassLoader())

注意该方法抛出相关的加载错误、链接或初始化为指定的部分12.2，12.3和12.4的java语言规范。请注意，此方法不检查所请求的类是否可以访问它的调用方。

如果loader是null，和安全管理器，和调用者的类装载器是无效的，那么这个方法调用一个RuntimePermission("getClassLoader")权限以确保可以访问引导类加载器的安全经理的checkPermission方法。

参数

所需的类的完全限定名 name -

initialize -如果 true类将被初始化。看到java语言规范12.4节。

loader -类装载器的类必须装

结果

表示所需类的类对象

异常

LinkageError如果连接失败

ExceptionInInitializerError -如果该方法激发的初始化失败

ClassNotFoundException -如果类不能被指定的类装载器位于

从以下版本开始：

一点二

另请参见：

forName(String)， ClassLoader

newInstance

public T newInstance()
              throws InstantiationException,
                     IllegalAccessException

创建这个 类对象表示的类的一个新实例。实例化类似用一个空的参数列表 new表达。如果没有初始化已初始化的类，则初始化。

注意，这种方法传播的默认构造函数抛出的任何异常，包括一个检查的异常。使用这种方法有效地绕过编译时的异常检查，否则将被编译器执行的。的Constructor.newInstance方法用任何例外在构造函数抛出的避免了这个问题（检查）InvocationTargetException。

结果

由该对象表示的类的一个新分配的实例。

异常

IllegalAccessException如果类或其默认构造函数不可访问。

InstantiationException -如果这 类表示一个抽象类，接口，数组类，原始类型，或无效；或如果该类没有默认构造函数；或者因为其他原因不能实例化。

ExceptionInInitializerError -如果该方法激发的初始化失败。

SecurityException如果安全管理器、空值、存在和调用者的类装载器是不一样的或祖先的类装载器的类和调用 s.checkPackageAccess()拒绝访问该类的包。

isInstance

public boolean isInstance(Object obj)

确定指定 Object是分配的 类表示的对象的兼容。这种方法是java语言的 instanceof算子的动态等值。该方法返回 true如果指定 Object争论是非空的，可以转换为代表的这一 类对象而提高了 ClassCastException.返回 false否则引用类型。

具体来说，如果这类对象代表一个类声明，如果指定的Object参数是代表类的一个实例方法返回true（或其任何子类）；它返回false否则。如果这类对象表示数组类，此方法返回true如果指定Object论点可以被转换成由身份转换的数组类的一个对象或一个拓宽引用转换；它返回false否则。如果这类对象表示一个接口，此方法返回true如果类或超类的指定Object参数实现此接口；它返回false否则。如果这类对象代表一个原始类型，此方法返回false。

参数

obj -检查对象

结果

如果 obj是这个类的实例

从以下版本开始：

JDK1.1

isAssignableFrom

public boolean isAssignableFrom(类<?> cls)

确定是否是相同的类或接口的 类对象表示，或是父类或超类或接口，由指定的 类参数表示。它返回 true如果如此；否则返回 false。如果这 类对象代表一个原始类型，此方法返回 true如果指定 类参数正是这 类对象；否则返回 false。

具体而言，该方法测试是否由指定的类参数表示的类型可以转换为类型的类对象表示通过身份转换或通过拓宽引用转换。查看java语言规范5.1.1和5.1.4节详情。

参数

cls - 类对象进行检查

结果

指示是否 cls类型的对象可以被分配到这个类的对象的 boolean价值

异常

NullPointerException -如果指定类参数为空。

从以下版本开始：

JDK1.1

isInterface

public boolean isInterface()

确定指定 类对象表示一个接口类型。

结果

true如果该对象表示一个接口； false否则。

isArray

public boolean isArray()

决定如果这 类对象表示数组类。

结果

true如果该对象表示数组类； false否则。

从以下版本开始：

JDK1.1

isPrimitive

public boolean isPrimitive()

确定指定 类对象代表一个原始类型。

有九个预定义的类对象代表八种基本类型无效。这些是由java虚拟机创建的，并具有相同的名称，它们代表原始类型，即boolean，byte，char，short，int，long，float，和double。

这些对象只能够通过公共静态变量访问，并且是唯一的类对象，该方法返回true。

结果

如果只有这个类表示原始类型，则为真

从以下版本开始：

JDK1.1

另请参见：

Boolean.TYPE， Character.TYPE， Byte.TYPE， Short.TYPE， Integer.TYPE， Long.TYPE， Float.TYPE， Double.TYPE， Void.TYPE

isAnnotation

public boolean isAnnotation()

如果这 类对象表示注释类型返回true。注意，如果此方法返回true， isInterface()也会返回true，所有标注类型也接口。

结果

true该Class对象是否表示注释类型； false否则

从以下版本开始：

一点五

isSynthetic

public boolean isSynthetic()

返回 true如果这个类是一个综合类；否则返回 false。

结果

true当且仅当这个类是一个综合类的java语言规范定义。

从以下版本开始：

一点五

See The Java™ Language Specification:

13.1二进制的形式

getName

public String getName()

返回单位名称（类，接口，数组类，原始类型，或无效）的 类对象表示，作为一个 String

如果这个类的对象代表一个引用类型，而不是数组类型，则该类的二进制名称返回指定的The Java™ Language Specification。

如果该类对象表示简单类型或无效，那么返回的名称是一个String等于相应简单类型或无效的java语言的关键字。

如果这个类对象代表一个类的数组，然后名称的内部形式由元素类型的前面由一个或多个“[ '字代表数组的嵌套深度的名字。元素类型名称的编码如下：

Element Type		Encoding
boolean		Z
byte		B
char		C
class or interface		Lclassname;
double		D
float		F
int		I
long		J
short		S

类或接口的名称是空类的名称上面指定的类的二进制名称。

实例：

 String.class.getName()
     returns "java.lang.String"
 byte.class.getName()
     returns "byte"
 (new Object[3]).getClass().getName()
     returns "[Ljava.lang.Object;"
 (new int[3][4][5][6][7][8][9]).getClass().getName()
     returns "[[[[[[[I"
 

。

结果

由该对象表示的类或接口的名称。

getClassLoader

public ClassLoader getClassLoader()

返回类的类装载器。一些实现可能使用“空”来表示引导类加载程序。此方法将返回在这样的实现中，如果这个类是由引导类加载程序加载的空。

如果安全管理器，和调用者的类装载器是无效的和调用者的类装载器是不一样的或祖先类请求其类加载器的类装载器，那么这个方法调用一个RuntimePermission("getClassLoader")权限以确保可以访问该类的类装载器保安部经理的checkPermission方法。

如果此对象表示一个原始类型或空，则返回。

结果

加载由该对象表示的类或接口的类装载器。

异常

SecurityException -如果存在一个安全管理及其 checkPermission方法拒绝访问该类的类加载器。

另请参见：

ClassLoader， SecurityManager.checkPermission(java.security.Permission)， RuntimePermission

getTypeParameters

public TypeVariable<类<T>>[] getTypeParameters()

返回表示该类型声明的变量通过 GenericDeclaration对象表示的泛型声明 TypeVariable对象的数组，在声明顺序。返回一个长度为0的数组，如果下一个基本的泛型声明声明没有类型变量。

Specified by:

getTypeParameters 接口 GenericDeclaration

结果

对 TypeVariable对象表示的类型的变量声明的泛型声明数组

异常

GenericSignatureFormatError -如果这个泛型声明泛型签名不符合规定的格式，在 The Java™ Virtual Machine Specification

从以下版本开始：

一点五

getSuperclass

public 类<? super T> getSuperclass()

返回表示的实体（类、接口类的 类，原始类型或void）的 类代表。如果这 类要么表现的 Object类、接口、简单类型或无效，则返回null。如果该对象表示数组类则代表 Object班 类对象返回。

结果

该对象表示的类的父类。

getGenericSuperclass

public Type getGenericSuperclass()

返回表示实体的直接父类的 Type（类、接口、简单类型或void）的 类代表。

如果父类是参数化类型，返回的Type对象必须准确地反映源代码中使用的实际类型参数。代表父类的参数类型是如果没有被创建之前创建的。看到为参数化类型的创造过程的语义ParameterizedType宣言。如果这类要么表现的Object类、接口、简单类型或无效，则返回null。如果该对象表示数组类则代表Object班类对象返回。

结果

该对象表示的类的父类

异常

GenericSignatureFormatError如果泛型类签名不符合规定的格式，在 The Java™ Virtual Machine Specification

TypeNotPresentException如果泛型类是指一个不存在的类型声明

MalformedParameterizedTypeException如果通用的父类是参数化类型，不能实例化的任何理由

从以下版本开始：

一点五

getPackage

public 软件包 getPackage()

获取此类的包。这个类的类装载器被用来查找包。如果类被加载从CLASSPATH中引导类加载器加载查找该类的包。如果这个类的类装载器创建了包对象，则返回空值。

只有当在“伴随类”的清单中定义了信息，并且如果类装载器创建了包实例与属性从清单中的属性时，包才有版本和规范的属性。

结果

该类的包，或空如果没有包的信息可从档案或代码库。

getInterfaces

public 类<?>[] getInterfaces()

确定由该对象表示的类或接口实现的接口。

如果这个对象表示一个类，返回值是一个数组，包含表示类实现的所有接口的对象。在数组中对应的该对象表示的类声明的implements条款的接口名称顺序接口对象的顺序。例如，给出了声明：

class Shimmer implements FloorWax, DessertTopping { ... }

假设 s价值是 Shimmer实例；表达式的值：

s.getClass().getInterfaces()[0]

是代表 FloorWax 类接口的对象；和值：

s.getClass().getInterfaces()[1]

是代表 DessertTopping 类接口的对象。

如果此对象表示一个接口，该数组包含表示接口扩展的所有接口的对象。在数组中对应的该对象表示的接口声明的extends条款的接口名称顺序接口对象的顺序。

如果这个对象表示一个实现没有接口的类或接口，则该方法返回一个长度为0的数组。

如果这个对象表示一个原始类型或空白，则该方法返回一个长度为0的数组。

如果这类对象代表数组类型，接口Cloneable和java.io.Serializable在顺序返回。

结果

由这个类实现的一个接口数组。

getGenericInterfaces

public Type[] getGenericInterfaces()

返回表示接口，通过该对象表示的类或接口直接实现的 Types。

如果一个超是一个参数化类型的对象，Type返回它必须准确地反映源代码中使用的实际类型参数。代表每个超参数类型是如果没有被创建之前创建的。看到为参数化类型的创造过程的语义ParameterizedType宣言。

如果这个对象表示一个类，返回值是一个数组，包含表示类实现的所有接口的对象。在数组中对应的该对象表示的类声明的implements条款的接口名称顺序接口对象的顺序。在数组的类，接口Cloneable和Serializable在顺序返回。

如果此对象表示一个接口，该数组包含表示接口直接扩展的所有接口的对象。在数组中对应的该对象表示的接口声明的extends条款的接口名称顺序接口对象的顺序。

如果这个对象表示一个实现没有接口的类或接口，则该方法返回一个长度为0的数组。

如果这个对象表示一个原始类型或空白，则该方法返回一个长度为0的数组。

结果

由这个类实现的一个接口数组

异常

GenericSignatureFormatError如果泛型类签名不符合规定的格式，在 The Java™ Virtual Machine Specification

TypeNotPresentException -如果任何通用的超接口是指一个不存在的类型声明

MalformedParameterizedTypeException -如果任何通用的超接口指的是参数化类型，不能实例化的任何理由

从以下版本开始：

一点五

getComponentType

public 类<?> getComponentType()

返回 类表示数组的组件类型。如果这个类不代表一个数组类，则此方法返回空。

结果

代表这个类的组件类型如果这个类是一个数组的 类

从以下版本开始：

JDK1.1

另请参见：

Array

getModifiers

public int getModifiers()

返回该类或接口的java语言的修饰，在整数编码。改性剂是由java虚拟机的常数 public， protected， private， final， static， abstract和 interface；他们应该使用类的方法 Modifier解码。

如果基础类的数组类，那么它的public，private和protected修饰符的组件类型相同。如果这类表示简单类型或无效，其public修饰符总是true，及其protected和private修饰符总是false。如果该对象表示数组类，简单类型或无效的，那么它的final修饰符总是true及其界面改性剂总是false。其他修饰符的值在规范中未确定。

修改编码是在java虚拟机的规范定义，表4.1。

结果

代表这个类的修饰符 int

从以下版本开始：

JDK1.1

另请参见：

Modifier

getSigners

public Object[] getSigners()

得到这类的签名。

结果

这类的签名，如果没有签名或空。特别是，该方法返回空，如果这个对象代表一个原始类型或无效。

从以下版本开始：

JDK1.1

getEnclosingMethod

public 方法 getEnclosingMethod()
                          throws SecurityException

如果这 类对象表示方法内的局部或匿名类，返回表示立即封闭底层类的方法 方法对象。返回 null否则。特别是，该方法返回 null如果基础班是一个局部或匿名类立即封闭的类型声明，实例初始化或静态初始化器。

结果

立即封闭底层类的方法，如果这类局部或匿名类；否则 null。

异常

SecurityException如果安全管理器，空值，是目前任何满足以下条件：

• 调用者的类装载器是不一样的类装载器外围类的方法调用和s.checkPermission RuntimePermission("accessDeclaredMembers")否认在外围类的方法访问
• 调用者的类装载器是不一样的或祖先的类装载器的外围类的调用和s.checkPackageAccess()拒绝访问外围类的封装

从以下版本开始：

一点五

getEnclosingConstructor

public Constructor<?> getEnclosingConstructor()
                                       throws SecurityException

如果这 类对象代表在构造函数中局部或匿名类，返回表示立即封闭底层类的构造函数 Constructor对象。返回 null否则。特别是，该方法返回 null如果基础班是一个局部或匿名类立即封闭的类型声明，实例初始化或静态初始化器。

结果

立即封闭底层类的构造函数，如果类是局部或匿名类；否则 null。

异常

SecurityException如果安全管理器，空值，是目前任何满足以下条件：

• 调用者的类装载器是不一样的类装载器外围类的方法调用和s.checkPermission RuntimePermission("accessDeclaredMembers")否认在外围类的构造函数的访问
• 调用者的类装载器是不一样的或祖先的类装载器的外围类的调用和s.checkPackageAccess()拒绝访问外围类的封装

从以下版本开始：

一点五

getDeclaringClass

public 类<?> getDeclaringClass()
                           throws SecurityException

如果该类或接口的 类对象代表的是另一个类的一个成员，返回表示它的类被宣布 类对象。如果这个类或接口不是任何其他类的成员，此方法将返回为空。如果这 类对象表示数组类，原始类型，或无效，则该方法返回null。

结果

这个类的声明类

异常

SecurityException如果安全管理器、空值、存在和调用者的类装载器是不一样的或祖先的类装载器用于声明类和调用 s.checkPackageAccess()拒绝访问声明类的封装

从以下版本开始：

JDK1.1

getEnclosingClass

public 类<?> getEnclosingClass()
                           throws SecurityException

返回底层类的立即封闭类。如果基础班是一个顶级类此方法返回 null。

结果

底层类的立即封闭类

异常

SecurityException如果安全管理器、空值、存在和调用者的类装载器是不一样的或祖先的类装载器的外围类的调用和 s.checkPackageAccess()拒绝访问外围类的封装

从以下版本开始：

一点五

getSimpleName

public String getSimpleName()

返回在源代码中给定的底层类的简单名称。如果底层类是匿名的，则返回一个空字符串。

数组的简单名称是“添加”的组件类型的简单名称。特别是，一个组件类型为匿名的数组的简单名称是“[ ]”。

结果

底层类的简单名称

从以下版本开始：

一点五

getTypeName

public String getTypeName()

返回此类型的名称的信息字符串。

Specified by:

getTypeName 接口 Type

结果

用于此类型的名称的信息字符串

从以下版本开始：

一点八

getCanonicalName

public String getCanonicalName()

返回规范名称的底层阶级的java语言规范定义。返回空，如果底层类没有一个规范名称（即，如果它是一个本地或匿名类或一个组件类型没有一个规范名称的数组）。

结果

下面的类的名称如果它存在，否则， null。

从以下版本开始：

一点五

isAnonymousClass

public boolean isAnonymousClass()

返回 true当且仅当底层阶级是一个匿名类。

结果

true当且仅当这个类是一个匿名类。

从以下版本开始：

一点五

isLocalClass

public boolean isLocalClass()

返回 true当且仅当底层的类是一个类。

结果

true当且仅当这个类是一个类。

从以下版本开始：

一点五

isMemberClass

public boolean isMemberClass()

返回 true当且仅当底层的类是一个类成员。

结果

true当且仅当这个类是一个类成员。

从以下版本开始：

一点五

getClasses

public 类<?>[] getClasses()

返回一个数组包含代表所有的公共类和接口的 类对象表示的类成员 类对象。这包括公共类和接口成员的声明的类从父类继承的公共类和接口成员。如果这 类对象没有公共成员类或接口，方法返回的数组长度为0。此方法返回的数组长度也为0如果这 类对象表示简单类型、数组类，或无效。

结果

代表该类的公共成员 类对象数组

异常

SecurityException如果安全管理器、空值、存在和调用者的类装载器是不一样的或祖先的类装载器的类和调用 s.checkPackageAccess()拒绝访问该类的包。

从以下版本开始：

JDK1.1

getFields

public Field[] getFields()
                  throws SecurityException

返回一个数组包含 Field物体反射的类或接口的 类对象代表所有可访问的公共领域。

如果这类对象表示的类或接口没有开放的公共领域，那么这个方法返回的数组长度为0。

如果这类对象代表一个类，那么这个方法返回类和其所有父类的公共领域。

如果这类对象表示一个接口，那么这个方法返回的接口和它所有的超接口等。

如果这类对象代表数组类型，原始类型，或无效，则该方法返回的数组长度为0。

返回的数组中的元素没有排序，并没有在任何特定的顺序。

结果

代表公共领域 Field对象数组

异常

SecurityException如果安全管理器、空值、存在和调用者的类装载器是不一样的或祖先的类装载器的类和调用 s.checkPackageAccess()拒绝访问该类的包。

从以下版本开始：

JDK1.1

See The Java™ Language Specification:

8.2类成员，8.3场声明

getMethods

public 方法[] getMethods()
                    throws SecurityException

返回一个数组包含 方法物体反射所有的类或接口的 类对象表示的公共方法，包括那些由类或接口的超类和超接口继承的声明。

如果这类对象代表一个类有多个公共方法具有相同的名称和参数类型，但不同的返回类型，那么返回的数组的每一个这样的方法方法对象。

如果这类对象代表一个类的初始化方法<clinit>类型，然后返回的数组没有相应的方法对象。

如果这类对象代表数组类型，那么返回的数组为每个由Object数组类型继承的公共方法方法对象。它不包含clone()一方法对象。

如果这类对象表示一个接口然后返回的数组不包含任何隐式声明的方法Object。因此，如果没有方法显式声明该接口或其任何超接口然后返回的数组长度为0。（注意，类对象代表一类总是有公共方法，继承了Object。）

如果这类对象表示简单类型或void，那么返回的数组长度为0。

在类或接口的类对象表示超接口声明的静态方法不被认为是类或接口的成员。

返回的数组中的元素没有排序，并没有在任何特定的顺序。

结果

对 方法对象代表该类的公共方法的阵列

异常

SecurityException如果安全管理器、空值、存在和调用者的类装载器是不一样的或祖先的类装载器的类和调用 s.checkPackageAccess()拒绝访问该类的包。

从以下版本开始：

JDK1.1

See The Java™ Language Specification:

8.2类成员，8.4种方法声明

getConstructors

public Constructor<?>[] getConstructors()
                                 throws SecurityException

返回一个数组包含 Constructor物体反射所有的 类对象表示的类的公共构造函数。如果类没有公共构造函数，则返回一个长度为0的数组，或者如果该类是一个数组类，或如果该类反映了一个原始类型或空。注意，此方法返回一个对象数组 Constructor<T>（即从这类构造函数Array），该方法的返回类型是 Constructor<?>[]不 Constructor<T>[]可能。这一信息较少的返回类型是必要的因为从这个方法返回的数组后，可以修改为不同的阶级有 Constructor对象，这将违反 Constructor<T>[]类型担保。

结果

对 Constructor对象代表该类的公共构造函数的阵列

异常

SecurityException如果安全管理器、空值、存在和调用者的类装载器是不一样的或祖先的 s.checkPackageAccess()类和调用的类装载器拒绝访问该类的包。

从以下版本开始：

JDK1.1

getField

public Field getField(String name)
               throws NoSuchFieldException,
                      SecurityException

返回一个 Field对象反映的类或接口的 类对象表示的指定公共成员。这是一个 String name参数用于指定所需字段的简单的名字。

要反映的字段是由如下的算法确定的。让C是这个对象所表示的类或接口：

1. 如果C声明一个指定的名称的公共字段，则该字段将被反射。
2. 如果没有一场是在以上1个步骤，该算法是递归地应用于C的直接超接口搜索它们声明的顺序每一个直接超接口。
3. 如果没有一场是在步骤1和2以上，且C有一个父类，然后递归调用该算法在S.如果C没有父类，然后NoSuchFieldException抛出。

如果这类对象代表数组类型，那么这个方法没有找到数组类型的length场。

参数

name的字段名称

结果

这类的 Field name指定的对象

异常

NoSuchFieldException -如果指定名称的字段不存在。

如果是 null name NullPointerException

SecurityException如果安全管理器、空值、存在和调用者的类装载器是不一样的或祖先的类装载器的类和调用 s.checkPackageAccess()拒绝访问该类的包。

从以下版本开始：

JDK1.1

See The Java™ Language Specification:

8.2类成员，8.3场声明

getMethod

public 方法 getMethod(String name,
                        类<?>... parameterTypes)
                 throws NoSuchMethodException,
                        SecurityException

返回一个 方法对象反映的类或接口的 类对象表示的指定公共成员方法。这是一个 String name参数指定所需的方法简单的名字。的 parameterTypes参数是 类对象识别方法的形参类型的数组，在声明的顺序。如果 parameterTypes是 null，它被看作是一个空数组。

如果name是“<init>”或“<clinit>“NoSuchMethodException升起。否则，所反映的方法是由以下的算法确定。让C是这个对象所表示的类或接口：

1. C是寻找一个空匹配方法，定义如下。如果找到一个匹配的方法，它反映。
2. 如果没有匹配的方法由1步之后发现：
   1. 如果C是比其他Object类，然后递归调用该算法对C的父类
   2. 如果C类Object，如果C是一个接口，然后C超接口（如果有）正在寻找一个匹配的方法。如果找到了这样的方法，它反映。

找到一个类或接口C匹配方法： 如果C声明一个公共方法具有指定名称和完全相同的形参类型，即方法的体现。如果在C中发现了一个以上这样的方法，并且这些方法中的一个具有比其他任何一个更具体的返回类型，则该方法被反射，否则的方法之一是任意选择的。

注意，可能有一个以上的匹配方法在一类因为java语言禁止类声明多个方法具有相同的签名，但不同的返回类型，java虚拟机不。这增加了在虚拟机中的灵活性，可以用来实现各种语言的功能。例如，协变量可以实现bridge methods；电桥法和被覆盖的方法将具有相同的签名，但返回类型不同。

如果这类对象代表数组类型，那么这个方法没有找到clone()方法。

在类或接口的类对象表示超接口声明的静态方法不被认为是类或接口的成员。

参数

name -名称的方法

parameterTypes -参数列表

结果

的 方法对象与指定的 name和 parameterTypes

异常

NoSuchMethodException -如果没有找到匹配的方法或者叫“ <初始化> ”或“ ”。

如果是 null name NullPointerException

SecurityException如果安全管理器、空值、存在和调用者的类装载器是不一样的或祖先的类装载器的类和调用 s.checkPackageAccess()拒绝访问该类的包。

从以下版本开始：

JDK1.1

See The Java™ Language Specification:

8.2类成员，8.4种方法声明

getConstructor

public Constructor<T> getConstructor(类<?>... parameterTypes)
                              throws NoSuchMethodException,
                                     SecurityException

返回一个 Constructor对象反映指定的公共构造函数的 类对象表示的类。的 parameterTypes参数是 类对象定义构造函数的形参类型的数组，在声明的顺序。如果这 类对象代表一个内部类中的非静态语境宣布，形参类型包括显式封闭实例作为第一个参数。

构造函数的反映是这个类对象的形式参数类型匹配指定的parameterTypes代表类的公共构造函数。

参数

parameterTypes -参数数组

结果

那些符合指定 parameterTypes公共构造函数的 Constructor对象

异常

NoSuchMethodException -如果没有找到匹配的方法。

SecurityException如果安全管理器、空值、存在和调用者的类装载器是不一样的或祖先的类装载器的类和调用 s.checkPackageAccess()拒绝访问该类的包。

从以下版本开始：

JDK1.1

getDeclaredClasses

public 类<?>[] getDeclaredClasses()
                              throws SecurityException

返回一个数组 类物体反射所有的类和接口声明为这 类对象表示的类成员。这包括公共的、受保护的、默认的（包）访问，以及类所声明的私有类和接口，但不包括继承的类和接口。如果类没有声明为成员的类或接口方法返回的数组长度为0，或者如果这 类对象表示简单类型、数组类，或无效。

结果

代表所有的宣布，这个阶层的成员 类对象数组

异常

SecurityException如果安全管理器，空值，是目前任何满足以下条件：

• 调用者的类装载器是不是与RuntimePermission("accessDeclaredMembers")这类和s.checkPermission方法调用的类装载器拒绝访问声明的类这个类中的一样
• 调用者的类装载器是不一样的或祖先的类装载器的类和调用s.checkPackageAccess()拒绝访问该类的包

从以下版本开始：

JDK1.1

getDeclaredFields

public Field[] getDeclaredFields()
                          throws SecurityException

返回 Field物体反射所有字段的类或接口的 类对象表示声明数组。这包括公共的、受保护的、默认的（包）访问和私有字段，但不包括继承的字段。

如果这类对象表示的类或接口没有声明的字段，那么这个方法返回的数组长度为0。

如果这类对象代表数组类型，原始类型，或无效，则该方法返回的数组长度为0。

返回的数组中的元素没有排序，并没有在任何特定的顺序。

结果

代表所有申报领域这类 Field对象数组

异常

SecurityException如果安全管理器，空值，是目前任何满足以下条件：

• 调用者的类装载器是不是与RuntimePermission("accessDeclaredMembers")这类和s.checkPermission方法调用的类装载器拒绝申报领域内这类相同
• 调用者的类装载器是不一样的或祖先的类装载器的类和调用s.checkPackageAccess()拒绝访问该类的包

从以下版本开始：

JDK1.1

See The Java™ Language Specification:

8.2类成员，8.3场声明

getDeclaredMethods

public 方法[] getDeclaredMethods()
                            throws SecurityException

返回一个数组包含 方法物体反射所有声明的方法的类或接口的 类对象，代表包括公众、保护，默认（包）的访问，和私有方法，但不包括继承的方法。

如果这类对象代表一个类有多个声明的方法具有相同的名称和参数类型，但不同的返回类型，那么返回的数组的每一个这样的方法方法对象。

如果这类对象代表一个类型，一类的初始化方法<clinit>，然后返回的数组没有相应的方法对象。

如果这类对象表示的类或接口没有声明的方法，然后返回的数组长度为0。

如果这类对象代表数组类型，原始类型，或无效，则返回的数组长度为0。

返回的数组中的元素没有排序，并没有在任何特定的顺序。

结果

对 方法对象代表所有这一类的数组声明的方法

异常

SecurityException如果安全管理器，空值，是目前任何满足以下条件：

• 调用者的类装载器是不是与RuntimePermission("accessDeclaredMembers")这类和s.checkPermission方法调用的类装载器拒绝访问声明的方法在这类相同
• 调用者的类装载器是不一样的或祖先的类装载器的类和调用s.checkPackageAccess()拒绝访问该类的包

从以下版本开始：

JDK1.1

See The Java™ Language Specification:

8.2类成员，8.4种方法声明

getDeclaredConstructors

public Constructor<?>[] getDeclaredConstructors()
                                         throws SecurityException

返回 Constructor物体反射所有的构造函数通过 类对象表示的类中声明一个数组。这些都是公共的、受保护的、默认的（包）访问和私有构造函数。返回的数组中的元素没有排序，并没有在任何特定的顺序。如果类有一个默认的构造函数，它被包含在返回的数组中。如果这 类对象表示一个接口方法返回的数组长度为0，原始类型，数组类，或无效。

查看java语言规范8.2节。

结果

对 Constructor对象代表所有声明的构造函数这类数组

异常

SecurityException如果安全管理器，空值，是目前任何满足以下条件：

• 调用者的类装载器是不是与RuntimePermission("accessDeclaredMembers")这类和s.checkPermission方法调用的类装载器拒绝访问声明的构造函数在这类相同
• 调用者的类装载器是不一样的或祖先的类装载器的类和调用s.checkPackageAccess()拒绝访问该类的包

从以下版本开始：

JDK1.1

getDeclaredField

public Field getDeclaredField(String name)
                       throws NoSuchFieldException,
                              SecurityException

返回一个对象，反映了 Field指定声明字段的类或接口的 类对象表示。的 name参数是一个 String指定所需字段的简单的名字。

如果这类对象代表数组类型，那么这个方法没有找到数组类型的length场。

参数

name -字段的名称

结果

该类中指定字段的 Field对象

异常

NoSuchFieldException -如果指定名称的字段不存在。

如果是 null name NullPointerException

SecurityException如果安全管理器，空值，是目前任何满足以下条件：

• 调用者的类装载器是不是与RuntimePermission("accessDeclaredMembers")这类和s.checkPermission方法调用的类装载器拒绝访问声明的字段相同
• 调用者的类装载器是不一样的或祖先的类装载器的类和调用s.checkPackageAccess()拒绝访问该类的包

从以下版本开始：

JDK1.1

See The Java™ Language Specification:

8.2类成员，8.3场声明

getDeclaredMethod

public 方法 getDeclaredMethod(String name,
                                类<?>... parameterTypes)
                         throws NoSuchMethodException,
                                SecurityException

返回一个 方法对象反映指定声明方法的类或接口的 类对象表示。的 name参数是一个 String指定所需的方法简单的名字，和 parameterTypes参数是 类对象识别方法的形参类型的数组，在声明的顺序。如果在一个类中声明具有相同参数类型的多个方法，并且这些方法中的一个具有比其他任何其他更具体的返回类型，则该方法返回；否则将任意选择其中一种方法之一。如果名称是“ <初始化> ”或“ ” NoSuchMethodException升起。

如果这类对象代表数组类型，那么这个方法没有找到clone()方法。

参数

name -名称的方法

parameterTypes -参数数组

结果

对于这类匹配指定名称和参数的方法 方法对象

异常

NoSuchMethodException -如果没有找到匹配的方法。

如果是 null name NullPointerException

SecurityException如果安全管理器，空值，是目前任何满足以下条件：

• 调用者的类装载器是不是与RuntimePermission("accessDeclaredMembers")这类和s.checkPermission方法调用的类装载器拒绝访问声明的方法
• 调用者的类装载器是不一样的或祖先的s.checkPackageAccess()类和调用的类装载器拒绝访问该类的包

从以下版本开始：

JDK1.1

See The Java™ Language Specification:

8.2类成员，8.4种方法声明

getDeclaredConstructor

public Constructor<T> getDeclaredConstructor(类<?>... parameterTypes)
                                      throws NoSuchMethodException,
                                             SecurityException

返回一个 Constructor对象反映指定的构造函数的类或接口的 类对象表示。的 parameterTypes参数是 类对象定义构造函数的形参类型的数组，在声明的顺序。如果这 类对象代表一个内部类中的非静态语境宣布，形参类型包括显式封闭实例作为第一个参数。

参数

parameterTypes -参数数组

结果

用指定的参数列表 Constructor对象的构造函数

异常

NoSuchMethodException -如果没有找到匹配的方法。

SecurityException如果安全管理器，空值，是目前任何满足以下条件：

• 调用者的类装载器是不是与RuntimePermission("accessDeclaredMembers")这类和s.checkPermission方法调用的类装载器拒绝访问声明的构造函数一样
• 调用者的类装载器是不一样的或祖先的类装载器的类和调用s.checkPackageAccess()拒绝访问该类的包

从以下版本开始：

JDK1.1

getResourceAsStream

public InputStream getResourceAsStream(String name)

查找给定名称的资源。在资源搜索与给定类的类的定义 class loader实施相关的规则。此方法将委托给这个对象的类加载程序。如果这个对象被引导类加载器加载的方法， ClassLoader.getSystemResourceAsStream(java.lang.String)

在代表团之前，使用该算法，从给定的资源名称中构造一个绝对资源名称：

• 如果name始于'/'（'\u002f'），那么该资源的绝对叫的name部分以下的'/'。
• 否则，绝对的名字是以下形式：

  modified_package_name/name

  在modified_package_name与'/'取代'.'这个对象的包名（'\u002e'）。

代表。

参数

name -所需的资源名称

结果

一个 InputStream对象或 null如果未找到该名称的资源

异常

如果是 null name NullPointerException

从以下版本开始：

JDK1.1

getResource

public URL getResource(String name)

查找给定名称的资源。在资源搜索与给定类的类的定义 class loader实施相关的规则。此方法将委托给这个对象的类加载程序。如果这个对象被引导类加载器加载的方法，代表 ClassLoader.getSystemResource(java.lang.String)。

在代表团之前，使用该算法，从给定的资源名称中构造一个绝对资源名称：

• 如果name始于'/'（'\u002f'），那么该资源的绝对叫的name部分以下的'/'。
• 否则，绝对的名字是以下形式：

  modified_package_name/name

  在modified_package_name与'/'取代'.'这个对象的包名（'\u002e'）。

参数

name -所需的资源名称

结果

一个 URL对象或 null如果未找到该名称的资源

从以下版本开始：

JDK1.1

getProtectionDomain

public ProtectionDomain getProtectionDomain()

返回该类的 ProtectionDomain。如果存在安全管理器安装，这种方法首先调用一个 RuntimePermission("getProtectionDomain")权限以确保可以得到 ProtectionDomain安全经理的 checkPermission方法。

结果

这个类的保护范围

异常

SecurityException -如果存在一个安全管理及其 checkPermission方法不允许获得protectiondomain时抛出。

从以下版本开始：

一点二

另请参见：

ProtectionDomain， SecurityManager.checkPermission(java.security.Permission)， RuntimePermission

desiredAssertionStatus

public boolean desiredAssertionStatus()

返回将被分配给该类的断言状态，如果它在调用该方法时被初始化。如果这个类有了它的断言状态集，最近的设置将返回；否则，如果任何包默认断言状态涉及到这个类，最新设置的最具体的相关包默认断言状态返回；否则，如果这个类不是一个系统类（即，它有一个类装载器）其类装载器的默认断言状态返回，否则，系统类的默认断言状态返回。

很少有程序员会有这种方法的任何需要；它提供的JRE本身的利益。（它允许一个类在它被初始化的时候确定是否应该启用断言。）注意，这种方法不能保证返回（或将）初始化时与指定的类关联的（或将是）的实际断言状态。

结果

指定类的所需的断言状态。

从以下版本开始：

一点四

另请参见：

ClassLoader.setClassAssertionStatus(java.lang.String, boolean)， ClassLoader.setPackageAssertionStatus(java.lang.String, boolean)， ClassLoader.setDefaultAssertionStatus(boolean)

isEnum

public boolean isEnum()

如果这个类被声明为源代码中的枚举返回true。

结果

真的当且仅当这个类被声明为源代码中的枚举

从以下版本开始：

一点五

getEnumConstants

public T[] getEnumConstants()

返回此枚举类或空的元素，如果这类对象并不代表一个枚举类型。

结果

一个数组包含的值包括为代表的这类对象的顺序在声明枚举类，或null，如果该类对象并不代表一个枚举类型

从以下版本开始：

一点五

cast

public T cast(Object obj)

将对象转换为类或接口的 类对象表示。

参数

obj -将对象

结果

铸造后的对象，如果对象是null或空

异常

ClassCastException -如果对象是无效的和不可转让的类型T。

从以下版本开始：

一点五

asSubclass

public <U> 类<? extends U> asSubclass(类<U> clazz)

把这 类对象代表通过指定类对象表示的类的子类。检查投是有效的，并抛出一个 ClassCastException如果不是。如果此方法成功，它总是返回这个类对象的引用。

这种方法是非常有用的当客户需要“窄”传递给API的限制类对象，它愿意接受一个类对象类型。一个演员将产生一个编译时警告，因为演员的正确性不能在运行时检查（因为通用类型是通过擦除）。

参数类型

U型铸造这类对象

参数

clazz型铸造这类对象的类

结果

这 类对象，铸造代表指定类的子类对象。

异常

ClassCastException -如果这 类对象并不代表指定类的子类（这里的“类”包括类本身）。

从以下版本开始：

一点五

getAnnotation

public <A extends Annotation> A getAnnotation(类<A> annotationClass)

从接口复制的描述： AnnotatedElement

如果存在此注释，则返回此元素的指定类型的注释，否则为空。

Specified by:

getAnnotation 接口 AnnotatedElement

参数类型

A -查询并返回如果目前的标注类型

参数

annotationClass -对应的注释类型的类对象

结果

如果此元素上存在指定的注释类型，此元素的注释将在其他元素上为空

异常

NullPointerException如果注释类是无效的

从以下版本开始：

一点五

isAnnotationPresent

public boolean isAnnotationPresent(类<? extends Annotation> annotationClass)

如果在这个元素上存在指定类型的注释，则返回真，否则为假。此方法的设计主要是方便的标记注释。

此方法返回的真实价值相当于：getAnnotation(annotationClass) != null

默认方法的主体被指定为上面的代码。

Specified by:

isAnnotationPresent 接口 AnnotatedElement

参数

annotationClass -对应的注释类型的类对象

结果

如果在这个元素上存在指定的注释类型的注释，则为假

异常

NullPointerException如果注释类是无效的

从以下版本开始：

一点五

getAnnotationsByType

public <A extends Annotation> A[] getAnnotationsByType(类<A> annotationClass)

从接口复制的描述： AnnotatedElement

返回与此元素关联的注释。如果没有与此元素关联的批注，返回值是一个长度为0的数组。这种方法和 AnnotatedElement.getAnnotation(Class)之间的区别是，该方法检测如果它的参数是一个可重复的注释类型（年9.6），如果是这样的话，试图找到一个或更多的注释，通过“浏览”式容器标注。此方法的调用方可以自由修改返回的数组；它将对返回给其他调用方的数组没有影响。

Specified by:

getAnnotationsByType 接口 AnnotatedElement

参数类型

A -查询并返回如果目前的标注类型

参数

annotationClass -对应的注释类型的类对象

结果

所有此元素的注释都与此元素关联，如果关联的是指定的注释类型，其他的数组长度为零

异常

NullPointerException如果注释类是无效的

从以下版本开始：

一点八

getAnnotations

public Annotation[] getAnnotations()

从接口复制的描述： AnnotatedElement

返回此元素上的注释。如果这个元素上没有注释，则返回值是一个长度为0的数组。此方法的调用方可以自由修改返回的数组；它将对返回给其他调用方的数组没有影响。

Specified by:

getAnnotations 接口 AnnotatedElement

结果

在这个元素上的注释

从以下版本开始：

一点五

getDeclaredAnnotation

public <A extends Annotation> A getDeclaredAnnotation(类<A> annotationClass)

从接口复制的描述： AnnotatedElement

返回此元素的指定类型的注释，如果这样的注释是直接存在的，否则为空。此方法忽略了继承的注释。（如果没有直接在这个元素上的注释，返回空值。）

Specified by:

getDeclaredAnnotation 接口 AnnotatedElement

参数类型

A -查询，如果直接提出返回的标注类型

参数

annotationClass -对应的注释类型的类对象

结果

此元素的注释类型，如果直接存在于此元素，将为指定的注释类型，否则为

异常

NullPointerException如果注释类是无效的

从以下版本开始：

一点八

getDeclaredAnnotationsByType

public <A extends Annotation> A[] getDeclaredAnnotationsByType(类<A> annotationClass)

从接口复制的描述： AnnotatedElement

如果这样的注释直接存在或间接存在，则返回指定类型的该元素的注释（s）。此方法忽略了继承的注释。如果在这个元素上没有直接或间接存在指定的注释，则返回值是一个长度为0的数组。这种方法和 AnnotatedElement.getDeclaredAnnotation(Class)之间的区别是，该方法检测如果它的参数是一个可重复的注释类型（年9.6），如果是这样的话，试图找到一个或更多的注释，通过“浏览”式容器注释如果存在。此方法的调用方可以自由修改返回的数组；它将对返回给其他调用方的数组没有影响。

Specified by:

getDeclaredAnnotationsByType 接口 AnnotatedElement

参数类型

A -注释类型来查询并返回如果直接或间接存在

参数

annotationClass -对应的注释类型的类对象

结果

如果在这个元素上直接或间接地存在于该元素上的指定注释类型的所有此元素的注释，否则将是一个长度为零的数组

异常

NullPointerException如果注释类是无效的

从以下版本开始：

一点八

getDeclaredAnnotations

public Annotation[] getDeclaredAnnotations()

从接口复制的描述： AnnotatedElement

返回直接在该元素上的注释。此方法忽略了继承的注释。如果在这个元素上没有直接存在的注释，返回值是一个长度为0的数组。此方法的调用方可以自由修改返回的数组；它将对返回给其他调用方的数组没有影响。

Specified by:

getDeclaredAnnotations 接口 AnnotatedElement

结果

直接在这个元素上的注释

从以下版本开始：

一点五

getAnnotatedSuperclass

public AnnotatedType getAnnotatedSuperclass()

返回一个 AnnotatedType表示指定类型的对象表示的实体 类父类的使用。（Foo类型指定父类的使用…延伸foo”不同于

如果这类对象代表一个类的声明并没有明确说明注释的超类，则返回值是一个AnnotatedType对象代表没有注释的元素。

如果这类要么表现的Object类、接口类型、数组类型、简单类型或无效，返回值是null。

Foo类型声明。）

结果

代表父类的对象

从以下版本开始：

一点八

getAnnotatedInterfaces

public AnnotatedType[] getAnnotatedInterfaces()

返回 AnnotatedType对象代表类型指定的 类对象表示的实体超接口使用一个数组。（Foo类型指定在使用超…实现了foo”不同于

如果这类对象代表一个类，返回值是一个数组包含的对象代表接口类型的使用指定该类实现的接口。在数组中对应用于'实施'条款的这类对象声明的接口类型的对象的顺序为。

如果这类对象表示一个接口，返回值是一个数组包含的对象代表接口类型使用指定接口的接口直接扩展。在数组中对应于用于“扩展条款”的这一类对象声明的接口类型的对象的顺序为。

如果这类对象表示的类或接口的声明并没有明确指出任何注释的超接口，返回值是一个长度为0的数组。

如果这类对象代表的Object类，数组类型，原始类型，或无效，返回值是一个长度为0的数组。

Foo类型声明。）

结果

代表超接口数组

从以下版本开始：

一点八