java.lang.Object
   |
   +--java.lang.Class

Deklaration

Beschreibung

Methoden
public boolean	desiredAssertionStatus()
public static Class	forName(String className)
public static Class	forName(String className, boolean initialize, ClassLoader loader)
public ClassLoader	getClassLoader()
public Class[]	getClasses()
public native Class	getComponentType()
public Constructor	getConstructor(Class[] parameterTypes)
public Constructor[]	getConstructors()
public Class[]	getDeclaredClasses()
public Constructor	getDeclaredConstructor(Class[] parameterTypes)
public Constructor[]	getDeclaredConstructors()
public Field	getDeclaredField(String name)
public Field[]	getDeclaredFields()
public Method	getDeclaredMethod(String name, Class[] parameterTypes)
public Method[]	getDeclaredMethods()
public native Class	getDeclaringClass()
public Field	getField(String name)
public Field[]	getFields()
public native Class[]	getInterfaces()
public Method	getMethod(String name, Class[] parameterTypes)
public Method[]	getMethods()
public native int	getModifiers()
public native String	getName()
public Package	getPackage()
public ProtectionDomain	getProtectionDomain()
public URL	getResource(String name)
public InputStream	getResourceAsStream(String name)
public native Object[]	getSigners()
public native Class	getSuperclass()
public native boolean	isArray()
public native boolean	isAssignableFrom(Class cls)
public native boolean	isInstance(Object obj)
public native boolean	isInterface()
public native boolean	isPrimitive()
public native Object	newInstance()
public String	toString()

Methoden im Detail

public boolean desiredAssertionStatus()     

Liefert true, falls Zusicherungen in der Klasse aktiviert sind, sobald diese initialisiert wird. Ansonsten ist der Rückgabewert false.

public static Class forName(String className)

Liefert einen Klassendeskriptor für die durch className bezeichnete Klasse. Falls diese Klasse bisher noch nicht geladen ist, wird versucht sie zu laden.

Exception: ClassNotFoundException

• Falls die Klasse nicht gefunden werden konnte.

public static Class forName(String className, boolean initialize, ClassLoader loader)     

Liefert einen Klassendeskriptor für die durch className bezeichnete Klasse. Falls diese Klasse bisher noch nicht geladen ist, wird versucht, sie mit dem ClassLoader loader zu laden. initialize legt fest, ob die Klasse initialisiert wird, falls sie noch nicht geladen war.

Exception: ClassNotFoundException

• Falls die Klasse nicht gefunden werden konnte.

public ClassLoader getClassLoader()

Liefert das ClassLoader-Objekt zurück, von dem die Klasse, die dieses Class-Objekt repräsentiert, geladen wurde. Der Rückgabewert ist null, falls die repräsentierte Klasse nicht durch einen ClassLoader geladen wurde.

public Class[] getClasses()     

Diese Methode ist noch nicht implementiert und liefert null zurück.

public native Class getComponentType()     

Falls dieses Exemplar einen Array-Typ repräsentiert, wird ein Class-Objekt zurückgegeben, das den Elementtyp repräsentiert, ansonsten wird null geliefert.

public Constructor getConstructor(Class[] parameterTypes)

Sucht in der Klasse nach einem public-Konstruktor, der die in parameterTypes vorgegebene Parameterstruktur hat, wobei auch die geerbten public-Konstruktoren berücksichtigt werden. Rückgabewert ist ein Constructor-Objekt, falls ein passender Konstruktor gefunden wurde. Falls ein SecurityManager gesetzt ist, wird zuvor geprüft, ob der Zugriff auf public-Bestandteile zulässig ist.

Exception: NoSuchMethodException

• Falls die Klasse keinen Konstruktor mit der übergebenen Parameterstruktur hat.

Exception: SecurityException

• Falls der SecurityManager den Zugriff auf public-Bestandteile verweigert.

public Constructor[] getConstructors()     

Liefert ein Array von Constructor-Objekten, die die als public deklarierten Konstruktoren repräsentieren. Wenn die Klasse keine public-Konstuktoren hat, wird ein Array der Länge null zurückgegeben. Falls ein SecurityManager gesetzt ist, wird zuvor geprüft, ob der Zugriff auf public-Bestandteile zulässig ist.

Exception: SecurityException

• Falls der SecurityManager den Zugriff auf public-Bestandteile verweigert.

public Class[] getDeclaredClasses()     

Liefert ein Array von Class-Objekten, die alle Klassen repräsentieren, die diese Klasse verwendet. Dazu zählen alle Klassen, auf die Verweise vereinbart werden sowie die implementierten Interfaces. Die von den Oberklassen verwendeten Klassen werden von dieser Methode nicht berücksichtigt. Falls die repräsentierte Klasse keine Interfaces implementiert und keine anderen Klassen verwendet, wird ein Array der Länge null geliefert.

Exception: SecurityException

• Falls der SecurityManager den Zugriff auf Bestandteile verweigert.

public Constructor getDeclaredConstructor(Class[] parameterTypes)     

Sucht in der Klasse unter allen Konstruktoren (auch den als private vereinbarten) nach einem Konstruktor, der in parameterTypes vorgegebene Parameterstruktur hat. Konstruktoren der Oberklassen werden hierbei nicht berücksichtigt. Rückgabewert ist ein Constructor-Objekt, falls ein passender Konstruktor gefunden wurde.

Exception: NoSuchMethodException

• Falls die Klasse keinen Konstruktor mit der übergebenen Parameterstruktur hat.

Exception: SecurityException

• Falls der SecurityManager den Zugriff auf Bestandteile verweigert.

public Constructor[] getDeclaredConstructors()     

Liefert ein Array von Constructor-Objekten, die die Konstruktoren der Klasse repräsentieren. Falls dieses Objekt ein Interface oder einen einfachen Datentyp repräsentiert, ist die Länge des Arrays null. Falls ein SecurityManager gesetzt ist, wird zuvor geprüft, ob der Zugriff auf die Bestandteile der Klasse zulässig ist.

Exception: SecurityException

• Falls der SecurityManager den Zugriff auf Bestandteile verweigert.

public Field getDeclaredField(String name)     

Sucht in der Klasse nach einem Datenelement mit dem Namen name, wobei sich die Suche auf alle Datenelemente erstreckt (auch die als private vereinbarten). Datenelemente der Oberklassen werden hierbei nicht berücksichtigt. Rückgabewert ist ein Field-Objekt, falls das Datenelement gefunden wurde.

Exception: NoSuchFieldException

• Falls die Klasse keinen Datenelement mit dem übergebenen Namen hat.

Exception: SecurityException

• Falls der SecurityManager den Zugriff auf Bestandteile verweigert.

public Field[] getDeclaredFields()

Liefert ein Array von Field-Objekten, die die Datenelemente der Klasse repräsentieren. Falls die Klasse keine Datenelemente hat oder wenn dieses Objekt ein Interface oder einen einfachen Datentyp repräsentiert, ist die Länge des Arrays null. Falls ein SecurityManager gesetzt ist, wird zuvor geprüft, ob der Zugriff auf die Bestandteile der Klasse zulässig ist.

Exception: SecurityException

• Falls der SecurityManager den Zugriff auf Bestandteile verweigert.

public Method getDeclaredMethod(String name, Class[] parameterTypes)     

Sucht in der Klasse nach einer Methode mit dem Namen name und der in parameterTypes vorgegebene Parameterstruktur, wobei sich die Suche auf alle Methoden erstreckt (auch die als private vereinbarten). Methoden der Oberklassen werden hierbei nicht berücksichtigt. Falls eine passende Methode gefunden wurde, wird ein Method-Objekt zurückgegeben, das die Methode repräsentiert.

Exception: NoSuchMethodException

• Falls die Klasse keine Methode mit dem Namen oder der Parameterstruktur hat.

Exception: SecurityException

• Falls der SecurityManager den Zugriff auf Bestandteile verweigert.

public Method[] getDeclaredMethods()     

Liefert ein Array von Method-Objekten, die die Methoden der Klasse repräsentieren. Falls die Klasse keine Methoden hat oder wenn dieses Objekt ein Interface oder einen einfachen Datentyp repräsentiert, ist die Länge des Arrays null. Falls ein SecurityManager gesetzt ist, wird zuvor geprüft, ob der Zugriff auf die Bestandteile der Klasse zulässig ist.

Exception: SecurityException

• Falls der SecurityManager den Zugriff auf Bestandteile verweigert.

public native Class getDeclaringClass()     

Falls dieses Objekt eine geschachtelte Klasse repräsentiert, liefert diese Methode die umschließende Klasse, sonst null.

public Field getField(String name)     

Sucht in der Klasse nach einem public-Datenelement mit dem Namen name, wobei auch die geerbten public-Datenelemente berücksichtigt werden, und liefert ein Field-Objekt, falls das Datenelement gefunden wurde. Falls ein SecurityManager gesetzt ist, wird zuvor geprüft, ob der Zugriff auf public-Bestandteile zulässig ist.

Exception: NoSuchFieldException

• Falls die Klasse keinen Datenelement mit dem übergebenen Namen hat.

Exception: SecurityException

• Falls der SecurityManager den Zugriff auf public-Bestandteile verweigert.

public Field[] getFields()     

Liefert ein Array von Field-Objekten, die die als public deklarierten Datenelemente repräsentieren. Falls ein SecurityManager gesetzt ist, wird zuvor geprüft, ob der Zugriff auf public-Bestandteile zulässig ist.

Exception: SecurityException

• Falls der SecurityManager den Zugriff auf public-Bestandteile verweigert.

public native Class[] getInterfaces()

Liefert ein Array von Class-Objekten, die die von dieser Klasse implementierten Interfaces repräsentieren. Falls die Klasse keine Interfaces implementiert, wird ein Array der Länge null zurückgegeben.

public Method getMethod(String name, Class[] parameterTypes)     

Sucht in der Klasse nach einer public-Methode mit dem Namen name und der in parameterTypes vorgegebene Parameterstruktur, wobei auch die geerbten public-Methoden berücksichtigt werden. Falls eine passende Methode gefunden wurde, wird ein Method-Objekt zurückgegeben, das die Methode repräsentiert. Falls ein SecurityManager gesetzt ist, wird zuvor geprüft, ob der Zugriff auf public-Bestandteile zulässig ist.

Exception: NoSuchMethodException

• Falls die Klasse keine Methode mit dem Namen oder der Parameterstruktur hat.

Exception: SecurityException

• Falls der SecurityManager den Zugriff auf public-Bestandteile verweigert.

public Method[] getMethods()

Liefert ein Array von Method-Objekten, die die Methoden der Klasse repräsentieren. Falls ein SecurityManager gesetzt ist, wird zuvor geprüft, ob der Zugriff auf public-Bestandteile zulässig ist.

Exception: SecurityException

• Falls der SecurityManager den Zugriff auf public-Bestandteile verweigert.

public native int getModifiers()     

Liefert die Modifier zurück, mit denen die repräsentierte Klasse versehen ist. Der Rückgabewert kann durch bitweise Und-Verknüpfung mit den in java.lang.reflect.Modifier definierten Konstanten interpretiert oder auch mit den dort definierten Methoden untersucht werden.

public native String getName()

Liefert den Namen der durch dieses Objekt repräsentierten Klasse mit dem volllen Namen des Pakets. Falls dieses Objekt einen Array-Typ repräsentiert, beginnt der String mit eckigen Klammern ([), deren Anzahl der Schachtelungstiefe des Arrays entspricht. Den Klammern folgt der Elementtyp, wobei dieselbe Notation verwendet wird wie bei dem Native API:

Tabelle 29.1:

Suffix	Typ
B	byte
C	char
D	double
F	float
I	int
J	long
L<Klasse>;	Klasse oder Interface
S	short
Z	boolean

public Package getPackage()     

Liefert ein Package-Objekt für das Paket, in dem die repräsentierte Klasse enthalten ist. Der Rückgabewert ist null, wenn die Klasse keinem Paket zugeordnet ist.

public ProtectionDomain getProtectionDomain()     

Liefert die Schutzdomäne der repräsentierten Klasse zurück, falls sie eine hat. Ansonsten ist der Rückgabewert null.

Exception: SecurityException

• Falls keine Berechtigung zum Abrufen der Schutzdomäne besteht.

public URL getResource(String name)     

Liefert ein Exemplar von URL, mit dem die durch name bezeichnete Ressource ausgelesen werden kann.

public InputStream getResourceAsStream(String name)     

Liefert einen InputStream, mit dem die durch name bezeichnete Ressource ausgelesen werden kann. Falls die Ressource nicht gefunden werden konnte, wird null zurückgegeben.

public native Object[] getSigners()     

Liefert die Signierer der Klasse.

public native Class getSuperclass()

Liefert ein Class-Objekt für die Oberklasse der repräsentierten Klasse. Falls dieses Exemplar die Klasse Object oder ein Interface repräsentiert, wird null zurückgegeben.

public native boolean isArray()     

Liefert true, wenn dieses Exemplar ein Array repräsentiert, sonst false.

public native boolean isAssignableFrom(Class cls)     

Liefert true, falls ein Exemplar der von cls repräsentierten Klasse an einen Verweis auf die Klasse, die dieses Objekt repräsentiert, zugewiesen werden kann, sonst false. Falls das aufgerufene Objekt einen einfachen Datentyp repräsentiert, wird nur dann true geliefert, wenn ein Verweis auf dieses Objekt übergeben wird.

Exception: NullPointerException

• Falls null übergeben wird.

public native boolean isInstance(Object obj)     

Liefert true, wenn obj zuweisungskompatibel zu einem Verweis auf die repräsentierte Klasse ist. Falls nicht oder wenn null übergeben wird, ist der Rückgabewert false. Diese Methode entspricht dem instanceof-Operator.

public native boolean isInterface()

Liefert true, wenn dieses Exemplar ein Interface repräsentiert, sonst false.

public native boolean isPrimitive()     

Liefert true, wenn dieses Exemplar einen einfachen Datentyp repräsentiert, sonst false.

public native Object newInstance()

Liefert ein neues Exemplar der repräsentierten Klasse zurück. Dieser Aufruf ist äquivalent zur Anwendung des new-Operators, wobei der Konstruktor ohne Parameter verwendet wird.

Exception: InstantiationException

• Wenn dieses Objekt ein Interface oder eine abstrakte Klasse repräsentiert.

Exception: IllegalAccessException

• Falls keine Zugriffsberechtigung für den parameterlosen Konstruktor besteht.

public String toString()

Liefert den Namen der repräsentierten Klasse zurück. Für ein Interface wird "interface", für eine Klasse "class" vorangestellt.