- java.lang.Object
-
- java.lang.Class<T>
-
- 参数类型
-
T
- 此类
对象建模的类的类型。 例如,String.class
的类型是Class<String>
。 如果正在建模的类未知,请使用Class<?>
。
- 实现的所有接口
-
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
也表示为类
对象。类
没有公共构造函数。 而是当类加载器调用defineClass
方法之一并传递class
文件的字节时,Java虚拟机会自动构造类
对象。类
类
的方法暴露了类或接口的许多特征。 大多数特性派生自类加载器传递给Java虚拟机的class
文件。 一些特性由运行时的类加载环境决定,例如getModule()
返回的模块。类
类
某些方法公开Java源代码中的类或接口的声明是否包含在另一个声明中。 其他方法描述了类或接口如何位于嵌套中 。 nest是一组类和接口,在同一运行时包中,允许相互访问其private
成员。 类和接口称为nestmates 。 一个巢穴充当巢主 ,并列举属于巢的其他巢穴; 它们中的每一个又将其记录为嵌套主机。 属于嵌套的类(包括其主机)的类和接口是在生成class
文件时确定的,例如,Java编译器通常会将顶级类记录为嵌套的主机,其中其他成员是类,声明包含在顶级类声明中的接口。以下示例使用
类
对象来打印对象的类名:void printClassName(Object obj) { System.out.println("The class of " + obj + " is " + obj.getClass().getName()); }
也可以使用类文字为指定类型(或void)获取
类
对象。 参见The Java™ Language Specification的第15.8.2节。 例如:System.out.println("The name of class Foo is: "+Foo.class.getName());
- 从以下版本开始:
- 1.0
- 另请参见:
-
ClassLoader.defineClass(byte[], int, int)
, Serialized Form
-
-
方法摘要
所有方法 静态方法 实例方法 具体的方法 弃用的方法 变量和类型 方法 描述 <U> 类<? extends U>
asSubclass(类<U> clazz)
转换此类
对象以表示由指定的类对象表示的类的子类。T
cast(Object obj)
将对象类
为此类
对象表示的类或接口。boolean
desiredAssertionStatus()
如果要在调用此方法时初始化,则返回将分配给此类的断言状态。static 类<?>
forName(模块 module, String name)
返回类
给定 binary name给定的模块中。static 类<?>
forName(String className)
返回与具有给定字符串名称的类或接口关联的类
对象。static 类<?>
forName(String name, boolean initialize, ClassLoader loader)
使用给定的类加载器返回与具有给定字符串名称的类或接口关联的类
对象。AnnotatedType[]
getAnnotatedInterfaces()
返回AnnotatedType
对象的数组,AnnotatedType
对象表示使用类型来指定此类
对象所表示的实体的超类
。AnnotatedType
getAnnotatedSuperclass()
返回一个AnnotatedType
对象,该对象表示使用类型来指定此类
对象所表示的实体的超类。<A extends Annotation>
AgetAnnotation(类<A> annotationClass)
返回该元素的,如果这样的注释 ,否则返回null指定类型的注释。Annotation[]
getAnnotations()
返回此元素上 存在的注释。<A extends Annotation>
A[]getAnnotationsByType(类<A> annotationClass)
返回与此元素 关联的注释。String
getCanonicalName()
返回Java语言规范定义的基础类的规范名称。类<?>[]
getClasses()
返回一个包含类
对象的数组,类
对象表示作为此类
对象所表示的类的成员的所有公共类和接口。ClassLoader
getClassLoader()
返回类的类加载器。类<?>
getComponentType()
返回表示数组的组件类型的类
。构造器<T>
getConstructor(类<?>... parameterTypes)
返回一个构造器
对象,该对象反映此类
对象所表示的类的指定公共构造函数。构造器<?>[]
getConstructors()
返回一个包含构造器
对象的数组,构造器
对象反映了此类
对象所表示的类的所有公共构造函数。<A extends Annotation>
AgetDeclaredAnnotation(类<A> annotationClass)
如果 直接存在这样的注释,则返回指定类型的此元素的注释,否则返回null。Annotation[]
getDeclaredAnnotations()
返回 直接出现在此元素上的注释。<A extends Annotation>
A[]getDeclaredAnnotationsByType(类<A> annotationClass)
如果此类注释 直接存在或 间接存在 ,则返回指定类型的此元素的注释。类<?>[]
getDeclaredClasses()
返回类
对象的数组,类
对象反映声明为此类
对象所表示的类的成员的所有类和接口。构造器<T>
getDeclaredConstructor(类<?>... parameterTypes)
返回一个构造器
对象,该对象反映此类
对象所表示的类或接口的指定构造函数。构造器<?>[]
getDeclaredConstructors()
返回构造器
对象的数组,构造器
对象反映由此类
对象表示的类声明的所有构造函数。字段
getDeclaredField(String name)
返回字段
对象,该对象反映此类
对象表示的类或接口的指定声明字段。字段[]
getDeclaredFields()
返回字段
对象的数组,字段
对象反映由此类
对象表示的类或接口声明的所有字段。方法
getDeclaredMethod(String name, 类<?>... parameterTypes)
返回方法
对象,该对象反映此类
对象表示的类或接口的指定声明方法。方法[]
getDeclaredMethods()
返回一个包含方法
对象的数组,方法
对象反映此类
对象表示的类或接口的所有已声明方法,包括public,protected,default(package)访问和私有方法,但不包括继承的方法。类<?>
getDeclaringClass()
如果此类
对象表示的类或接口是另一个类的成员,则返回表示声明它的类的类
对象。类<?>
getEnclosingClass()
返回基础类的直接封闭类。构造器<?>
getEnclosingConstructor()
如果此类
对象表示构造函数中的本地或匿名类,则返回表示基础类的直接封闭构造函数的构造器
对象。方法
getEnclosingMethod()
如果此类
对象表示方法中的本地或匿名类,则返回方法
对象,该对象表示基础类的直接封闭方法。T[]
getEnumConstants()
返回此枚举类的元素,如果此Class对象不表示枚举类型,则返回null。字段
getField(String name)
返回字段
对象,该对象反映此类
对象表示的类或接口的指定公共成员字段。字段[]
getFields()
返回一个包含字段
对象的数组,字段
对象反映此类
对象所表示的类或接口的所有可访问公共字段。Type[]
getGenericInterfaces()
返回表示由此对象表示的类或接口直接实现的接口的Type
。Type
getGenericSuperclass()
返回Type
表示此所表示的实体(类,接口,基本类型或void)的直接超类类
。类<?>[]
getInterfaces()
返回由此对象表示的类或接口直接实现的接口。方法
getMethod(String name, 类<?>... parameterTypes)
返回方法
对象,该对象反映此类
对象表示的类或接口的指定公共成员方法。方法[]
getMethods()
返回一个包含方法
对象的数组,方法
对象反映此类
对象所表示的类或接口的所有公共方法,包括由类或接口声明的那些以及从超类和超接口继承的那些。int
getModifiers()
返回此类或接口的Java语言修饰符,以整数编码。模块
getModule()
返回此类或接口所属的模块。String
getName()
返回此类
对象表示的实体名称(类,接口,数组类,基本类型或void),作为String
。类<?>
getNestHost()
返回类
对象所代表的类或接口所属的 nest的嵌套主机。类<?>[]
getNestMembers()
返回一个包含类
对象的数组,类
对象表示作为此类
对象所代表的类或接口所属的嵌套成员的所有类和接口。软件包
getPackage()
获取此类的包。String
getPackageName()
返回完全限定的包名称。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)
如果此元素上 存在指定类型的注释,则返回true,否则返回false。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
isNestmateOf(类<?> c)
确定给定的类
是否是此类
对象所表示的类或接口的类
。boolean
isPrimitive()
确定指定的类
对象是否表示基本类型。boolean
isSynthetic()
如果此类是合成类,则返回true
; 否则返回false
。T
newInstance()
已过时。此方法传播由Nullary构造函数抛出的任何异常,包括已检查的异常。String
toGenericString()
返回描述此类
的字符串,包括有关修饰符和类型参数的信息。String
toString()
将对象转换为字符串。
-
-
-
方法详细信息
-
toString
public String toString()
将对象转换为字符串。 字符串表示形式是字符串“class”或“interface”,后跟一个空格,然后是getName
返回的格式的类的完全限定名。 如果此类
对象表示基本类型,则此方法返回基本类型的名称。 如果此类
对象表示void,则此方法返回“void”。 如果此类
对象表示数组类型,则此方法返回“class”,后跟getName
。
-
toGenericString
public String toGenericString()
返回描述此类
的字符串,包括有关修饰符和类型参数的信息。 该字符串格式类型修饰符列表,如果有的话,后面的那种类型(基本类型和空字符串class
,枚举
,interface
,或@
interface
,如适用),其次是类型的名称,然后是angle-bracketed逗号分隔的类型类型参数列表(如果有)。 空格用于将修饰符彼此分开,并将任何修饰符与类型类型分开。 修饰符以规范顺序出现。 如果没有类型参数,则省略类型参数列表。 对于数组类型,字符串以类型名称开头,后跟以角度括起来的逗号分隔的类型参数列表(如果有),后跟[]
字符序列,每个数组维度一组括号。注意,由于正在生成关于类型的运行时表示的信息,因此可能存在不在源代码上存在或在源代码上非法的修饰符。
- 结果
-
描述此
类
的字符串,包括有关修饰符和类型参数的信息 - 从以下版本开始:
- 1.8
-
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
为null,则通过引导类加载器加载该类。 仅当initialize
参数为true
并且之前尚未初始化时,才会初始化true
。如果
name
表示基本类型或void,则将尝试在未命名的包中找到用户定义的类,其名称为name
。 因此,此方法不能用于获取表示基本类型或void的任何类
对象。如果
name
表示数组类,则加载数组类的组件类型但不进行初始化。例如,在实例方法中,表达式为:
Class.forName("Foo")
Class.forName("Foo", true, this.getClass().getClassLoader())
- 参数
-
name
- 所需类的完全限定名称 -
initialize
- 如果true
该类将被初始化。 请参见Java语言规范的第12.4节。 -
loader
- 必须从中加载类的类加载器 - 结果
- 表示所需类的类对象
- 异常
-
LinkageError
- 如果链接失败 -
ExceptionInInitializerError
- 如果此方法引发的初始化失败 -
ClassNotFoundException
- 如果指定的类加载器无法找到该类 -
SecurityException
- 如果存在安全管理器,并且loader
是null
,并且调用者的类加载器不是null
,并且调用者没有RuntimePermission
("getClassLoader")
- 从以下版本开始:
- 1.2
- 另请参见:
-
forName(String)
,ClassLoader
-
forName
public static 类<?> forName(模块 module, String name)
返回类
给定binary name给定的模块中。此方法尝试定位,加载和链接类或接口。 它不运行类初始化程序。 如果找不到该类,则此方法返回
null
。如果给定模块的类加载器定义了其他模块,并且给定名称是在不同模块中定义的类,则此方法在加载类后返回
null
。此方法不检查其调用者是否可以访问所请求的类。
- API Note:
-
此方法在失败时返回
null
而不是抛出ClassNotFoundException
,如forName(String, boolean, ClassLoader)
方法所做的那样 。 如果调用者在另一个模块中加载一个类,则安全检查是基于堆栈的权限检查。 - 参数
-
模块
- 模块 -
name
- 该 课程的binary name - 结果
-
类
给定模块中定义的给定名称的对象;null
如果找不到。 - 异常
-
NullPointerException
- 如果给定的模块或名称是null
-
LinkageError
- 如果链接失败 -
SecurityException
-- 如果调用者不是指定的模块,则拒绝
RuntimePermission("getClassLoader")
权限; 要么 - 访问模块内容被拒绝。 例如,当类加载器调用
ModuleReader.open(String)
以读取模块中类文件的字节时,将执行权限检查。
- 如果调用者不是指定的模块,则拒绝
- 从以下版本开始:
- 9
-
newInstance
@Deprecated(since="9") public T newInstance() throws InstantiationException, IllegalAccessException
Deprecated.This method propagates any exception thrown by the nullary constructor, including a checked exception. Use of this method effectively bypasses the compile-time exception checking that would otherwise be performed by the compiler. TheConstructor.newInstance
method avoids this problem by wrapping any exception thrown by the constructor in a (checked)InvocationTargetException
.The call
can be replaced byclazz.newInstance()
The latter sequence of calls is inferred to be able to throw the additional exception typesclazz.getDeclaredConstructor().newInstance()
InvocationTargetException
andNoSuchMethodException
. Both of these exception types are subclasses ofReflectiveOperationException
.创建此类
对象表示的类的新实例。 该类实例化为new
带有空参数列表的表达式。 如果尚未初始化,则初始化该类。- 结果
- 由此对象表示的类的新分配实例。
- 异常
-
IllegalAccessException
- 如果无法访问该类或其无效构造函数。 -
InstantiationException
- 如果此类
表示抽象类,接口,数组类,基元类型或void; 或者如果该类没有无效的构造函数; 或者如果实例化由于其他原因而失败。 -
ExceptionInInitializerError
- 如果此方法引发的初始化失败。 -
SecurityException
- 如果存在安全管理器 s ,并且调用者的类加载器与当前类的类加载器不同或是其祖先,则调用s.checkPackageAccess()
将拒绝访问此类的包。
-
isInstance
public boolean isInstance(Object obj)
确定指定的Object
是否与此类
表示的对象分配兼容。 此方法是Java语言instanceof
运算符的动态等效项。 该方法返回true
如果指定Object
参数为非空并且可以转换为通过此表示的引用类型类
对象不提高一个ClassCastException.
它返回false
否则。具体来说,如果此
类
对象表示声明的类,如果指定的Object
参数是所表示的类(或其任何子类)的实例,则此方法返回true
; 否则返回false
。 如果此类
对象表示数组类,如果指定的Object
参数可以通过标识转换或扩展引用转换转换为数组类的对象,则此方法返回true
; 否则返回false
。 如果此类
对象表示接口,则如果指定的Object
参数的类或任何超类实现此接口,则此方法返回true
; 否则返回false
。 如果此类
对象表示基本类型,则此方法返回false
。- 参数
-
obj
- 要检查的对象 - 结果
-
如果
obj
是obj
的实例,obj
true - 从以下版本开始:
- 1.1
-
isAssignableFrom
public boolean isAssignableFrom(类<?> cls)
确定此类
对象表示的类或接口是否与指定的类
参数表示的类或接口相同,或者是它的超类或超接口。 如果是这样,它返回true
; 否则返回false
。 如果此类
对象表示基本类型,如果指定的类
参数恰好是此类
对象,则此方法返回true
; 否则返回false
。具体来说,此方法测试是否可以通过标识转换或扩展引用转换将指定的
类
参数表示的类型转换为此类
对象表示的类型。 有关详细信息 ,请参阅Java语言规范 ,第5.1.1和5.1.4节。- 参数
-
cls
- 要检查的类
对象 - 结果
-
boolean
值,指示是否可以将类型为cls
对象分配给此类的对象 - 异常
-
NullPointerException
- 如果指定的Class参数为null。 - 从以下版本开始:
- 1.1
-
isInterface
public boolean isInterface()
确定指定的类
对象是否表示接口类型。- 结果
-
true
如果此对象表示接口; 否则为false
。
-
isArray
public boolean isArray()
确定此类
对象是否表示数组类。- 结果
-
true
如果此对象表示数组类; 否则为false
。 - 从以下版本开始:
- 1.1
-
isPrimitive
public boolean isPrimitive()
确定指定的类
对象是否表示基本类型。有九个预定义的
类
对象来表示八种基本类型和void。 这些是由Java虚拟机创建,并且具有相同的名称为他们所代表的基本类型,即boolean
,byte
,char
,short
,int
,long
,float
和double
。这些对象只能通过以下公共静态最终变量访问,并且是此方法返回
true
的唯一类
对象。- 结果
- 当且仅当此类表示基本类型时才返回true
- 从以下版本开始:
- 1.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
如果此类对象表示注释类型; 否则为false
- 从以下版本开始:
- 1.5
-
isSynthetic
public boolean isSynthetic()
如果此类是合成类,则返回true
; 否则返回false
。- 结果
-
true
当且仅当此类是Java语言规范定义的合成类时。 - 从以下版本开始:
- 1.5
- See The Java™ Language Specification:
- 13.1二进制形式
-
getName
public String getName()
返回此类
对象表示的实体名称(类,接口,数组类,基本类型或void),作为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"
- 结果
- 此对象表示的类或接口的名称。
-
getClassLoader
public ClassLoader getClassLoader()
返回类的类加载器。 某些实现可能使用null来表示引导类加载器。 如果此类由引导类加载器加载,则此方法将在此类实现中返回null。如果此对象表示基本类型或void,则返回null。
- 结果
- 加载此对象表示的类或接口的类加载器。
- 异常
-
SecurityException
- 如果存在安全管理器,并且调用者的类加载器不是null
,并且与请求类加载器的类的类加载器的祖先不同,并且调用者没有RuntimePermission
("getClassLoader")
- 另请参见:
-
ClassLoader
,SecurityManager.checkPermission(java.security.Permission)
,RuntimePermission
-
getModule
public 模块 getModule()
返回此类或接口所属的模块。 如果此类表示数组类型,则此方法返回元素类型的模块
。 如果此类表示基本类型或void,则返回java.base
模块的模块
对象。 如果此类位于未命名的模块中,则返回模块
的类加载器的unnamed模块
。- 结果
- 此类或接口所属的模块
- 从以下版本开始:
- 9
-
getTypeParameters
public TypeVariable<类<T>>[] getTypeParameters()
返回的数组TypeVariable
对象表示通过此表示的一般声明声明的类型变量GenericDeclaration
目的,在声明的顺序。 如果基础泛型声明未声明类型变量,则返回长度为0的数组。- Specified by:
-
getTypeParameters
在接口GenericDeclaration
- 结果
-
一个
TypeVariable
对象的数组,表示此泛型声明声明的类型变量 - 异常
-
GenericSignatureFormatError
- 如果此通用声明的通用签名不符合 The Java™ Virtual Machine Specification中指定的格式 - 从以下版本开始:
- 1.5
-
getSuperclass
public 类<? super T> getSuperclass()
返回表示此类
表示的实体的直接超类(类,接口,基本类型或void)的类
。 如果此类
表示Object
类,接口,基本类型或void,则返回null。 如果此对象表示数组类,则返回表示Object
类的类
对象。- 结果
- 此对象表示的类的直接超类
-
getGenericSuperclass
public Type getGenericSuperclass()
返回Type
表示此所表示的实体(类,接口,基本类型或void)的直接超类类
。如果超类是参数化类型,则返回的
Type
对象必须准确反映源代码中使用的实际类型参数。 如果之前尚未创建超类,则创建表示超类的参数化类型。 有关参数化类型的创建过程的语义,请参阅ParameterizedType
的声明。 如果此类
表示Object
类,接口,基本类型或void,则返回null。 如果此对象表示数组类,则返回表示Object
类的类
对象。- 结果
- 此对象表示的类的直接超类
- 异常
-
GenericSignatureFormatError
- 如果泛型类签名不符合 The Java™ Virtual Machine Specification中指定的格式 -
TypeNotPresentException
- 如果泛型超类引用不存在的类型声明 -
MalformedParameterizedTypeException
- 如果泛型超类引用无法以任何原因实例化的参数化类型 - 从以下版本开始:
- 1.5
-
getPackage
public 软件包 getPackage()
获取此类的包。如果此类表示数组类型,基本类型或void,则此方法返回
null
。- 结果
- 这个类的包。
-
getPackageName
public String getPackageName()
返回完全限定的包名称。如果此类是顶级类,则此方法返回该类所属的包的完全限定名称,如果该类位于未命名的包中,则返回空字符串。
如果该类是一个成员的类,则此方法等效于调用
getPackageName()
上enclosing class 。如果该类是local class或anonymous class ,则此方法等效于调用
getPackageName()
上declaring class的的enclosing method或enclosing constructor 。如果此类表示数组类型,则此方法返回元素类型的包名称。 如果此类表示基本类型或void,则返回包名“
java.lang
”。- 结果
- 完全限定的包名称
- 从以下版本开始:
- 9
- See The Java™ Language Specification:
- 6.7完全合格的名称
-
getInterfaces
public 类<?>[] getInterfaces()
返回由此对象表示的类或接口直接实现的接口。如果此对象表示类,则返回值是一个数组,其中包含表示该类直接实现的所有接口的对象。 数组中接口对象的顺序对应于此对象所表示的类的声明的
implements
子句中的接口名称的顺序。 例如,鉴于声明:class Shimmer implements FloorWax, DessertTopping { ... }
s
是实例Shimmer
; 表达式的值:s.getClass().getInterfaces()[0]
类
对象,表示接口FloorWax
; 和价值:s.getClass().getInterfaces()[1]
类
对象,表示接口DessertTopping
。如果此对象表示接口,则该数组包含表示由接口直接扩展的所有接口的对象。 数组中接口对象的顺序对应于此对象表示的接口声明的
extends
子句中接口名称的顺序。如果此对象表示不实现接口的类或接口,则该方法返回长度为0的数组。
如果此对象表示基本类型或void,则该方法返回长度为0的数组。
如果此
类
对象表示阵列类型,Cloneable
顺序返回接口Cloneable
和java.io.Serializable
。- 结果
- 由此类直接实现的接口数组
-
getGenericInterfaces
public Type[] getGenericInterfaces()
返回表示由此对象表示的类或接口直接实现的接口的Type
。如果超接口是参数化类型,则
Type
返回的Type
对象必须准确反映源代码中使用的实际类型参数。 如果之前尚未创建,则创建表示每个超级接口的参数化类型。 有关参数化类型的创建过程的语义,请参阅ParameterizedType
的声明。如果此对象表示类,则返回值是一个数组,其中包含表示该类直接实现的所有接口的对象。 数组中接口对象的顺序对应于此对象所表示的类的声明的
implements
子句中的接口名称的顺序。如果此对象表示接口,则该数组包含表示由接口直接扩展的所有接口的对象。 数组中接口对象的顺序对应于此对象表示的接口声明的
extends
子句中接口名称的顺序。如果此对象表示不实现接口的类或接口,则该方法返回长度为0的数组。
如果此对象表示基本类型或void,则该方法返回长度为0的数组。
如果此
类
对象表示阵列类型,Cloneable
顺序返回接口Cloneable
和java.io.Serializable
。- 结果
- 由此类直接实现的接口数组
- 异常
-
GenericSignatureFormatError
- 如果泛型类签名不符合 The Java™ Virtual Machine Specification中指定的格式 -
TypeNotPresentException
- 如果任何通用超接口引用了不存在的类型声明 -
MalformedParameterizedTypeException
- 如果任何通用超接口引用无法以任何原因实例化的参数化类型 - 从以下版本开始:
- 1.5
-
getComponentType
public 类<?> getComponentType()
返回表示数组的组件类型的类
。 如果此类不表示数组类,则此方法返回null。- 结果
-
类
表示类
的组件类型(如果此类是数组) - 从以下版本开始:
- 1.1
- 另请参见:
-
Array
-
getModifiers
public int getModifiers()
返回此类或接口的Java语言修饰符,以整数编码。 修饰符由Java虚拟机的常数为public
,protected
,private
,final
,static
,abstract
和interface
; 它们应该使用Modifier
类的方法解码。如果底层类是一个数组类,则其
public
,private
和protected
改性剂是相同的组分的类型。 如果此类
表示基本类型或void,则其public
修饰符始终为true
,其protected
和private
修饰符始终为false
。 如果此对象表示数组类,基本类型或void,则其final
修饰符始终为true
,其界面修饰符始终为false
。 其他修饰符的值不是由本规范确定的。修饰符编码在Java虚拟机规范表4.1中定义。
- 结果
-
int
表示int
的修饰符 - 从以下版本开始:
- 1.1
- 另请参见:
-
Modifier
-
getSigners
public Object[] getSigners()
获取此类的签名者。- 结果
- 此类的签名者,如果没有签名者则为null。 特别是,如果此对象表示基本类型或void,则此方法返回null。
- 从以下版本开始:
- 1.1
-
getEnclosingMethod
public 方法 getEnclosingMethod() throws SecurityException
如果此类
对象表示方法中的本地或匿名类,则返回方法
对象,该对象表示基础类的直接封闭方法。 否则返回null
。 特别是,如果基础类是由类型声明,实例初始化程序或静态初始化程序直接包含的本地或匿名类,则此方法返回null
。- 结果
-
如果该类是本地或匿名类,则为基础类的直接封闭方法;
否则
null
。 - 异常
-
SecurityException
- 如果存在安全管理器s且满足以下任一条件:- 调用者的类加载器与封闭类的类加载器不同,并且调用
s.checkPermission
方法和RuntimePermission("accessDeclaredMembers")
拒绝访问封闭类中的方法 - 调用者的类加载器与封闭类的类加载器不同或是祖先,并且
s.checkPackageAccess()
的调用拒绝访问封闭类的包
- 调用者的类加载器与封闭类的类加载器不同,并且调用
- 从以下版本开始:
- 1.5
-
getEnclosingConstructor
public 构造器<?> getEnclosingConstructor() throws SecurityException
如果此类
对象表示构造函数中的本地或匿名类,则返回构造器
对象,该对象表示基础类的直接封闭构造函数。 否则返回null
。 特别是,如果基础类是由类型声明,实例初始化程序或静态初始化程序直接包含的本地或匿名类,则此方法返回null
。- 结果
-
如果该类是本地或匿名类,则为基础类的直接封闭构造函数;
否则
null
。 - 异常
-
SecurityException
- 如果存在安全管理器s且满足以下任一条件:- 调用者的类加载器与封闭类的类加载器不同,并且调用
s.checkPermission
方法,RuntimePermission("accessDeclaredMembers")
拒绝访问封闭类中的构造函数 - 调用者的类加载器与封闭类的类加载器不同或是祖先,并且
s.checkPackageAccess()
的调用拒绝访问封闭类的包
- 调用者的类加载器与封闭类的类加载器不同,并且调用
- 从以下版本开始:
- 1.5
-
getDeclaringClass
public 类<?> getDeclaringClass() throws SecurityException
如果此类
对象表示的类或接口是另一个类的成员,则返回表示声明它的类的类
对象。 如果此类或接口不是任何其他类的成员,则此方法返回null。 如果此类
对象表示数组类,基本类型或void,则此方法返回null。- 结果
- 这个类的声明类
- 异常
-
SecurityException
- 如果存在安全管理器 s ,并且调用者的类加载器与声明类的类加载器不同或者是祖先,并且s.checkPackageAccess()
的调用拒绝访问声明类的包 - 从以下版本开始:
- 1.1
-
getEnclosingClass
public 类<?> getEnclosingClass() throws SecurityException
返回基础类的直接封闭类。 如果底层类是顶级类,则此方法返回null
。- 结果
- 基础类的直接封闭类
- 异常
-
SecurityException
- 如果存在安全管理器 s ,并且调用者的类加载器与封闭类的类加载器不同或者是祖先,并且调用s.checkPackageAccess()
拒绝访问封闭类的包 - 从以下版本开始:
- 1.5
-
getSimpleName
public String getSimpleName()
返回源代码中给出的基础类的简单名称。 如果基础类是匿名的,则返回空字符串。数组的简单名称是附加了“[]”的组件类型的简单名称。 特别是组件类型为匿名的数组的简单名称是“[]”。
- 结果
- 底层类的简单名称
- 从以下版本开始:
- 1.5
-
getTypeName
public String getTypeName()
返回此类型名称的信息字符串。- Specified by:
-
getTypeName
在接口Type
- 结果
- 这种类型名称的信息字符串
- 从以下版本开始:
- 1.8
-
getCanonicalName
public String getCanonicalName()
返回Java语言规范定义的基础类的规范名称。 如果基础类没有规范名称(即,如果它是本地或匿名类或其组件类型没有规范名称的数组),则返回null。- 结果
-
基础类的规范名称(如果存在),否则为
null
。 - 从以下版本开始:
- 1.5
-
isAnonymousClass
public boolean isAnonymousClass()
当且仅当基础类是匿名类时,返回true
。- 结果
-
true
当且仅当此类是匿名类时。 - 从以下版本开始:
- 1.5
-
isLocalClass
public boolean isLocalClass()
当且仅当基础类是本地类时,返回true
。- 结果
-
true
当且仅当此类是本地类时。 - 从以下版本开始:
- 1.5
-
isMemberClass
public boolean isMemberClass()
当且仅当基础类是成员类时,返回true
。- 结果
-
true
当且仅当此类是成员类时。 - 从以下版本开始:
- 1.5
-
getClasses
public 类<?>[] getClasses()
返回一个数组,其中包含类
对象,这些对象表示作为此类
对象所表示的类的成员的所有公共类和接口。 这包括从超类继承的公共类和接口成员,以及由类声明的公共类和接口成员。 如果此类
对象没有公共成员类或接口,则此方法返回长度为0的数组。 如果此类
对象表示基本类型,数组类或void,则此方法还返回长度为0的数组。- 结果
-
类
对象的数组,表示类
的公共成员 - 异常
-
SecurityException
- 如果存在安全管理器 s ,并且调用者的类加载器与当前类的类加载器不同或是其祖先,则调用s.checkPackageAccess()
将拒绝访问此类的包。 - 从以下版本开始:
- 1.1
-
getFields
public 字段[] getFields() throws SecurityException
返回一个包含字段
对象的数组,字段
对象反映此类
对象所表示的类或接口的所有可访问公共字段。如果此
类
对象表示没有可访问的公共字段的类或接口,则此方法返回长度为0的数组。如果此
类
对象表示一个类,则此方法返回该类及其所有超类和超接口的公共字段。如果此
类
对象表示接口,则此方法返回接口及其所有超接口的字段。如果此
类
对象表示数组类型,基本类型或void,则此方法返回长度为0的数组。返回数组中的元素未排序,并且不按任何特定顺序排列。
- 结果
-
表示公共字段的
字段
对象的数组 - 异常
-
SecurityException
- 如果存在安全管理器 s ,并且调用者的类加载器与当前类的类加载器不同或是其祖先,则调用s.checkPackageAccess()
将拒绝访问此类的包。 - 从以下版本开始:
- 1.1
- See The Java™ Language Specification:
- 8.2集体成员,8.3现场声明
-
getMethods
public 方法[] getMethods() throws SecurityException
返回一个包含方法
对象的数组,方法
对象反映此类
对象所表示的类或接口的所有公共方法,包括由类或接口声明的那些以及从超类和超接口继承的那些。如果此
类
对象表示一个数组类型,则返回的阵列具有方法
对于每个由阵列类型从继承的公共方法对象Object
。 它不包含方法
对象为clone()
。如果此
类
对象表示接口,则返回的数组不包含Object
任何隐式声明的方法。 因此,如果在此接口或其任何超接口中未显式声明任何方法,则返回的数组的长度为0.(请注意,表示类的类
对象始终具有公共方法,继承自Object
)返回的数组永远不包含名称为“
<init>
”或“<clinit>
”的方法。返回数组中的元素未排序,并且不按任何特定顺序排列。
通常,结果按照以下4步算法计算。 设C是此
类
对象表示的类或接口:- 方法联合包括:
- C声明了
getDeclaredMethods()
返回的公共实例和静态方法,并过滤为仅包含公共方法。 - 如果C是
Object
以外的类,则包括在C的超类上递归调用此算法的结果。 - 包括在C的所有直接超接口上递归调用此算法的结果,但仅包括实例方法。
- C声明了
- 来自步骤1的联合被划分为具有相同签名(名称,参数类型)和返回类型的方法的子集。
- 在每个这样的子集内,仅选择最具体的方法。 设方法M是来自具有相同签名和返回类型的一组方法的方法。 如果在同一组中没有这样的方法N!= M,则M是最具体的,使得N比M更具特异性.N如果出现以下情况,则N比M更具体:
- N由类声明,M由接口声明; 要么
- N和M都是由类或两者通过接口声明的,并且N的声明类型与M的声明类型相同或者是M的声明类型的子类型(显然,如果M和N的声明类型是相同类型,则M和N是相同的方法) 。
- 该算法的结果是来自步骤3的所有选定方法的并集。
- API Note:
- 在类中可能有多个具有特定名称和参数类型的方法,因为虽然Java语言禁止类声明具有相同签名但返回类型不同的多个方法,但Java虚拟机却没有。 虚拟机中增加的灵活性可用于实现各种语言功能。 例如,协变返回可以用bridge methods实现; 桥接方法和重写方法将具有相同的签名但返回类型不同。
- 结果
-
方法
对象的数组,表示方法
的公共方法 - 异常
-
SecurityException
- 如果存在安全管理器 s ,并且调用者的类加载器与当前类的类加载器不同或是其祖先,则调用s.checkPackageAccess()
将拒绝访问此类的包。 - 从以下版本开始:
- 1.1
- See The Java™ Language Specification:
- 8.2类成员,8.4方法声明
- 方法联合包括:
-
getConstructors
public 构造器<?>[] getConstructors() throws SecurityException
返回一个包含构造器
对象的数组,构造器
对象反映了此类
对象所表示的类的所有公共构造函数。 如果类没有公共构造函数,或者类是数组类,或者类反映了基本类型或void,则返回长度为0的数组。 请注意,虽然此方法返回Constructor<T>
对象的数组(此类中的构造函数数组),但此方法的返回类型为Constructor<?>[]
而不是预期的Constructor<T>[]
。 这个信息量较少的返回类型是必要的,因为从此方法返回后,可以修改数组以保存不同类的构造器
对象,这将违反Constructor<T>[]
的类型保证。- 结果
-
构造器
对象的数组,表示构造器
的公共构造函数 - 异常
-
SecurityException
- 如果存在安全管理器 s ,并且调用者的类加载器与当前类的类加载器不同或是其祖先,则调用s.checkPackageAccess()
将拒绝访问此类的包。 - 从以下版本开始:
- 1.1
-
getField
public 字段 getField(String name) throws NoSuchFieldException, SecurityException
返回字段
对象,该对象反映此类
对象表示的类或接口的指定公共成员字段。name
参数是String
指定所需字段的简单名称。要反映的字段由下面的算法确定。 设C为此对象表示的类或接口:
- 如果C声明一个具有指定名称的公共字段,那就是要反映的字段。
- 如果在上面的步骤1中没有找到字段,则该算法递归地应用于C的每个直接超接口。直接超接口按它们被声明的顺序搜索。
- 如果在上面的步骤1和2中没有找到字段,并且C具有超类S,则在S上递归调用该算法。如果C没有超类,则抛出
NoSuchFieldException
。
如果此
类
对象表示数组类型,则此方法找不到数组类型的length
字段。- 参数
-
name
- 字段名称 - 结果
-
由
name
指定的name
的字段
对象 - 异常
-
NoSuchFieldException
- 如果找不到具有指定名称的字段。 -
NullPointerException
- 如果name
是null
-
SecurityException
- 如果存在安全管理器 s ,并且调用者的类加载器与当前类的类加载器不同或是其祖先,则调用s.checkPackageAccess()
将拒绝访问此类的包。 - 从以下版本开始:
- 1.1
- See The Java™ Language Specification:
- 8.2集体成员,8.3现场声明
-
getMethod
public 方法 getMethod(String name, 类<?>... parameterTypes) throws NoSuchMethodException, SecurityException
返回一个方法
对象,该对象反映此类
对象所表示的类或接口的指定公共成员方法。name
参数是String
指定所需方法的简单名称。parameterTypes
参数是一个类
对象的数组,以声明的顺序标识方法的形式参数类型。 如果parameterTypes
是null
,则将其视为空数组。如果此
类
对象表示数组类型,则该方法找到以阵列型从继承的任何公有方法Object
除了方法clone()
。如果此
类
对象表示接口,则此方法未找到Object
任何隐式声明的方法。 因此,如果在此接口或其任何超接口中未显式声明任何方法,则此方法找不到任何方法。此方法未找到名称为“
<init>
”或“<clinit>
”的任何方法。通常,要反映的方法由随后的4步算法确定。 设C为此
类
对象表示的类或接口:- 方法联合包括:
- C声明了
getDeclaredMethods()
返回的公共实例和静态方法,并过滤为仅包含与给定name
和parameterTypes
匹配的公共方法 - 如果C是
Object
以外的类,则包括在C的超类上递归调用此算法的结果。 - 包括在C的所有直接超接口上递归调用此算法的结果,但仅包括实例方法。
- C声明了
- 此联合被分区为具有相同返回类型的方法子集(步骤1中的方法选择也保证它们具有相同的方法名称和参数类型)。
- 在每个这样的子集内,仅选择最具体的方法。 设方法M是来自具有相同VM签名(返回类型,名称,参数类型)的一组方法的方法。 如果在同一组中没有这样的方法N!= M,则M是最具体的,使得N比M更具特异性.N如果出现以下情况,则N比M更具体:
- N由类声明,M由接口声明; 要么
- N和M都是由类或两者通过接口声明的,并且N的声明类型与M的声明类型相同或者是M的声明类型的子类型(显然,如果M和N的声明类型是相同类型,则M和N是相同的方法) 。
- 该算法的结果是从步骤3中所有选定方法中具有最特定返回类型的方法中任意选择的。设R是来自步骤3中所有选定方法的集合的方法M的返回类型.M是一种方法最具体的返回类型,如果没有这样的方法N!= M来自同一组,具有返回类型S!= R,使得S是由R.class确定的R的子类型。
isAssignableFrom(java.lang.Class<?>)
(S.class)。
- API Note:
- 在类中可能有多个匹配名称和参数类型的方法,因为虽然Java语言禁止类声明具有相同签名但返回类型不同的多个方法,但Java虚拟机却没有。 虚拟机中增加的灵活性可用于实现各种语言功能。 例如,协变返回可以用bridge methods实现; 桥接方法和重写方法将具有相同的签名但返回类型不同。 此方法将返回覆盖方法,因为它具有更具体的返回类型。
- 参数
-
name
- 方法的名称 -
parameterTypes
- 参数列表 - 结果
-
与指定的
name
和parameterTypes
匹配的方法
对象 - 异常
-
NoSuchMethodException
- 如果未找到匹配方法或名称为“<init>”或“<clinit>”。 -
NullPointerException
- 如果name
是null
-
SecurityException
- 如果存在安全管理器 s ,并且调用者的类加载器与当前类的类加载器不同或是其祖先,则调用s.checkPackageAccess()
将拒绝访问此类的包。 - 从以下版本开始:
- 1.1
- See The Java™ Language Specification:
- 8.2类成员,8.4方法声明
- 方法联合包括:
-
getConstructor
public 构造器<T> getConstructor(类<?>... parameterTypes) throws NoSuchMethodException, SecurityException
返回一个构造器
对象,该对象反映此类
对象所表示的类的指定公共构造函数。parameterTypes
参数是一个类
对象的数组,它按声明的顺序标识构造函数的形式参数类型。 如果此类
对象表示在非静态上下文中声明的内部类,则形式参数类型包括显式封闭实例作为第一个参数。要反映的构造函数是此
类
对象所表示的类的公共构造函数,其形式参数类型与parameterTypes
指定的类型相匹配。- 参数
-
parameterTypes
- 参数数组 - 结果
-
与指定的
parameterTypes
匹配的公共构造函数的构造器
对象 - 异常
-
NoSuchMethodException
- 如果找不到匹配的方法。 -
SecurityException
- 如果存在安全管理器 s且调用者的类加载器与当前类的类加载器的不同或类型的祖先相同,则调用s.checkPackageAccess()
将拒绝访问此类的包。 - 从以下版本开始:
- 1.1
-
getDeclaredClasses
public 类<?>[] getDeclaredClasses() throws SecurityException
返回类
对象的数组,类
对象反映声明为此类
对象所表示的类的成员的所有类和接口。 这包括公共,受保护,默认(包)访问以及类声明的私有类和接口,但不包括继承的类和接口。 如果类声明没有类或接口作为成员,或者此类
对象表示基本类型,数组类或void,则此方法返回长度为0的数组。- 结果
-
类
对象的数组,表示类
所有已声明成员 - 异常
-
SecurityException
- 如果存在安全管理器s且满足以下任一条件:- 调用者的类加载器与此类的类加载器不同,并且调用
s.checkPermission
方法和RuntimePermission("accessDeclaredMembers")
拒绝访问RuntimePermission("accessDeclaredMembers")
中的声明类 - 调用者的类加载器与当前类的类加载器不同或是祖先,并且
s.checkPackageAccess()
的调用拒绝访问此类的包
- 调用者的类加载器与此类的类加载器不同,并且调用
- 从以下版本开始:
- 1.1
-
getDeclaredFields
public 字段[] getDeclaredFields() throws SecurityException
返回字段
对象的数组,字段
对象反映由此类
对象表示的类或接口声明的所有字段。 这包括公共,受保护,默认(包)访问和私有字段,但不包括继承的字段。如果此
类
对象表示没有声明字段的类或接口,则此方法返回长度为0的数组。如果此
类
对象表示数组类型,基本类型或void,则此方法返回长度为0的数组。返回数组中的元素未排序,并且不按任何特定顺序排列。
- 结果
-
字段
对象的数组,表示字段
所有声明字段 - 异常
-
SecurityException
- 如果存在安全管理器s且满足以下任一条件:- 调用者的类加载器与此类的类加载器不同,并且调用
s.checkPermission
方法和RuntimePermission("accessDeclaredMembers")
拒绝访问RuntimePermission("accessDeclaredMembers")
中的声明字段 - 调用者的类加载器与当前类的类加载器不同或是祖先,并且
s.checkPackageAccess()
的调用拒绝访问此类的包
- 调用者的类加载器与此类的类加载器不同,并且调用
- 从以下版本开始:
- 1.1
- See The Java™ Language Specification:
- 8.2集体成员,8.3现场声明
-
getDeclaredMethods
public 方法[] getDeclaredMethods() throws SecurityException
返回一个包含方法
对象的数组,方法
对象反映此类
对象表示的类或接口的所有已声明方法,包括公共,受保护,默认(包)访问和私有方法,但不包括继承的方法。如果此
类
对象表示具有多个具有相同名称和参数类型但返回类型不同的声明方法的类型,则返回的数组对于每个此类方法都有一个方法
对象。如果此
类
对象表示具有类初始化方法的类型<clinit>
,则返回的阵列不具有相应的方法
对象。如果此
类
对象表示没有声明方法的类或接口,则返回的数组的长度为0。如果此
类
对象表示数组类型,基本类型或void,则返回的数组的长度为0。返回数组中的元素未排序,并且不按任何特定顺序排列。
- 结果
-
方法
对象的数组,表示方法
所有已声明方法 - 异常
-
SecurityException
- 如果存在安全管理器s且满足以下任一条件:- 调用者的类加载器与此类的类加载器不同,并且调用
s.checkPermission
方法,RuntimePermission("accessDeclaredMembers")
拒绝访问RuntimePermission("accessDeclaredMembers")
中的声明方法 - 调用者的类加载器与当前类的类加载器的不同或者是祖先,并且
s.checkPackageAccess()
的调用拒绝访问此类的包
- 调用者的类加载器与此类的类加载器不同,并且调用
- 从以下版本开始:
- 1.1
- See The Java™ Language Specification:
- 8.2类成员,8.4方法声明
-
getDeclaredConstructors
public 构造器<?>[] getDeclaredConstructors() throws SecurityException
返回构造器
对象的数组,构造器
对象反映由此类
对象表示的类声明的所有构造函数。 这些是公共,受保护,默认(包)访问和私有构造函数。 返回的数组中的元素没有排序,也没有任何特定的顺序。 如果类具有默认构造函数,则它包含在返回的数组中。 如果此类
对象表示接口,基本类型,数组类或void,则此方法返回长度为0的数组。请参阅Java语言规范 ,第8.2节。
- 结果
-
构造器
对象的数组,表示构造器
所有声明的构造函数 - 异常
-
SecurityException
- 如果存在安全管理器s且满足以下任一条件:- 调用者的类加载器与此类的类加载器不同,并且调用
s.checkPermission
方法和RuntimePermission("accessDeclaredMembers")
拒绝访问RuntimePermission("accessDeclaredMembers")
中的已声明构造函数 - 调用者的类加载器与当前类的类加载器或祖先不同,并且调用
s.checkPackageAccess()
拒绝访问此类的包
- 调用者的类加载器与此类的类加载器不同,并且调用
- 从以下版本开始:
- 1.1
-
getDeclaredField
public 字段 getDeclaredField(String name) throws NoSuchFieldException, SecurityException
返回字段
对象,该对象反映此类
对象表示的类或接口的指定声明字段。name
参数是String
,它指定所需字段的简单名称。如果此
类
对象表示数组类型,则此方法找不到数组类型的length
字段。- 参数
-
name
- 字段的名称 - 结果
-
字段
中指定字段的字段
对象 - 异常
-
NoSuchFieldException
- 如果找不到具有指定名称的字段。 -
NullPointerException
- 如果name
是null
-
SecurityException
- 如果存在安全管理器s且满足以下任一条件:- 调用者的类加载器与此类的类加载器不同,并且调用
s.checkPermission
方法,RuntimePermission("accessDeclaredMembers")
拒绝访问声明的字段 - 调用者的类加载器与当前类的类加载器的不同或者是祖先,并且
s.checkPackageAccess()
的调用拒绝访问此类的包
- 调用者的类加载器与此类的类加载器不同,并且调用
- 从以下版本开始:
- 1.1
- See The Java™ Language Specification:
- 8.2集体成员,8.3现场声明
-
getDeclaredMethod
public 方法 getDeclaredMethod(String name, 类<?>... parameterTypes) throws NoSuchMethodException, SecurityException
返回方法
对象,该对象反映此类
对象所表示的类或接口的指定声明方法。name
参数是String
,它指定所需方法的简单名称,parameterTypes
参数是类
对象的数组,类
对象按声明的顺序标识方法的形式参数类型。 如果在类中声明了多个具有相同参数类型的方法,并且其中一个方法的返回类型比任何其他方法更具体,则返回该方法; 否则任意选择其中一种方法。 如果名称为“<init>”或“<clinit>”,则引发NoSuchMethodException
。如果此
类
对象表示数组类型,则此方法找不到clone()
方法。- 参数
-
name
- 方法的名称 -
parameterTypes
- 参数数组 - 结果
-
方法
对象为此类的方法匹配指定的名称和参数 - 异常
-
NoSuchMethodException
- 如果找不到匹配的方法。 -
NullPointerException
- 如果name
是null
-
SecurityException
- 如果存在安全管理器s且满足以下任一条件:- 调用者的类加载器与此类的类加载器不同,并且
s.checkPermission
方法的调用RuntimePermission("accessDeclaredMembers")
拒绝访问声明的方法 - 调用者的类加载器与当前类的类加载器不同或是祖先,并且
s.checkPackageAccess()
的调用拒绝访问此类的包
- 调用者的类加载器与此类的类加载器不同,并且
- 从以下版本开始:
- 1.1
- See The Java™ Language Specification:
- 8.2类成员,8.4方法声明
-
getDeclaredConstructor
public 构造器<T> getDeclaredConstructor(类<?>... parameterTypes) throws NoSuchMethodException, SecurityException
返回一个构造器
对象,该对象反映此类
对象所表示的类或接口的指定构造函数。parameterTypes
参数是一个类
对象的数组,它按声明的顺序标识构造函数的形式参数类型。 如果此类
对象表示在非静态上下文中声明的内部类,则形式参数类型包括显式封闭实例作为第一个参数。- 参数
-
parameterTypes
- 参数数组 - 结果
-
具有指定参数列表的构造函数的
构造器
对象 - 异常
-
NoSuchMethodException
- 如果找不到匹配的方法。 -
SecurityException
- 如果存在安全管理器s且满足以下任一条件:- 调用者的类加载器与此类的类加载器不同,并且调用
s.checkPermission
方法和RuntimePermission("accessDeclaredMembers")
拒绝访问声明的构造函数 - 调用者的类加载器与当前类的类加载器不同或是祖先,并且
s.checkPackageAccess()
的调用拒绝访问此类的包
- 调用者的类加载器与此类的类加载器不同,并且调用
- 从以下版本开始:
- 1.1
-
getResourceAsStream
public InputStream getResourceAsStream(String name)
查找具有给定名称的资源。如果此类位于命名的
模块
中,则此方法将尝试在模块中查找资源。 这是通过委托模块的类加载器findResource(String,String)
方法完成的,使用模块名称和资源的绝对名称调用它。 命名模块中的资源受模块
getResourceAsStream
方法中指定的封装规则的模块
,因此当资源是未对调用方模块打开的包中的非“.class
”资源时,此方法返回null
。否则,如果此类不在命名模块中,则用于搜索与给定类关联的资源的规则由类的定义class loader实现。 此方法委托给该对象的类加载器。 如果此对象由引导类加载器加载,则该方法委托给
ClassLoader.getSystemResourceAsStream(java.lang.String)
。在委派之前,使用此算法从给定资源名称构造绝对资源名称:
- 如果
name
以'/'
('\u002f'
)开头,那么资源的绝对名称是name
之后的'/'
。 - 否则,绝对名称具有以下形式:
modified_package_name/name
其中
modified_package_name
是此对象的包名称,'/'
替换为'.'
('\u002e'
)。
- 参数
-
name
- 所需资源的名称 - 结果
-
A
InputStream
对象;null
如果未找到具有此名称的资源,则资源位于至少为调用方模块的open的程序包中,或者安全管理器拒绝对该资源的访问。 - 异常
-
NullPointerException
- 如果name
是null
- 从以下版本开始:
- 1.1
- 另请参见:
-
Module.getResourceAsStream(String)
- 如果
-
getResource
public URL getResource(String name)
查找具有给定名称的资源。如果此类位于命名的
模块
中,则此方法将尝试在模块中查找资源。 这是通过委托模块的类加载器findResource(String,String)
方法完成的,使用模块名称和资源的绝对名称调用它。 命名模块中的资源受模块
getResourceAsStream
方法中指定的封装规则的模块
,因此当资源是未对调用方模块打开的包中的非“.class
”资源时,此方法返回null
。否则,如果此类不在命名模块中,则用于搜索与给定类关联的资源的规则由类的定义class loader实现。 此方法委托给该对象的类加载器。 如果此对象由引导类加载器加载,则该方法委托给
ClassLoader.getSystemResource(java.lang.String)
。在委派之前,使用此算法从给定资源名称构造绝对资源名称:
- 如果
name
以'/'
('\u002f'
)开头,那么资源的绝对名称是name
之后的'/'
。 - 否则,绝对名称具有以下形式:
modified_package_name/name
其中
modified_package_name
是此对象的包名称,'/'
替换为'.'
('\u002e'
)。
- 参数
-
name
- 所需资源的名称 - 结果
-
A
URL
对象;null
如果找不到具有此名称的资源,则无法通过URL找到该资源,该资源位于至少为调用方模块的open的包中,或者安全管理器拒绝对该资源的访问。 - 异常
-
NullPointerException
- 如果name
是null
- 从以下版本开始:
- 1.1
- 如果
-
getProtectionDomain
public ProtectionDomain getProtectionDomain()
返回ProtectionDomain
。 如果安装了安全管理器,则此方法首先使用RuntimePermission("getProtectionDomain")
权限调用安全管理器的checkPermission
方法,以确保可以获取ProtectionDomain
。- 结果
- 此类的ProtectionDomain
- 异常
-
SecurityException
- 如果存在安全管理器且其checkPermission
方法不允许获取ProtectionDomain。 - 从以下版本开始:
- 1.2
- 另请参见:
-
ProtectionDomain
,SecurityManager.checkPermission(java.security.Permission)
,RuntimePermission
-
desiredAssertionStatus
public boolean desiredAssertionStatus()
如果要在调用此方法时初始化,则返回将分配给此类的断言状态。 如果此类已设置其断言状态,则将返回最新的设置; 否则,如果任何包默认断言状态属于此类,则返回最具体的相关包默认断言状态的最新设置; 否则,如果此类不是系统类(即,它具有类加载器),则返回其类加载器的默认断言状态; 否则,返回系统类的默认断言状态。很少有程序员需要这种方法; 它是为了JRE本身的利益而提供的。 (它允许类在初始化时确定是否应该启用断言。)请注意,此方法不保证返回与指定类关联的(或将要)关联的实际断言状态(或将被初始化。
-
isEnum
public boolean isEnum()
当且仅当此类在源代码中声明为枚举时返回true。- 结果
- 当且仅当此类在源代码中声明为枚举时才返回true
- 从以下版本开始:
- 1.5
-
getEnumConstants
public T[] getEnumConstants()
返回此枚举类的元素,如果此Class对象不表示枚举类型,则返回null。- 结果
- 包含由此Class对象按其声明的顺序表示的枚举类的值的数组,如果此Class对象不表示枚举类型,则返回null
- 从以下版本开始:
- 1.5
-
cast
public T cast(Object obj)
将对象类
为此类
对象表示的类或接口。- 参数
-
obj
- 要转换的对象 - 结果
- 转换后的对象,如果obj为null,则返回null
- 异常
-
ClassCastException
- 如果对象不为null且不能分配给类型T. - 从以下版本开始:
- 1.5
-
asSubclass
public <U> 类<? extends U> asSubclass(类<U> clazz)
转换此类
对象以表示由指定的类对象表示的类的子类。 检查ClassCastException
是否有效,如果不是,则抛出ClassCastException
。 如果此方法成功,则它始终返回对此类对象的引用。当客户端需要“缩小”
类
对象的类型以将其传递给限制其愿意接受的类
对象的API时,此方法很有用。 强制转换将生成编译时警告,因为无法在运行时检查强制转换的正确性(因为泛型类型是通过擦除实现的)。- 参数类型
-
U
- 要将此类对象U
为的类型 - 参数
-
clazz
- 要将此类对象clazz
为的类的类 - 结果
-
这个
类
对象,类
为表示指定类对象的子类。 - 异常
-
ClassCastException
- 如果此类
对象不表示指定类的子类(此处“子类”包括类本身)。 - 从以下版本开始:
- 1.5
-
getAnnotation
public <A extends Annotation> A getAnnotation(类<A> annotationClass)
从界面复制的说明:AnnotatedElement
返回该元素的,如果这样的注释 ,否则返回null指定类型的注释。- Specified by:
-
getAnnotation
在接口AnnotatedElement
- 参数类型
-
A
- 要查询的注释的类型,如果存在则返回 - 参数
-
annotationClass
- 与注释类型对应的Class对象 - 结果
- 如果此元素上存在指定注释类型,则此元素的注释,否则为null
- 异常
-
NullPointerException
- 如果给定的注释类为null - 从以下版本开始:
- 1.5
-
isAnnotationPresent
public boolean isAnnotationPresent(类<? extends Annotation> annotationClass)
如果此元素上存在指定类型的注释,则返回true,否则返回false。 此方法主要用于方便地访问标记注释。此方法返回的真值等价于:
getAnnotation(annotationClass) != null
默认方法的主体被指定为上面的代码。
- Specified by:
-
isAnnotationPresent
在接口AnnotatedElement
- 参数
-
annotationClass
- 与注释类型对应的Class对象 - 结果
- 如果此元素上存在指定注释类型的注释,则返回true,否则返回false
- 异常
-
NullPointerException
- 如果给定的注释类为null - 从以下版本开始:
- 1.5
-
getAnnotationsByType
public <A extends Annotation> A[] getAnnotationsByType(类<A> annotationClass)
从界面复制的说明:AnnotatedElement
返回与此元素关联的注释。 如果没有与此元素关联的注释,则返回值是长度为0的数组。此方法与AnnotatedElement.getAnnotation(Class)
之间的区别在于此方法检测其参数是否为可重复注释类型 (JLS 9.6),如果是,则尝试通过“查看”容器注释来查找该类型的一个或多个注释。 此方法的调用者可以自由修改返回的数组; 它对返回给其他调用者的数组没有影响。- Specified by:
-
getAnnotationsByType
在接口AnnotatedElement
- 参数类型
-
A
- 要查询的注释的类型,如果存在则返回 - 参数
-
annotationClass
- 与注释类型对应的Class对象 - 结果
- 如果与此元素关联,则指定注释类型的所有此元素的注释,否则为长度为零的数组
- 异常
-
NullPointerException
- 如果给定的注释类为null - 从以下版本开始:
- 1.8
-
getAnnotations
public Annotation[] getAnnotations()
从界面复制的说明:AnnotatedElement
返回此元素上存在的注释。 如果没有存在于此元素上注解,返回值是长度为0这种方法的调用者可以随意修改返回的数组的数组; 它对返回给其他调用者的数组没有影响。- Specified by:
-
getAnnotations
,界面AnnotatedElement
- 结果
- 此元素上的注释
- 从以下版本开始:
- 1.5
-
getDeclaredAnnotation
public <A extends Annotation> A getDeclaredAnnotation(类<A> annotationClass)
从界面复制的说明:AnnotatedElement
如果直接存在这样的注释,则返回指定类型的此元素的注释,否则返回null。 此方法忽略继承的注释。 (如果此元素上没有直接出现注释,则返回null。)- Specified by:
-
getDeclaredAnnotation
在界面AnnotatedElement
- 参数类型
-
A
- 要查询的注释的类型,如果直接存在则返回 - 参数
-
annotationClass
- 与注释类型对应的Class对象 - 结果
- 如果直接出现在此元素上,则此元素的指定注释类型的注释,否则为null
- 异常
-
NullPointerException
- 如果给定的注释类为null - 从以下版本开始:
- 1.8
-
getDeclaredAnnotationsByType
public <A extends Annotation> A[] getDeclaredAnnotationsByType(类<A> annotationClass)
从界面复制的说明:AnnotatedElement
如果此类注释直接存在或间接存在 ,则返回指定类型的此元素的注释。 此方法忽略继承的注释。 如果此元素上没有直接或间接存在的指定注释,则返回值为长度为0的数组。此方法与AnnotatedElement.getDeclaredAnnotation(Class)
之间的区别在于此方法检测其参数是否为可重复注释类型 (JLS 9.6),并且如果是,则尝试通过“查看”容器注释(例如,如果存在)来查找该类型的一个或多个注释。 此方法的调用者可以自由修改返回的数组; 它对返回给其他调用者的数组没有影响。- Specified by:
-
getDeclaredAnnotationsByType
在界面AnnotatedElement
- 参数类型
-
A
- 要查询的注释的类型,如果直接或间接存在则返回 - 参数
-
annotationClass
- 与注释类型对应的Class对象 - 结果
- 如果直接或间接出现在此元素上,则指定注释类型的所有此元素的注释,否则为长度为零的数组
- 异常
-
NullPointerException
- 如果给定的注释类为null - 从以下版本开始:
- 1.8
-
getDeclaredAnnotations
public Annotation[] getDeclaredAnnotations()
从界面复制的说明:AnnotatedElement
返回直接出现在此元素上的注释。 此方法忽略继承的注释。 如果此元素上没有直接存在注释,则返回值为长度为0的数组。此方法的调用者可以自由修改返回的数组; 它对返回给其他调用者的数组没有影响。- Specified by:
-
getDeclaredAnnotations
在接口AnnotatedElement
- 结果
- 注释直接出现在此元素上
- 从以下版本开始:
- 1.5
-
getAnnotatedSuperclass
public AnnotatedType getAnnotatedSuperclass()
返回一个AnnotatedType
对象,该对象表示使用类型来指定此类
对象所表示的实体的超类。 ( 使用类型Foo来指定'... extends Foo'中的超类与Foo类型的声明不同。)如果此
类
对象表示其声明未明确指示带注释的超类的类型,则返回值是表示没有注释的元素的AnnotatedType
对象。如果此
类
表示Object
类,接口类型,数组类型,基元类型或void,则返回值为null
。- 结果
- 表示超类的对象
- 从以下版本开始:
- 1.8
-
getAnnotatedInterfaces
public AnnotatedType[] getAnnotatedInterfaces()
返回AnnotatedType
对象的数组,AnnotatedType
对象表示使用类型来指定此类
对象所表示的实体的超类
。 ( 使用类型Foo在'... implements Foo'中指定超接口与Foo类型的声明不同。)如果此
类
对象表示类,则返回值是一个数组,其中包含表示接口类型用于指定类实现的接口的对象。 数组中对象的顺序对应于此类
对象的声明的“implements”子句中使用的接口类型的顺序。如果此
类
对象表示接口,则返回值是一个数组,其中包含表示接口类型用途的对象,以指定由接口直接扩展的接口。 数组中对象的顺序对应于此类
对象的声明的“extends”子句中使用的接口类型的顺序。如果此
类
对象表示其声明未明确指示任何带注释的超接口的类或接口,则返回值为长度为0的数组。如果此
类
对象表示Object
类,数组类型,基本类型或void,则返回值是长度为0的数组。- 结果
- 表示超接口的数组
- 从以下版本开始:
- 1.8
-
getNestHost
public 类<?> getNestHost()
返回此类
对象所代表的类或接口所属的nest的嵌套主机。 每个类和接口都是一个嵌套的成员。 未记录为属于嵌套的类或接口属于仅由其自身组成的嵌套,并且是嵌套主机。表示数组类型,基元类型和
void
的类
对象中的每一个返回this
以指示所表示的实体属于仅this
自身组成的嵌套,并且是嵌套主机。如果存在访问嵌套主机的linkage error ,或者嵌套主机未将此类或接口枚举为嵌套成员,则认为它属于自己的嵌套,并且
this
作为主机返回。- API Note:
-
版本55.0或更高版本的
class
可以使用NestHost
属性(JVMS 4.7.28)记录它所属的嵌套的主机。 或者,版本55.0或更高版本的class
文件可以通过使用NestMembers
属性(JVMS 4.7.29)枚举嵌套的其他成员来充当嵌套主机。 版本54.0或更低版本的class
文件不使用这些属性。 - 结果
- 此类或接口的嵌套主机
- 异常
-
SecurityException
- 如果返回的类不是当前类,并且存在安全管理器 s ,并且调用者的类加载器与返回类的类加载器不同或是祖先,并且调用s.checkPackageAccess()
拒绝访问返回类的包 - 从以下版本开始:
- 11
- See The Java™ Virtual Machine Specification:
- 4.7.28和4.7.29 NestHost和NestMembers属性,5.4.4访问控制
-
isNestmateOf
public boolean isNestmateOf(类<?> c)
确定给定的类
是否是此类
对象所表示的类或接口的类
。 如果两个类或接口具有相同的nest host,则它们是嵌套的 。- 参数
-
c
- 要检查的类 - 结果
-
true
如果此类和c
是同一个嵌套的成员; 和false
。 - 从以下版本开始:
- 11
-
getNestMembers
public 类<?>[] getNestMembers()
返回一个数组,其中包含类
对象,这些对象表示作为此类
对象所表示的类或接口所属的嵌套成员的所有类和接口。 该嵌套的nest host是数组的第0个元素。 后续元素表示由嵌套主机记录为嵌套成员的任何类或接口; 这些元素的顺序是未指定的。 允许重复。 如果该嵌套的嵌套主机未枚举任何成员,则该数组具有包含this
的单个元素。表示数组类型,基元类型和
void
每个类
对象void
返回仅包含this
的数组。此方法验证,对于由嵌套主机记录为嵌套成员的每个类或接口,该类或接口将自身记录为同一嵌套的成员。 此验证期间发生的任何异常都会被此方法重新抛出。
- 结果
- 与此类位于同一个嵌套中的所有类和接口的数组
- 异常
-
LinkageError
- 如果加载或验证嵌套成员或其嵌套主机有任何问题 -
SecurityException
- 如果任何返回的类不是当前类,并且存在安全管理器 s ,并且调用者的类加载器与该返回类的类加载器不同或是其祖先,并且调用s.checkPackageAccess()
拒绝访问返回类的包 - 从以下版本开始:
- 11
- 另请参见:
-
getNestHost()
-
-