KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Class.cast — gecontroleerd casten met Class<T>

Als het doeltype in een variabele van het type `Class<T>` zit, geeft `cast` een referentie van het type `T` naar hetzelfde object terug. Met `isInstance` kun je een niet-nullwaarde vooraf controleren.

Versie: Java SE 21

Syntax

public T cast(Object obj)

// Instance method of java.lang.Class<T>:
// For Class<T> type and Object value:
T result = type.cast(value);

Class.cast is een instantiemethode van java.lang.Class<T>. De aanroep type.cast(value) controleert tijdens uitvoering of de waarde compatibel is met het type dat type vertegenwoordigt. De methode geeft een referentie naar hetzelfde object terug, met statisch type T. Het object wordt niet gekopieerd of gewijzigd. Een instantie van een subklasse of een object dat de doelinterface implementeert, kan ook door de controle komen.

Als type.isInstance(value) true teruggeeft, kun je in het if-blok type.cast(value) aanroepen met dezelfde waarde. isInstance geeft alleen een booleaanse waarde terug en verandert het type van value niet. Voor null geeft isInstance false terug, maar cast geeft null terug. Een incompatibel argument dat niet null is, veroorzaakt een ClassCastException.

Als het doeltype rechtstreeks in de code staat, kun je (CharSequence) value schrijven. Gebruik type.cast(value) als het type als Class<T> wordt doorgegeven. De methode voert geen numerieke conversies uit en List.class.cast(value) controleert niet of de lijstitems String-objecten zijn.

Voorbeelden

public class Main {
    public static void main(String[] args) {
        Class<CharSequence> type = CharSequence.class;
        Object value = new StringBuilder("Java");

        if (type.isInstance(value)) {
            CharSequence text = type.cast(value);
            System.out.println("length: " + text.length());
            System.out.println("same object: " + (text == value));
        }

        System.out.println("isInstance(null): " + type.isInstance(null));
        System.out.println("cast(null): " + type.cast(null));

        try {
            type.cast(Integer.valueOf(7));
        } catch (ClassCastException e) {
            System.out.println("incompatible: ClassCastException");
        }
    }
}

Resultaat

length: 4
same object: true
isInstance(null): false
cast(null): null
incompatible: ClassCastException

`StringBuilder` implementeert `CharSequence`, dus na de controle kun je via `text` de methode `length()` aanroepen. De vergelijking met `==` bevestigt dat beide referenties naar hetzelfde object wijzen. De overige regels tonen het verschil bij `null` en de uitzondering voor een incompatibel `Integer`-object.

Gerelateerde lessen

  • Java · Les 36 · Gemiddeld · Versie: 2
  • Java · Les 37 · Gemiddeld · Versie: 2

Bronnen