Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Literał klasy w Javie: `NazwaTypu.class`

Literał `.class` udostępnia obiekt reprezentujący wskazany typ. Można go użyć do filtrowania, określenia typu kluczy `EnumMap`, wyboru monitora lub utworzenia aktualizatora pola.

Wersja: Java SE 21

Składnia

TypeName { [] } . class
NumericType { [] } . class
boolean { [] } . class
void . class

Braces denote zero or more repetitions; they are not Java tokens in the expression.
Examples: String.class, Runnable.class, String[].class, int[].class, int.class, void.class

W Java SE 21 wyrażenie NazwaTypu.class daje obiekt Class reprezentujący wskazany typ. Nie tworzy instancji tego typu ani samo nie wywołuje jego inicjalizacji. Dla dostępnego typu referencyjnego C literał C.class ma typ Class<C>; dotyczy to też interfejsów i tablic. int.class i Integer.class mają typ Class<Integer>, ale reprezentują odpowiednio typ prymitywny i klasę opakowującą. void.class ma typ Class<Void>. W zapisie T.class litera T zastępuje nazwę typu; nie może oznaczać zmiennej typu. List<String>.class jest niedozwolone; List.class nie zachowuje typu elementów.

Literał wybiera typ zapisany w kodzie, a obj.getClass() zwraca rzeczywistą klasę obiektu i zgłasza NullPointerException dla null. Type.class ma typ Class<Type> i reprezentuje zadeklarowany enum Type, nie jego stałą. Stała z własnym ciałem klasy ma inną klasę wykonawczą, ale getDeclaringClass() nadal zwraca Type.class. new EnumMap<>(Type.class) wybiera konstruktor tworzący pustą mapę z kluczami typu Type; dla enuma Status przekaż Status.class.

W metodzie <T> List<T> select(List<?> values, Class<T> type) przekazany token wiąże sprawdzanie w czasie wykonania z typem elementów wyniku. String.class, Integer.class, StringBuilder.class, TextNote.class i Metric.class wskazują odpowiednio typy String, Integer, StringBuilder, TextNote i Metric. isInstance akceptuje zgodne niepuste referencje, także do obiektów podklas lub implementacji interfejsu. Następujące po nim cast zwraca tę samą referencję jako T; bez sprawdzenia niezgodna wartość inna niż null powoduje ClassCastException. StringBuilder nie staje się String podczas filtrowania.

synchronized (Main.class) zajmuje monitor obiektu Class<Main>, ten sam, którego używa metoda static synchronized zadeklarowana w Main. To nie monitor this ani osobno utworzonego lock. Klasy o tej samej nazwie zdefiniowane przez różne loadery mogą mieć różne monitory. Użyj prywatnego obiektu blokady, jeśli kod zewnętrzny nie powinien móc zająć tego samego monitora.

W AtomicIntegerFieldUpdater.newUpdater(Metric.class, "count") literał określa klasę deklarującą pole i typ obiektów obsługiwanych przez AtomicIntegerFieldUpdater<Metric>. Nazwa "count" wybiera dostępne pole instancji typu volatile int. Brak pola, brak dostępu lub nieprawidłowa deklaracja powodują błąd przy tworzeniu aktualizatora. Zwiększenie wartości wymaga konkretnej instancji Metric, a nie tokenu klasy.

Przykłady

import java.util.EnumMap;
import java.util.List;
import java.util.concurrent.atomic.AtomicIntegerFieldUpdater;

public class Main {
    enum Type { READY {} }
    record TextNote(String text) {}
    static final class Metric {
        volatile int count;
    }

    static <T> List<T> select(List<?> values, Class<T> type) {
        return values.stream().filter(type::isInstance).map(type::cast).toList();
    }

    void demo() {
        Metric metric = new Metric();
        List<?> values = List.of(new TextNote("ready"), metric, 7,
                                 new StringBuilder("not a String"));
        List<TextNote> notes = select(values, TextNote.class);
        List<Metric> metrics = select(values, Metric.class);
        List<Integer> integers = select(values, Integer.class);
        List<String> strings = select(values, String.class);
        System.out.println("note=" + notes.get(0).text());
        System.out.println("metric matches=" + metrics.size());
        System.out.println("integers=" + integers);
        System.out.println("strings=" + strings);

        EnumMap<Type, Integer> counts = new EnumMap<>(Type.class);
        AtomicIntegerFieldUpdater<Metric> updater =
                AtomicIntegerFieldUpdater.newUpdater(Metric.class, "count");
        counts.put(Type.READY, updater.incrementAndGet(metric));
        System.out.println("updated=" + counts.get(Type.READY));
        System.out.println("declaring enum=" + (Type.READY.getDeclaringClass() == Type.class));
        System.out.println("same runtime class=" + Type.class.equals(Type.READY.getClass()));

        Object lock = new Object();
        synchronized (Main.class) {
            System.out.println("class monitor=" + Thread.holdsLock(Main.class));
            System.out.println("instance monitor=" + Thread.holdsLock(this));
            System.out.println("separate monitor=" + Thread.holdsLock(lock));
        }
    }

    public static void main(String[] args) {
        new Main().demo();
    }
}

Wynik

note=ready
metric matches=1
integers=[7]
strings=[]
updated=1
declaring enum=true
same runtime class=false
class monitor=true
instance monitor=false
separate monitor=false

Pusta lista `strings` pokazuje, że `StringBuilder` nie pasuje do `String.class`. Wątek zajmuje tylko monitor klasy spośród trzech sprawdzanych monitorów. Przykład nie testuje współbieżności.

Powiązane lekcje

  • Java · Lekcja 13 · Zaawansowany · Wersja: 2
  • Java · Lekcja 19 · Zaawansowany · Wersja: 2
  • Java · Lekcja 27 · Zaawansowany · Wersja: 2
  • Java · Lekcja 28 · Zaawansowany · Wersja: 2
  • Java · Lekcja 32 · Zaawansowany · Wersja: 2
  • Java · Lekcja 10 · Średniozaawansowany · Wersja: 2
  • Java · Lekcja 36 · Średniozaawansowany · Wersja: 2
  • Java · Lekcja 37 · Średniozaawansowany · Wersja: 2

Źródła