Class

asSubclass

Class<? extends U> asSubclass (Class<U> clazz)

转换此Class对象以表示由指定的类对象表示的类的子类。 检查演员是否有效，如果不是，则抛出ClassCastException 。 如果此方法成功，它总是返回对此类对象的引用。

当客户需要“缩小” Class对象的类型以将其传递给限制其愿意接受的Class对象的API时，此方法非常有用。 由于无法在运行时检查强制转换的正确性（因为通用类型是通过擦除实现的），所以强制转换会生成编译时警告。

cast

T cast (Object obj)

将对象 Class到此 Class对象表示的类或接口。

desiredAssertionStatus

boolean desiredAssertionStatus ()

如果在调用此方法时初始化该类，则返回将分配给此类的断言状态。 如果这个类已经设置了断言状态，则返回最近的设置; 否则，如果任何软件包默认断言状态属于该类，则返回最具体的相关软件包默认断言状态的最新设置; 否则，如果这个类不是一个系统类（即它有一个类加载器），它的类加载器的默认断言状态被返回; 否则，返回系统类的默认断言状态。

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

forName

Class<?> forName (String name, 
                boolean initialize, 
                ClassLoader loader)

使用给定的类加载器返回与具有给定字符串名称的类或接口关联的Class对象。 给定类或接口的完全限定名称（采用与getName相同的格式），此方法尝试查找，加载和链接类或接口。 指定的类加载器用于加载类或接口。 如果参数loader为空，则通过引导类加载器加载该类。 仅当initialize参数为true并且它尚未初始化时才会初始化该类。

如果name表示原始类型或void，则将尝试在名称为name的未命名包中找到用户定义的类。 因此，此方法不能用于获取表示原始类型或void的任何Class对象。

如果 name表示一个数组类，则该数组类的组件类型将被加载但未初始化。

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

Class.forName("Foo")

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

如果 loader为 null ，并且存在安全管理器，并且调用者的类加载器不为空，则此方法使用 RuntimePermission("getClassLoader")权限调用安全管理器的 checkPermission方法，以确保可以访问引导类加载器。

forName

Class<?> forName (String className)

返回与具有给定字符串名称的类或接口关联的Class对象。 调用此方法相当于：

Class.forName(className, true, currentLoader)

例如，下面的代码段返回运行时 Class描述符名为类 java.lang.Thread ：

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

调用 forName("X")会导致名为 X的类被初始化。

getAnnotation

A getAnnotation (Class<A> annotationClass)

getAnnotations

Annotation[] getAnnotations ()

返回包含此类的所有注释的数组。 如果没有注释，则返回空数组。

getCanonicalName

String getCanonicalName ()

返回Java语言规范定义的基础类的规范名称。 如果基础类没有规范名称（例如，如果它是本地或匿名类或其组件类型没有规范名称的数组），则返回null。

getClassLoader

ClassLoader getClassLoader ()

返回该类的类加载器。 某些实现可能使用null来表示引导类加载器。 如果此类由引导类加载器加载，则此方法将在此类实现中返回null。

如果存在安全管理器，并且调用者的类加载器不为空，并且调用者的类加载器与请求类加载器的类的类加载器不相同或是其类的祖先，则此方法调用安全管理器的方法 checkPermission具有 RuntimePermission("getClassLoader")权限以确保可以访问该类的类加载器。

如果此对象表示原始类型或void，则返回null。

getClasses

Class[]<?> getClasses ()

返回包含一个数组Class代表所有的公共类和由此表示的类的成员接口的对象Class对象。 这包括从超类继承的公共类和接口成员，以及由类声明的公共类和接口成员。 如果此Class对象没有公共成员类或接口，则此方法返回长度为0的数组。 如果此Class对象表示原始类型，数组类或void，则此方法还会返回长度为0的数组。

getComponentType

Class<?> getComponentType ()

返回表示数组的组件类型的Class 。 如果此类不表示数组类，则此方法返回null。

getConstructor

Constructor<T> getConstructor (Class...<?> parameterTypes)

返回一个Constructor对象，该对象反映此Class对象所代表的类的指定公共构造函数。 parameterTypes参数是一组Class对象，以声明的顺序标识构造函数的形式参数类型。 如果此Class对象表示在非静态上下文中声明的内部类，则形式参数类型将显式封闭实例作为第一个参数。

要反映的构造函数是由此 Class对象表示的类的公共构造函数，其形式参数类型与 parameterTypes指定的类型匹配。

getConstructors

Constructor[]<?> getConstructors ()

返回一个包含Constructor对象的数组， Constructor对象反映此Class对象所代表的类的所有公共构造函数。 如果类没有公共构造函数，或者类是数组类，或者类反映了原始类型或void，则返回长度为0的数组。 请注意，虽然此方法返回一个包含Constructor<T>对象的数组（该类为构造函数的数组），但此方法的返回类型为Constructor<?>[]而不是可能预期的Constructor<T>[] 。 这种信息量较少的返回类型是必要的，因为在从这种方法返回之后，可以修改该数组以Constructor不同类别的Constructor对象，这违反了Constructor<T>[]的类型保证。

getDeclaredAnnotations

Annotation[] getDeclaredAnnotations ()

返回由此Class表示的类直接定义的注释。 结果中不包括继承的注释。 如果根本没有注释，则返回一个空数组。

getDeclaredClasses

Class[]<?> getDeclaredClasses ()

返回一个包含Class对象的数组， Class对象声明所有声明为此Class对象表示的类的成员的类和接口。 这包括public，protected，default（包）访问，以及由类声明的私有类和接口，但不包括继承的类和接口。 如果该类没有声明类或接口作为成员此方法返回长度为0的数组，如果此Class对象表示一个基本类型，一个数组类，或空隙。

getDeclaredConstructor

Constructor<T> getDeclaredConstructor (Class...<?> parameterTypes)

返回一个Constructor对象，它反映此表示的类或接口的指定构造Class对象。 parameterTypes参数是一组Class对象，以声明顺序标识构造函数的形式参数类型。 如果此Class对象表示在非静态上下文中声明的内部类，则形式参数类型将显式封闭实例作为第一个参数。

getDeclaredConstructors

Constructor[]<?> getDeclaredConstructors ()

返回反映由此Class对象表示的类声明的所有构造函数的Constructor对象的数组。 这些是公共的，受保护的，默认（包）访问和私有构造函数。 返回的数组中的元素没有排序并且没有任何特定的顺序。 如果类有一个默认构造函数，它将包含在返回的数组中。 如果此Class对象表示接口，基元类型，数组类或void，则此方法返回长度为0的数组。

请参阅 Java语言规范 ，第8.2节。

getDeclaredField

Field getDeclaredField (String name)

返回一个Field对象，它反映此表示的类或接口的指定已声明字段Class对象。 name参数是一个String ，它指定了所需字段的简单名称。 请注意，此方法不会反映数组类的length字段。

getDeclaredFields

Field[] getDeclaredFields ()

返回反映由此Class对象表示的类或接口声明的所有字段的Field对象的数组。 这包括公共，受保护，默认（包）访问和专用字段，但不包括继承字段。 返回的数组中的元素没有排序并且没有任何特定的顺序。 如果类或接口声明任何字段此方法返回长度为0的数组，如果此Class对象表示一个基本类型，一个数组类，或空隙。

请参阅 Java语言规范 ，第8.2节和第8.3节。

getDeclaredMethod

方法 getDeclaredMethod (String name, 
                Class...<?> parameterTypes)

返回一个方法对象，它反映此表示的类或接口的指定声明的方法Class对象。 name参数是一个String ，它指定了所需方法的简单名称，而parameterTypes参数是一个由Class对象组成的数组，它以声明的顺序标识该方法的形式参数类型。 如果在一个类中声明了多个具有相同参数类型的方法，并且其中一个方法的返回类型比其他方法更具体，则返回该方法; 否则其中一种方法是任意选择的。 如果名称是“<init>”或“<clinit>”，则引发NoSuchMethodException 。

getDeclaredMethods

Method[] getDeclaredMethods ()

返回反映由此Class对象表示的类或接口声明的所有方法的方法对象的数组。 这包括公共，受保护，默认（包）访问和私有方法，但不包括继承的方法。 返回的数组中的元素没有排序并且没有任何特定的顺序。 如果类或接口声明没有方法此方法返回长度为0的数组，如果此Class对象表示一个基本类型，一个数组类，或空隙。 类初始化方法<clinit>不包含在返回的数组中。 如果类声明多个具有相同参数类型的公共成员方法，则它们都包含在返回的数组中。

请参阅 Java语言规范 ，第8.2节。

getDeclaringClass

Class<?> getDeclaringClass ()

如果此Class对象表示的类或接口是另一个类的成员，则返回表示声明它的类的Class对象。 如果此类或接口不是任何其他类的成员，则此方法返回null。 如果这个Class对象表示一个数组类，一个原始类型或void，那么这个方法返回null。

getEnclosingClass

Class<?> getEnclosingClass ()

返回基础类的直接封闭类。 如果基础类是顶级类，则此方法返回null 。

getEnclosingConstructor

Constructor<?> getEnclosingConstructor ()

如果此Class对象表示一个构造内的本地或匿名类，返回一个Constructor表示基础类的立即封闭构造对象。 否则返回null 。 特别是，如果基础类是立即由类型声明，实例初始值设定项或静态初始值设定项包围的本地或匿名类，则此方法返回null 。

getEnclosingMethod

方法 getEnclosingMethod ()

如果此Class对象表示方法中的一个本地或匿名类，返回一个方法表示基础类的立即封闭方法的对象。 否则返回null 。 特别是，如果基础类是立即由类型声明，实例初始值设定项或静态初始值设定项包围的本地或匿名类，则此方法返回null 。

getEnumConstants

T[] getEnumConstants ()

返回此枚举类的元素，如果此Class对象不表示枚举类型，则返回null。

getField

Field getField (String name)

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

要反映的字段由以下算法决定。 设C为此对象表示的类：

1. If C declares a public field with the name specified, that is the field to be reflected.
2. If no field was found in step 1 above, this algorithm is applied recursively to each direct superinterface of C. The direct superinterfaces are searched in the order they were declared.
3. If no field was found in steps 1 and 2 above, and C has a superclass S, then this algorithm is invoked recursively upon S. If C has no superclass, then a NoSuchFieldException is thrown.

请参阅 Java语言规范 ，第8.2节和第8.3节。

getFields

Field[] getFields ()

返回包含Field对象的数组， Field对象反映此Class对象表示的类或接口的所有可访问公用字段。 返回的数组中的元素没有排序并且没有任何特定的顺序。 如果类或接口没有可访问的公共字段，或者它表示数组类，基元类型或void，则此方法返回长度为0的数组。

特别是，如果这个Class对象代表一个类，这个方法返回这个类及其所有超类的公共字段。 如果此Class对象表示一个接口，则此方法将返回此接口及其所有超接口的字段。

此类方法不反映数组类的隐式长度字段。 用户代码应该使用类Array的方法来操作数组。

请参阅 Java语言规范 ，第8.2节和第8.3节。

getGenericInterfaces

Type[] getGenericInterfaces ()

返回表示由此对象表示的类或接口直接实现的接口的 Type 。

如果superinterface是参数化类型，则返回的Type对象必须准确反映源代码中使用的实际类型参数。 如果它以前没有创建过，则会创建表示每个超级界面的参数化类型。 有关参数化类型的创建过程的语义，请参阅ParameterizedType的声明。

如果此对象表示一个类，则返回值是一个包含表示该类实现的所有接口的对象的数组。 数组中接口对象的顺序与此对象表示的类的声明的implements子句中的接口名称的顺序相对应。 在数组类的情况下，按照该顺序返回接口Cloneable和Serializable 。

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

如果此对象表示不实现接口的类或接口，则该方法返回长度为0的数组。

如果此对象表示原始类型或void，则该方法返回长度为0的数组。

getGenericSuperclass

Type getGenericSuperclass ()

返回表示由此 Type表示的实体（类，接口，基元类型或void）的直接超类的 Class 。

如果超类是参数化类型，则返回的Type对象必须准确反映源代码中使用的实际类型参数。 如果它以前没有创建过，则会创建表示超类的参数化类型。 有关参数化类型的创建过程的语义，请参阅ParameterizedType的声明。 如果此Class代表Object类，接口，基元类型或void，则返回null。 如果此对象表示一个数组类，则返回代表Object类的Class对象。

getInterfaces

Class[]<?> getInterfaces ()

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

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

class Shimmer implements FloorWax, DessertTopping { ... }

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

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

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

如果此对象表示不实现接口的类或接口，则该方法返回长度为0的数组。

如果此对象表示原始类型或void，则该方法返回长度为0的数组。

getMethod

方法 getMethod (String name, 
                Class...<?> parameterTypes)

返回方法对象，该对象反映此Class对象所表示的类或接口的指定公共成员方法。 name参数是指定所需方法的简单名称的String 。 parameterTypes参数是一组Class对象，以声明的顺序标识方法的形式参数类型。 如果parameterTypes是null ，则将其视为空数组。

如果name是“ <init> ;”或“ <clinit> ”，则引发NoSuchMethodException 。 否则，要反映的方法由下面的算法确定。 设C为此对象表示的类：

1. C is searched for any matching methods. If no matching method is found, the algorithm of step 1 is invoked recursively on the superclass of C.
2. If no method was found in step 1 above, the superinterfaces of C are searched for a matching method. If any such method is found, it is reflected.

请注意，类中可能存在多个匹配方法，因为尽管Java语言禁止类声明具有相同签名但返回类型不同的多个方法，但Java虚拟机不会。 虚拟机中增加的灵活性可用于实现各种语言功能。 例如，协变回报可以用bridge methods来实现; 桥接方法和被覆盖的方法将具有相同的签名但不同的返回类型。

请参阅 Java语言规范第8.2和8.4节。

getMethods

Method[] getMethods ()

返回一个包含方法对象的数组， 方法对象反映此Class对象表示的类或接口的所有公共成员方法，包括由类或接口声明的那些以及从超类和超接口继承的那些方法。 数组类返回从Object类继承的所有（公共）成员方法。 返回的数组中的元素没有排序并且没有任何特定的顺序。 如果这此方法返回长度为0的数组Class对象表示一个类或接口没有公共成员方法，或者如果此Class对象表示一个基本类型或空隙。

类初始化方法<clinit>不包含在返回的数组中。 如果类声明多个具有相同参数类型的公共成员方法，则它们都包含在返回的数组中。

请参阅 Java语言规范第8.2和8.4节。

getModifiers

int getModifiers ()

返回此类或接口的Java语言修饰符，以整数编码。 修饰符由Java虚拟机的常数为public ， protected ， private ， final ， static ， abstract和interface ; 他们应该使用类Modifier的方法解码。

如果底层类是一个数组类，则其public ， private和protected改性剂是相同的组分的类型。 如果此Class表示一个基本类型或空隙，其public改性剂总是true ，其protected个private改性剂是总是false 。 如果该对象表示数组类，一个基本类型或void，则其final改性剂总是true及其界面改性总是false 。 其他修饰符的值不由本规范决定。

修改器编码在 Java虚拟机规范表4.1中定义。

getName

String getName ()

以 Class形式返回此 Class对象所表示的实体（类，接口，数组类，或基本类型）的 String 。

如果此类对象表示不是数组类型的引用类型，则返回类的二进制名称，如 The Java™ Language Specification所指定的 那样 。

如果这个类对象表示一个原始类型或void，那么返回的名称是 String等于对应于原始类型或void的Java语言关键字。

如果此类对象表示一个数组类，则名称的内部形式由元素类型的名称组成，该名称前面有一个或多个表示数组嵌套深度的“ [ ”字符。 元素类型名称的编码如下所示：

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

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

例子：

 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"
 

getPackage

软件包 getPackage ()

获取这个类的包。 这个类的类加载器用于查找包。 如果该类是由引导类加载器加载的，则将搜索从CLASSPATH加载的一组包以查找该类的包。 如果该类的类加载器未创建包对象，则返回空值。

仅当信息在类中附带的清单中定义时，以及如果类加载器使用清单中的属性创建了包实例，那么程序包才具有版本和规范的属性。

getProtectionDomain

ProtectionDomain getProtectionDomain ()

返回这个类的ProtectionDomain 。 如果安装了安全管理器，则此方法首先使用RuntimePermission("getProtectionDomain")权限调用安全管理器的checkPermission方法，以确保获得ProtectionDomain 。

getResource

URL getResource (String name)

查找具有给定名称的资源。 搜索与给定类关联的资源的规则由类的定义class loader实现。 这个方法委托给这个对象的类加载器。 如果此对象由引导类加载器加载，则该方法委托给getSystemResource(String) 。

在委派前，使用此算法从给定资源名称构建绝对资源名称：

• If the name begins with a '/' ('\u002f'), then the absolute name of the resource is the portion of the name following the '/'.
• Otherwise, the absolute name is of the following form:

  modified_package_name/name

  其中 modified_package_name是此对象的包名称，其中 '/'代替 '.' （ '\u002e' ）。

getResourceAsStream

InputStream getResourceAsStream (String name)

查找具有给定名称的资源。 搜索与给定类关联的资源的规则由类的定义class loader实现。 这个方法委托给这个对象的类加载器。 如果此对象由引导类加载器加载，则该方法委托给getSystemResourceAsStream(String) 。

在委派前，使用此算法从给定资源名称构建绝对资源名称：

• If the name begins with a '/' ('\u002f'), then the absolute name of the resource is the portion of the name following the '/'.
• Otherwise, the absolute name is of the following form:

  modified_package_name/name

  其中 modified_package_name是此对象的包名， '/'代替 '.' （ '\u002e' ）。

getSigners

Object[] getSigners ()

获取这个类的签名者。

getSimpleName

String getSimpleName ()

返回源代码中给出的基础类的简单名称。 如果基础类是匿名的，则返回空字符串。

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

getSuperclass

Class<? super T> getSuperclass ()

返回表示由此Class表示的实体（类，接口，基元类型或void）的超类的Class 。 如果此Class表示Object类，接口，基元类型或void，则返回null。 如果此对象表示一个数组类，则返回代表Object类的Class对象。

getTypeParameters

TypeVariable[]<Class<T>> getTypeParameters ()

以声明顺序GenericDeclaration表示由此GenericDeclaration对象表示的通用声明声明的类型变量的TypeVariable对象数组。 如果基础泛型声明声明没有类型变量，则返回长度为0的数组。

isAnnotation

boolean isAnnotation ()

如果此Class对象表示注释类型，则返回true。 请注意，如果此方法返回true，则isInterface()也会返回true，因为所有注记类型也都是接口。

isAnnotationPresent

boolean isAnnotationPresent (Class<? extends Annotation> annotationType)

如果此元素上存在指定类型的注释，则返回true，否则返回false。 此方法主要用于方便地访问标记注释。

isAnonymousClass

boolean isAnonymousClass ()

当且仅当基础类是匿名类时返回 true 。

isArray

boolean isArray ()

确定此 Class对象是否代表数组类。

isAssignableFrom

boolean isAssignableFrom (Class<?> c)

确定此Class对象表示的类或接口是否与指定的Class参数所表示的类或接口相同，或者是否为超类或超接口。 如果是，则返回true ; 否则返回false 。 如果此Class对象表示基元类型，则此方法返回true如果指定的Class参数恰好是此Class对象; 否则返回false 。

具体而言，此方法测试指定的Class参数所表示的类型是否可以通过标识转换或通过扩展参考转换转换为此Class对象表示的类型。 有关详细信息 ，请参阅Java语言规范 ，第5.1.1和5.1.4节。

isEnum

boolean isEnum ()

当且仅当此类在源代码中声明为枚举时才返回true。

isInstance

boolean isInstance (Object object)

确定指定的Object是否与此Class表示的对象分配兼容。 此方法与Java语言instanceof操作符的动态等效。 该方法返回true如果指定Object参数为非空并且可以转换为通过此表示的引用类型Class对象不提高一个ClassCastException.它返回false否则。

特别是，如果此Class对象表示一个声明的类，则此方法返回true如果指定的Object参数是表示的类（或其任何子类）的实例; 否则返回false 。 如果此Class对象表示一个数组类，则如果指定的Object参数可通过标识转换或扩展参考转换转换为数组类的对象，则此方法返回true ; 否则返回false 。 如果此Class对象表示一个接口，则此方法返回true如果指定的Object参数的类或任何超类实现此接口; 否则返回false 。 如果这个Class对象表示一个原始类型，则此方法返回false 。

isInterface

boolean isInterface ()

确定指定的 Class对象是否表示接口类型。

isLocalClass

boolean isLocalClass ()

当且仅当基础类是本地类时返回 true 。

isMemberClass

boolean isMemberClass ()

当且仅当基础类是成员类时返回 true 。

isPrimitive

boolean isPrimitive ()

确定指定的 Class对象是否表示基元类型。

有九个预定义的Class对象来表示八种基本类型和void。 这些是由Java虚拟机创建，并且具有相同的名称为他们所代表的基本类型，即boolean ， byte ， char ， short ， int ， long ， float ，并double 。

这些对象只能通过以下公共静态最终变量访问，并且是此方法返回的唯一 Class对象 true 。

isSynthetic

boolean isSynthetic ()

如果此类是一个合成类，则返回true ; 否则返回false 。

newInstance

T newInstance ()

创建由此Class对象表示的类的新实例。 该类被实例化，就像具有空参数列表的new表达式一样。 如果该类尚未初始化，则该类将被初始化。

请注意，此方法传播由nullary构造函数抛出的任何异常，包括检查的异常。 使用此方法可以有效绕过编译时异常检查，否则编译器会执行该异常。 Constructor.newInstance方法通过将构造函数抛出的任何异常包装在（checked） InvocationTargetException避免此问题。

toString

String toString ()

将对象转换为字符串。 字符串表示形式是字符串“class”或“interface”，后跟一个空格，然后是由getName返回格式的类的完全限定名称。 如果此Class对象表示基元类型，则此方法返回基元类型的名称。 如果此Class对象表示void，则此方法返回“void”。