← 返回首页
Class (Java SE 26 & JDK 26)
JavaScript is disabled on your browser.
  1. java.base
  2. java.lang
  3. Class
Contents  
  1. Description
    1. Hidden Classes
    2. Implicitly Declared Classes
  2. Nested Class Summary
  3. Method Summary
  4. Method Details
    1. toString()
    2. toGenericString()
    3. forName(String)
    4. forName(String, boolean, ClassLoader)
    5. forName(Module, String)
    6. forPrimitiveName(String)
    7. newInstance()
    8. isInstance(Object)
    9. isAssignableFrom(Class)
    10. isInterface()
    11. isArray()
    12. isPrimitive()
    13. isAnnotation()
    14. isSynthetic()
    15. getName()
    16. getClassLoader()
    17. getModule()
    18. getTypeParameters()
    19. getSuperclass()
    20. getGenericSuperclass()
    21. getPackage()
    22. getPackageName()
    23. getInterfaces()
    24. getGenericInterfaces()
    25. getComponentType()
    26. getModifiers()
    27. accessFlags()
    28. getSigners()
    29. getEnclosingMethod()
    30. getEnclosingConstructor()
    31. getDeclaringClass()
    32. getEnclosingClass()
    33. getSimpleName()
    34. getTypeName()
    35. getCanonicalName()
    36. isAnonymousClass()
    37. isLocalClass()
    38. isMemberClass()
    39. getClasses()
    40. getFields()
    41. getMethods()
    42. getConstructors()
    43. getField(String)
    44. getMethod(String, Class...)
    45. getConstructor(Class...)
    46. getDeclaredClasses()
    47. getDeclaredFields()
    48. getRecordComponents()
    49. getDeclaredMethods()
    50. getDeclaredConstructors()
    51. getDeclaredField(String)
    52. getDeclaredMethod(String, Class...)
    53. getDeclaredConstructor(Class...)
    54. getResourceAsStream(String)
    55. getResource(String)
    56. getProtectionDomain()
    57. desiredAssertionStatus()
    58. isEnum()
    59. isRecord()
    60. getEnumConstants()
    61. cast(Object)
    62. asSubclass(Class)
    63. getAnnotation(Class)
    64. isAnnotationPresent(Class)
    65. getAnnotationsByType(Class)
    66. getAnnotations()
    67. getDeclaredAnnotation(Class)
    68. getDeclaredAnnotationsByType(Class)
    69. getDeclaredAnnotations()
    70. getAnnotatedSuperclass()
    71. getAnnotatedInterfaces()
    72. getNestHost()
    73. isNestmateOf(Class)
    74. getNestMembers()
    75. descriptorString()
    76. componentType()
    77. arrayType()
    78. describeConstable()
    79. isHidden()
    80. getPermittedSubclasses()
    81. isSealed()
Hide sidebar  Show sidebar

Class Class<T>

java.lang.Object
java.lang.Class<T>
Type Parameters: T - the type of the class modeled by this Class object. For example, the type of String.class is Class<String>. Use Class<?> if the class being modeled is unknown. All Implemented Interfaces: Serializable, Constable, TypeDescriptor, TypeDescriptor.OfField<Class<?>>, AnnotatedElement, GenericDeclaration, Type
public final class Class<T> extends Object implements Serializable, GenericDeclaration, Type, AnnotatedElement, TypeDescriptor.OfField<Class<?>>, Constable
Instances of the class Class represent classes and interfaces in a running Java application. An enum class and a record class are kinds of class; an annotation interface is a kind of interface. Every array also belongs to a class that is reflected as a Class object that is shared by all arrays with the same element type and number of dimensions. The primitive Java types (boolean, byte, char, short, int, long, float, and double), and the keyword void are also represented as Class objects.

Class has no public constructor. Instead a Class object is constructed automatically by the Java Virtual Machine when a class is derived from the bytes of a class file through the invocation of one of the following methods:

The methods of class Class expose many characteristics of a class or interface. Most characteristics are derived from the class file that the class loader passed to the Java Virtual Machine or from the class file passed to Lookup::defineClass or Lookup::defineHiddenClass. A few characteristics are determined by the class loading environment at run time, such as the module returned by getModule().

The following example uses a Class object to print the class name of an object:

Copy void printClassName(Object obj) { System.out.println("The class of " + obj + " is " + obj.getClass().getName()); }
It is also possible to get the Class object for a named class or interface (or for void) using a class literal (JLS 15.8.2). For example:
Copy System.out.println("The name of class Foo is: " + Foo.class.getName());

Some methods of class Class expose whether the declaration of a class or interface in Java source code was enclosed within another declaration. Other methods describe how a class or interface is situated in a nest. A nest is a set of classes and interfaces, in the same run-time package, that allow mutual access to their private members. The classes and interfaces are known as nestmates (JVMS 4.7.29). One nestmate acts as the nest host (JVMS 4.7.28), and enumerates the other nestmates which belong to the nest; each of them in turn records it as the nest host. The classes and interfaces which belong to a nest, including its host, are determined when class files are generated, for example, a Java compiler will typically record a top-level class as the host of a nest where the other members are the classes and interfaces whose declarations are enclosed within the top-level class declaration.

Unless otherwise specified, methods in this class throw a NullPointerException when they are called with null or an array that contains null as an argument.

Hidden Classes

A class or interface created by the invocation of Lookup::defineHiddenClass is a hidden class or interface. All kinds of class, including enum classes and record classes, may be hidden classes; all kinds of interface, including annotation interfaces, may be hidden interfaces. The name of a hidden class or interface is not a binary name, which means the following: A hidden class or interface is never an array class, but may be the element type of an array. In all other respects, the fact that a class or interface is hidden has no bearing on the characteristics exposed by the methods of class Class.

Implicitly Declared Classes

Conventionally, a Java compiler, starting from a source file for an implicitly declared class, say HelloWorld.java, creates a similarly-named class file, HelloWorld.class, where the class stored in that class file is named "HelloWorld", matching the base names of the source and class files. For the Class object of an implicitly declared class HelloWorld, the methods to get the name and type name return results equal to "HelloWorld". The simple name of such an implicitly declared class is "HelloWorld" and the canonical name is "HelloWorld".
Since: 1.0 See Also:

Report a bug or suggest an enhancement
For further API reference and developer documentation see the Java SE Documentation, which contains more detailed, developer-targeted descriptions with conceptual overviews, definitions of terms, workarounds, and working code examples. Other versions.
Java is a trademark or registered trademark of Oracle and/or its affiliates in the US and other countries.
Copyright © 1993, 2026, Oracle and/or its affiliates, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
All rights reserved. Use is subject to license terms and the documentation redistribution policy.

Scripting on this page tracks web page traffic, but does not change the content in any way.