WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Class.isInstance — den Typ eines Objekts zur Laufzeit prüfen

Mit `Class.isInstance` prüfst du ein Objekt vor der Typumwandlung, wenn der Zieltyp in einer `Class<?>`-Variablen vorliegt.

Version: Java SE 21

Syntax

public boolean isInstance(Object obj)

Class.isInstance ist eine Instanzmethode von java.lang.Class. type.isInstance(value) liefert true, wenn value nicht null ist und sich in den von type repräsentierten Referenztyp umwandeln lässt. Die Klasse muss nicht exakt übereinstimmen: Unterklassen, Implementierungen einer Schnittstelle und kompatible Arraytypen können ebenfalls passen. Zum Beispiel liefert Object[].class.isInstance(new String[0]) den Wert true.

Ein null-Argument oder ein inkompatibles Objekt ergibt false. Das gilt auch für int.class.isInstance(42): 42 wird durch Boxing zu einem Integer, und ein primitiver Typ hat keine Objektinstanzen. Ist dagegen type selbst null, löst der Aufruf eine NullPointerException aus.

Steht der Zieltyp beim Schreiben des Codes fest, stellt value instanceof String s bei einer Übereinstimmung die Variable s bereit. Wird der Typ als Class<T> übergeben, prüfe type.isInstance(value) und rufe nach true für dasselbe Objekt type.cast(value) auf, um einen Wert vom Typ T zu erhalten. Die Prüfung allein verengt den deklarierten Typ von value nicht. Ohne diese Vorprüfung wirft cast bei einem inkompatiblen Objekt eine ClassCastException, gibt bei null aber null zurück.

target.isAssignableFrom(source) vergleicht zwei Class-Objekte: Es prüft, ob der Typ source dem Typ target zugewiesen werden kann. target.isInstance(value) prüft dagegen ein konkretes Objekt. Wegen der Typlöschung kann List.class.isInstance(value) eine Liste erkennen, aber weder List<String> bestätigen noch die Elemente prüfen.

Beispiele

public class Main {
    static void printLength(Class<CharSequence> type, Object value) {
        if (!type.isInstance(value)) {
            System.out.println("rejected");
            return;
        }
        CharSequence text = type.cast(value);
        System.out.println("length=" + text.length());
    }

    public static void main(String[] args) {
        Class<CharSequence> type = CharSequence.class;
        printLength(type, "Java");
        printLength(type, new StringBuilder("API"));
        printLength(type, 21);
        printLength(type, null);
    }
}

Ergebnis

length=4
length=3
rejected
rejected

`String` und `StringBuilder` implementieren `CharSequence`, daher gibt das Programm jeweils die Länge aus. `Integer` und `null` bestehen die Prüfung nicht; für sie wird `cast` nicht aufgerufen.

Zugehörige Lektionen

  • Java · Lektion 36 · Mittlere Stufe · Version: 2
  • Java · Lektion 37 · Mittlere Stufe · Version: 2

Quellen